Авторизація

Згенерувати тимчасовий JWT-токен

get

https://api-stage.novapost.com/v.1.0https://api.novapost.com/v.1.0

/clients/authorization

Генерує тимчасовий JWT-токен для виконання авторизованих API-запитів. Як query-параметр необхідно передати валідний apiKey.

Як отримати apiKey:

• У Sandbox використайте POST /test-api-keys із зареєстрованим номером телефону з Client Portal (EBC): https://my.novapost.com/

• У PROD використовуйте персональний apiKey, наданий вашим менеджером

Використання:

• Виконайте GET /clients/authorization?apiKey={apiKey}

• У разі успіху скопіюйте jwt із відповіді

• Відкрийте діалог Authorize у цій документації, виберіть схему JWT і вставте jwt

• Після цього всі Try-it-out запити автоматично включатимуть Authorization: {jwt}

Примітки:

• JWT дійсний приблизно 1 годину; після завершення строку дії потрібно запросити новий

• Не зберігайте jwt довше за його TTL

• Маршрут /test-api-keys недоступний у PROD

🔹Опис елементів керування:

SCHEMA Відображає повну технічну структуру запиту або відповіді, включаючи назви полів, типи даних, обов’язкові поля, допустимі значення та правила валідації.

• Single line description Опис, що вміщується в один рядок; текст, який не поміщається, залишається прихованим.

• Multiline description Розширений опис, що відображає більше одного рядка тексту.

EXAMPLE Показує готовий приклад JSON із правильно сформованими значеннями для демонстрації того, як має виглядати валідний запит або відповідь.

Query parameters

apiKeystringRequired

Для використання цього методу потрібен персональний API-ключ.

Responses

200

JWT-token

application/json

401

Unauthorized

application/json

422

Validation error

application/json

503

Connection time-out

application/json

get

/clients/authorization

HTTPcURLJavaScriptPython

GET /v.1.0/clients/authorization?apiKey=text HTTP/1.1
Host: api-stage.novapost.com/
Accept: */*

{
  "jwt": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJucCIsImlhdCI6MTY4NTYyNzQxNCwiZXhwIjoxNjg1NjMxMDE0LCJjaWQiOiI1YzQxMmUzYS01ODY4LTQ4YjktYTYwYS0wZTAzOTI4NGVjNDYiLCJyZWYiOiI2NDI0NmRkMzg0ZWI3Yzg2MmMwMzg3YzAifQ.MmhM9rHCYItjA5a7B9PtrdKUKRiHhN43UotWKtKjt78"
}