Navigation
Authentication

Intro

When calling the bigtickets.com API you must authenticate yourself by using the Secret Key provided to you by your administrator. The Secret Key can be found afer logging in as an administrator by clicking on the link in the upper right labeled Configure Defaults.

Basic access authentication is used to authenticate a request using your secret key as your username. A password is not required to make a request.

Your "Secret Key" is used to prove your identity, so make sure it remains confidential!
  • Never push your secret key to a public repository (eg GitHub).
  • Never use your secret key to make requests within the browser (eg $.ajax).

Raw HTTP Example

The base URL for all version v1 API calls is https://api.bigtickets.com/v1

An "Authorization" header is required when doing HTTP calls. The value for the "Authorization" header is the Secret Key followed by a colon and then encoded using Base64. "Basic" is then prepended to the encoded string and used as the "Authorization" header.

Authorization: Basic UVZWS2RFbDBlbU5oVWtWSWRHdEhTRFpyUW13MlVUMDk6
# Steps Example
1 Retrieve your Secret Key from your administrator QVVKdEl0emNhUkVIdGtHSDZrQmw2UT09
2 Append a colon to it QVVKdEl0emNhUkVIdGtHSDZrQmw2UT09:
3 Encode it using Base64 UVZWS2RFbDBlbU5oVWtWSWRHdEhTRFpyUW13MlVUMDk6
4 Use it as the "Authorization" header in the HTTP call Authorization: Basic UVZWS2RFbDBlbU5oVWtWSWRHdEhTRFpyUW13MlVUMDk6 
curl https://api.bigtickets.com/v1/accounts -H "Authorization: Basic UVZWS2RFbDBlbU5oVWtWSWRHdEhTRFpyUW13MlVUMDk6"