1. Home
  2. API & Integration
  3. API Authentication

API Authentication

Contents

Use your account’s API token to instruct Crossbar to create an authentication token to be used on subsequent requests requiring authentication.

Schema

Provides an auth-token via an Account API key

KeyDescriptionTypeDefaultRequiredSupport Level
api_keyThe Accounts API keystring(64) true 

Create

PUT /v2/api_auth

Note:

  • {AUTH_TOKEN}: this is your authentication token to include in future requests
  • {ACCOUNT_ID}: your account’s ID, useful for constructing URIs
  • {OWNER_ID}: the user’s ID of the owner of the credentials used to generate this token
  • {RESELLER_ID}: this account’s reseller account ID, if any.
  • {REQUEST_ID}: useful for debugging requests on your installation
curl -v -X PUT \
    -d '{"data": {"api_key":"{API_KEY}"} }' \
    http://{SERVER}:8000/v2/api_auth
{
    "auth_token": "{AUTH_TOKEN}",
    "data": {
        "account_id": "{ACCOUNT_ID}",
        "apps": [...],
        "is_reseller": true,
        "language": "en-US",
        "owner_id": "{OWNER_ID}",
        "reseller_id": "{RESELLER_ID}",
    },
    "request_id": "{REQUEST_ID}",
    "revision": "{REVISION}",
    "status": "success"
}
Updated on August 18, 2020

Was this article helpful?

Related Articles