Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

As a practice, we share the API credentials in the are generated by the integration team/client with every feature release.

Optionally, we can also provide them in a kick-off email. Use the account and password to log in Boxalino Intelligence Admin (IA) (per request).

The credentials are available in Boxalino Intelligence Admin, in the Account view https://intelligence.bx-cloud.com/#/app/account

...

Note

Make sure to use the appropriate API credentials for the scope of your request:
1. Data integration access
2. API request role
3. Data feed access
4. Newsletter access

Generation of the credentials

Steps #5 and #6 can be done once every pair of API key was created.

  1. Log in Intelligence Admin https://intelligence.bx-cloud.com/#/page/login

  2. Access the Account view https://intelligence.bx-cloud.com/#/app/account

  3. Click on “+Add API key” to add a new record

    Image Added

4. On the appeared row, do the following:

a) Set the STATUS to “Active”

b) Click on “GENERATE” to create each API Key / Secret

c) Select the required ROLE https://boxalino.atlassian.net/wiki/spaces/BPKB/pages/713785345/API+Credentials#Roles

d) Select the environments (all for ADMIN key)

...

5. Click on “Save Account

...

6. Click on “Generate API Keys”

...

Access

Based on your API request context, there are different set of API credentials for:

...

  1. CORE - use this role for API requests server-side (ex: search, navigation, batch etc)

  2. PUBLIC_NARRATIVE - used for client-side requests (ex: JS quicksearch), it only requires the API key and no API secret

  3. ADMIN - used as values for the BASIC AUTHORIZATION HEADERS for your Data Integration (DI) requests https://boxalino.atlassian.net/wiki/spaces/BPKB/pages/394559761/Sync+Request#Request-Definition / or Boxalino Convert endpoint test&review Boxalino Convert Endpoint

  4. PUBLIC_REST - used as values for the Newsletter REST integration Newsletter Image & Redirect URLs . It only has an API key and NO API SECRET.

  5. PUBLIC_READ - used as BASIC AUTHORIZATION HEADERS for your Data Feed (DF) requestsData Feeds (DF)

...