IBC Authority Service
Introduction
This secure service is used by clients to retrieve authority tokens which are appended to other IBC secured
services.
Your client must use HEAD HTTP method to successfully submit your BASE64 encoded credentials.
The service URL is:
https://api.pactrak.com/authority/token
For Zipx REST services the URL is:
https://api.pactrak.com/authority/token?_zipx
How to submit your data
Head request preparation -- Prepare input - Your request credential information must be
submitted as a request header parameter called IBCCredentials.
The parameter string must be submitted as a base64 encoded entry, and it contains your associated account
email and the password assigned to you by IBC. The base64 string has the form EMAIL_ADDRESS_|_ACCOUNT_PASSWORD.
NOTE: your password should not contain the PIPE (|) character.
For example the entry me@myemail.com|mypassword, encoded to base64 format produces: bWVAbXllbWFpbC5jb218bXlwYXNzd29yZAo=
- Submit input - You may use web form techniques or incorporate your preferred REST
submit solution, remember to properly set the correct headers before your submission is completed.
For example, this cUrl command sets and submits the IBCCredentials header:
curl -siL -X HEAD -H "IBCCredentials: YWpvenoxM0BnbWFpbCmFkcGFzcwo=" https://api.pactrak.com/authority/token
This request will yield a response with the following headers if authorized:HTTP/1.1 200 OKor if unauthorized
Authority: NmIzY2Y1OWV8SmFoMnc4Rk1doOGVyWHV0a282RWtEV1hlRlBvbDhTOExRPT0=HTTP/1.1 401 UnauthorizedUse the token assigned to the Authority header response in your service URL requests.
Authority: Not Authorized
Token Time Limit
Each token assigned is associated with your specific account and has a pre-determined time limit. You may reuse the token to submit as many request as needed until the token time limit is expired.