Authenticating Private Requests
To authenticate your private requests provide your private token with the request.
For a GET endpoint request, simply append the token as a URL parameter:
curl -i \
-X GET \
-H "Accept: application/json" \
-H "Cache-Control: no-cache" \
"https://hub.api.caster.fm/private/GET_ENDPOINT?token=PRIVATE_TOKEN"For a POST endpoint request, include it with your POST data:
curl -i \
-H "Accept: application/json" \
-X POST \
-d "{token:PRIVATE_TOKEN}" \
"https://hub.api.caster.fm/private/POST_ENDPOINT" \Invalid Token Response
If the private token provided is invalid an HTTP status code 401 will be returned
Verifying The Private Token
You can verify a private token with a GET request to the following URL:
https://hub.api.caster.fm/private/checkToken?token=PRIVATE_TOKEN
curl -i \
-X GET \
-H "Accept: application/json" \
-H "Cache-Control: no-cache" \
"https://hub.api.caster.fm/private/checkToken?token=PRIVATE_TOKEN"If the provided private token is valid the HTTP status code will be 200 and the body will contain a JSON with the private and public token:
{
"public_token": "97824ed0-ee56-4d2c-ba29-efbcb76794c5",
"private_token": "a8ea3659-6989-494b-9e9a-142a5fb6f8f5"
}Invalid Token Response
If the private token provided is invalid an HTTP status code 401 will be returned