Use an API token

Use an API token to programmatically authenticate a user or a service through API calls.

Pass an API token with an API request

To use an API token to programmatically authenticate a user or a service:

1. Sign in to EclecticIQ Intelligence Center.

2. Create an API token

3. Pass it as a Bearer token: include the Authorization: Bearer ${API_token_value} HTTP header in any API requests to the public API endpoints of the Intelligence Center. Example:

   # Example: request a complete list of content packages for the specified feed
   curl -X GET \
       -v \
       --insecure \
       -i \
       -H "Content-Type: application/json" \
       -H "Authorization:Bearer eyJhbGciOiJU ... wiZ1oxNTEwaTIyNDcwfQ.eyJ1c2VyX2lk1jo3fQ.3o65E263hSGf4od5o4eoME2GRF-CnYJvaVg69YTq9HU" \
       --url https://${platform_host}/feeds/downloads/200
   

   Note

   • If you make HTTPs cURL calls to the API, and if you have a self-signed or an invalid certificate, include the -k or the --insecure parameter in the cURL call to skip the SSL connection CA certificate check.

   • Always append a / forward trailing slash at the end of an API URL endpoint.

     The only exception is /auth, which does not take a forward trailing slash.

   • In the cURL call, the -d data payload with the entity information must be flat JSON, not hierarchical JSON.

     To pass a hierarchical JSON object, include the --data-binary parameter, followed by the path to the JSON file, for example @/path/to/entity_file.json

     Example: --data-binary @/path/to/entity_file.json