Коллекция Postman
Каждый контракт поставляется с коллекцией Postman, предварительно настроенной с URL sandbox и примерами тел запросов. Импортируйте коллекцию, введите свои учётные данные — и вы сможете вызвать любой эндпоинт без написания кода.
Коллекции по контракту
| Контракт | Коллекция | Примечания |
|---|---|---|
| Authentication | Скачать | Скачайте файл ниже, импортируйте его в Postman и замените значения параметров "service_account", "tenant_id" и "secret_key" для тестирования запроса. |
| Web & SDK | Скачать | Включает создание процесса, GET process, GET evidences и GET PDF. |
| API | Скачать | Включает создание процесса (POST) и GET process. |
Настройка
- Скачайте коллекцию для нужного контракта.
- Импортируйте её в Postman:
File > Import > Upload Files. - Настройте учётные данные в зависимости от коллекции:
Authentication — откройте коллекцию, перейдите на вкладку Variables и заполните:
| Переменная | Значение |
|---|---|
service_account | Название вашего сервисного аккаунта. |
tenant_id | Ваш Tenant ID. |
secret_key | Ваш закрытый ключ (формат PEM). |
base_path | Хост конечной точки токена. По умолчанию UAT (https://identityhomolog.acesso.io); смените на https://identity.acesso.io для production. |
Web & SDK — откройте каждый запрос и замените значение Authorization: Bearer своим токеном доступа.
API — откройте каждый запрос и замените значения заголовков Authorization: Bearer и APIKEY своими учётными данными.
- Выполните запрос Authentication — pre-request скрипт автоматически создаёт JWT assertion и сохраняет его в
{{jwt_token}}.
Pre-request скрипты
Только коллекция Authentication включает pre-request скрипт. Он:
- Читает
service_account,tenant_id,secret_keyиbase_pathиз переменных коллекции. - Создаёт и подписывает JWT assertion (RS256) с помощью встроенной библиотеки KJUR.
- Сохраняет подписанный токен в
{{jwt_token}}, который автоматически подставляется в тело запроса.
Коллекции Web & SDK и API не содержат pre-request скриптов — учётные данные устанавливаются непосредственно в заголовках запросов.
Что дальше
- Аутентификация — создание учётных данных, необходимых для коллекции.
- Обзор Web & SDK — контекст для коллекции Web & SDK.
- Обзор API — контекст для коллекции API.