Работа с API может выполняться на двух уровнях:

  • клиентские запросы
  • межсерверные запросы

Для выполнения всех запросов к сервису, необходимо передавать авторизационные данные в заголовках запроса.

Основная авторизация

Используется специальный ключ X-Iterios-Api-Key, в котором передается значение.
Пример с использованием curl:

curl -H 'X-Iterios-Api-Key: some_key_value' https://api-multicodes.iterios.com/v1/avia/reference

Ключ выдается по запросу на адрес support@iterios.com.

Обработка ошибок

В случае, когда ключ авторизация не был передан или же авторизация не выполнена, ответ будет в формате JSON с кодом ответа 403 Authentication Failed.

curl -i https://api-multicodes.iterios.com/v1/avia/reference

HTTP/1.1 403 Authentication Failed
Content-Type: application/json
Transfer-Encoding: chunked
Connection: keep-alive
Cache-Control: no-cache

{
    "status": "error",
    "error": {
        "code": 403,
        "message": "Authentication Failed"
    }
}

Примеры

Пример с использованием библиотеки GuzzleHttp:

use GuzzleHttp\Exception\RequestException;

$client = new GuzzleHttp\Client([
    'base_uri' => 'https://api-multicodes.iterios.com/v1/'
]);

try {
    $response = $client->request('GET', 'avia/reference', [
        'headers' => ['X-Iterios-Api-Key' => 'some_key_value']
    ]);
} catch (RequestException $e) {
    // Process exception data
    ...
}