Hostra logoHostra
Разработчикам

Раздел для разработчиков

Hostra — расчётная инфраструктура, доступная через REST API с описанием OpenAPI 3.0 (без gRPC и без готовой библиотеки). Эта страница — карта: сначала общие правила, затем документация, текущее состояние сервиса и описание архитектуры, которые понадобятся при подключении.

Общие правила API

Базовый адрес
https://api.hostracore.com — все ресурсы находятся по пути /v1/…
Вход
Сессионный файл cookie для пользователя; Authorization: Bearer hstra_… или X-API-Key для серверного доступа продавца.
Idempotency-Key
UUID v4, обязателен при создании и изменении переводов и расчётов; повтор с тем же ключом возвращает исходный результат.
X-Request-ID
Передаётся в каждом запросе и сохраняется в журналах и записях о расчётах для поиска.
Ошибки
Ответы в формате RFC 7807: тип, заголовок, код и понятное описание.
События
Исходящие уведомления с подписью HMAC-SHA256, повторной отправкой и очередью недоставленных.

Типичный сценарий перевода денег

  • POST /v1/quotes — получить котировку на сервере; она действует 60 секунд, устаревшая отклоняется с кодом HTTP 410.
  • POST /v1/transfers — создать перевод с ключом идемпотентности UUID v4; поручение сохраняется до обращения к провайдеру.
  • GET /v1/transfers/{id} — получить точный статус; никогда не вычисляйте статус на стороне клиента.
  • Получайте итоговый статус из подписанного уведомления, а не бесконечными опросами.
  • Скачивайте квитанции по успешным операциям, если API их предоставляет.

Ключи и права

Серверные ключи привязаны к продавцу и имеют права: transfers:read/write, quotes:read/write, settlements:read/write/reverse, audit:read, webhooks:read/write и devices:read/write. Полный ключ показывается один раз при создании, после этого хранится только его начало. Никогда не вставляйте ключи в код, который работает в браузере.

Справочные материалы

  • Документация API — описание всех запросов и спецификации OpenAPI.
  • Работающий API — состояние, версия и общий документ OpenAPI.
  • Состояние API — работоспособность каждой части сервиса.
  • Архитектура — сервисы, смены состояний и обмен сообщениями.
  • Расчётный движок — гарантии надёжности и однократного исполнения.
  • Журнал аудита — цепочка хешей и способ её проверки.

Документация APIРаботающий APIСостояние APIАрхитектураРасчётный движокКнига учётаЖурнал аудита

Данные для программ и ИИ-помощников

Программам и ИИ-помощникам лучше опираться на эти автоматически созданные источники, а не на рекламные страницы: openapi.json, Swagger UI, health и llms.txt.