Инструменты
SDK-примеры, скачивание OpenAPI-спецификации и интерактивные материалы
Инструменты
SDK-примеры, скачивание OpenAPI-спецификации и интерактивные материалы.
SDK-примеры
Готовые фрагменты кода для типовых сценариев интеграции — от первого запроса до парсинга реквизитов платёжной страницы:
Импорт в Postman
- Откройте Postman → Import.
- Перетащите файл
syncra-openapi.yaml(или выберите его через File). - Postman сгенерирует коллекцию со всеми эндпоинтами, схемами запросов/ответов и переменными окружения.
- Создайте окружение с переменными
base_url=https://api.syncra.moneyиmerchant_token— вашим API-ключом.
Импорт в Insomnia
- Откройте Insomnia → Create → Import From → File.
- Выберите
syncra-openapi.yaml. - Создастся workspace с готовыми запросами по всем эндпоинтам.
OpenAPI-спецификация
Полная machine-readable спецификация API — один файл, всегда актуальный: openapi.yaml. Используйте её для генерации клиентов на любом языке, валидации контрактов в CI или изучения схемы эндпоинтов.
curl -fsSL https://docs.syncra.money/openapi.yaml -o syncra-openapi.yamlЕсли публичного URL нет, файл доступен в поставке документации
(content/docs/api/merchant-api/openapi.yaml в репозитории docs) — запросите
актуальный URL у команды Syncra.
Интерактивный Try-it
Каждый эндпоинт в API Reference открывается на отдельной странице со схемами запроса и ответа и вкладкой Try-it — можно отправить реальный запрос со своими ключами и посмотреть живой ответ, не писав ни строки кода.
Для авторизации в Try-it подставьте заголовки X-Merchant-Token и
X-Signature (HMAC-SHA256 подпись тела запроса — см.
Аутентификация).
Реальные запросы через Try-it сработают только если на стороне API gateway
настроен CORS для вашего origin (https://api.syncra.money). Браузер
блокирует cross-origin запросы без заголовка Access-Control-Allow-Origin:
кнопка «Send» вернёт сетевую ошибку — в этом случае используйте curl,
SDK-примеры или серверные вызовы. Для серверной интеграции CORS не нужен.