Getting started

A quick overview of an end-to-end integration with Transatel APIs

Integrating with Transatel

This guide shows you how to authenticate to Transatel APIs. This is a mandatory first step before calling any of our APIs.

Creating an account
Before starting integrating Transatel APIs, your will need an account.
To create it, please check account management.

Endpoints

Below all APIs url that you will need for this quick start guide:

Transatel APIs	URL
Authentication	https://api.transatel.com/authentication/api

All Transatel APIs are available through our unique API gateway https://api.transatel.com

API Authentication

Authentication is handled via the OAuth 2.0 protocol and its client credentials grant type.
To authenticate, a first request needs to be made against our Authentication API with your client credentials.
This will return you an access token, to use on subsequent requests via the HTTP header Authentication: Bearer <access_token>.

This example shows how to use the Authentication API to retrieve an access token:

curl --location --request POST \
    --header 'Authorization: Basic b2NzLXN1YnNjcmlwdGlvbi1vcmRlci1tYW5hZ2VyOm9jcy1zdWJzY3JpcHRpb24tb3JkZXItbWFuYWdlcg==' \
    --header 'Content-Type: application/x-www-form-urlencoded' \
    --data 'grant_type=client_credentials' \
    'https://api.transatel.com/authentication/api/token'

The response returned will contain the access_token:

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
{
  "access_token": "eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJidXNpbmVzc19lbnRpdGllcyI6WyJBbnkiXSwicHJpbmNpcGFsIjoib2NzLXN1YnNjcmlwdGlvbi1vcmRlci1tYW5hZ2VyIiwic2NvcGUiOlsiQ0FUQUxPR19QUk9EVUNUU19SRUFEX1RFQ0hOSUNBTCIsIkNBVEFMT0dfUFJPRFVDVFNfUkVBRCIsIlVTRVJfUkVBRCIsIklOVkVOVE9SWV9TVUJTQ1JJUFRJT05TX1JFQUQiXSwiZXhwIjoxNjE3MjYwNTYxLCJhdXRob3JpdGllcyI6WyJST0xFX0lOVEVSTkFMX1NZU1RFTSJdLCJqdGkiOiJmOTYwNTFmNS05ZmQzLTQxMDEtYjNkZC0xZjY2Y2Q2MWUzZjIiLCJjbGllbnRfaWQiOiJvY3Mtc3Vic2NyaXB0aW9uLW9yZGVyLW1hbmFnZXIifQ.KBTlltd459_4kPV0O3OfsBTFGBtoqRxG65o_NohK1U7IuJAvIjAa8Fj4Qon1ptFrrTR5M2o8l0f9Dl0D7r0Us6Ej6OsVlFXfQKUiXwVytNUTP7POB6l56Svc5CaVqkXgFKyt7_8h6Ii6R_RteujtSzJSWX7zeLSeemxsxKNtHLLIS_HLyNdQyIsVCZWRfFhdPJVQId_p6B08_A54sAwhrT7qssSbtpG1nGzdqsHdFfaqJt9ABhPedatHNlwcWtCnFthrOrD2rv0Yf8OnRLnt-ZWtypr0cqm6U-brtZeBMhcxgzF4afKlJbKN3K3drPJRrRPjL8L9bf2YvzsDWxY5lA",
  "token_type": "bearer",
  "expires_in": 3600,
  "scope": "CATALOG_PRODUCTS_READ CATALOG_PRODUCTS_READ_TECHNICAL INVENTORY_SUBSCRIPTIONS_READ USER_READ"
}

Please check the authentication guide for more details.

What to do next?

Now that you are successfully authenticated, continue to explore our guides on: