cURL

# Encode your consumer key and secret as Base64
CREDENTIALS=$(echo -n "YOUR_CONSUMER_KEY:YOUR_CONSUMER_SECRET" | base64)

curl -X POST "https://api.swoogo.com/api/v1/oauth2/token" \
  -H "Authorization: Basic $CREDENTIALS" \
  -H "Content-Type: application/x-www-form-urlencoded;charset=UTF-8" \
  -d "grant_type=client_credentials"

{
  "access_token": "{{access-token}}",
  "expires_at": "2024-11-08 16:04:40",
  "type": "bearer"
}

Authentication

Request API Token

Step 1: Find your consumer key and secret Your consumer key and secret can be found by logging into Swoogo, and going to My Profile > API Credentials.

Step 2: Encode consumer key and secret The steps to encode your consumer key and secret into a set of credentials to obtain a bearer token are: 1) URL encode the consumer key and the consumer secret according to RFC 1738. 2) Concatenate the encoded consumer key, a colon character ”:”, and the encoded consumer secret into a single string. 3) Base64 encode the string from the previous step.

Step 3: Obtain a bearer token The value calculated in step 1 must be exchanged for a bearer token by issuing a request to POST /api/v1/oauth2/token: The request must be a HTTP POST request. The request must include an Authorization header with the value of your base 64 encoded token (from step 1). The request must include a Content-Type header with the value of application/x-www-form-urlencoded;charset=UTF-8. The body of the request must be grant_type=client_credentials.

Step 4: Authenticate API requests with the bearer token The bearer token may be used to issue requests to Swoogo API endpoints. To use the bearer token, construct a normal HTTPS request and include an Authorization header with the value of your bearer token from step 2.

Note: The tokens expires in 30 minutes.

POST

oauth2

token

cURL

# Encode your consumer key and secret as Base64
CREDENTIALS=$(echo -n "YOUR_CONSUMER_KEY:YOUR_CONSUMER_SECRET" | base64)

curl -X POST "https://api.swoogo.com/api/v1/oauth2/token" \
  -H "Authorization: Basic $CREDENTIALS" \
  -H "Content-Type: application/x-www-form-urlencoded;charset=UTF-8" \
  -d "grant_type=client_credentials"

{
  "access_token": "{{access-token}}",
  "expires_at": "2024-11-08 16:04:40",
  "type": "bearer"
}

Authorizations

Authorization

string

header

required

HTTP Basic authentication using your base64-encoded API consumer key and secret. Only used for the POST /oauth2/token endpoint to obtain a bearer token.

Body

application/x-www-form-urlencoded

grant_type

string

default:client_credentials

required

Must be client_credentials — the only supported grant type.

Example:

"client_credentials"

Response

200 - application/json

Request API Token

access_token

string

Example:

"{{access-token}}"

expires_at

string

Example:

"2024-11-08 16:04:40"

type

string

Example:

"bearer"

Introduction

Rate limits

⌘I