API и инструменты разработчика

API проверяет условия допуска и лимиты, сохраняет решения и историю согласований. Начните с примера в браузере, доступной тестовой среды или локального запуска.

Пример в браузере

Без регистрации и ключей. Вы получите демонстрационное решение и историю на тестовых данных; API и внешние участники не вызываются.

Открыть пример →

Тестовая среда

Сначала проверьте доступность сервера. При разрешённом доступе вы получите временную сессию тестовой организации и готовый запрос.

Проверить доступность →

Локальный запуск

Нужны доступ к закрытому репозиторию, Docker и его конфигурация. Инструкция содержит команды, запрос и ожидаемый ответ для этого окружения.

Открыть инструкцию и условия →

Техническая документация

Контракты и справочники

GUIDES

Developer Portal

Quickstart, API, events, webhooks и integration rules

ARCHITECTURE

Границы системы

Control plane, владельцы, evidence flow и external effects

REST

certrail.openapi.v1.yaml

OpenAPI 3.1 · синхронизирован с Go API

EVENTS

certrail.asyncapi.v1.yaml

AsyncAPI 3.1 · local Kafka · at-least-once

PROTOCOL BEHAVIOR

Правила работы с API

Поведение API CertaRail
Область	Фактическое поведение	Production gap
Аутентификация	Tenant-bound sandbox bearer	Production IdP, rotation, service identities
Идемпотентность	Stable replay; payload conflict → 409	Shared durable policy across external commands
Ошибки	Strict JSON; 400/401/403/409/415/429/503	Partner-specific observability and support routing
Rate limits	In-flight backpressure; Retry-After where documented	Edge quotas and contractual limits
Events	Transactional outbox, at-least-once, event_id dedupe	TLS/SASL/ACL and external delivery
Webhooks	Signed checkout envelope, tenant-scoped Inbox, subscription rotation, test events, bounded/manual retry	External production HTTPS delivery, production secrets, UAT
SDK	TypeScript, Python и Go SDK 0.1.0 source packages; local package/module gates	Public npm/PyPI/Go module distribution, provenance attestation, owner approval

Поведение API CertaRail

Аутентификация

Фактическое поведение: Tenant-bound sandbox bearer
Production gap: Production IdP, rotation, service identities

Идемпотентность

Фактическое поведение: Stable replay; payload conflict → 409
Production gap: Shared durable policy across external commands

Ошибки

Фактическое поведение: Strict JSON; 400/401/403/409/415/429/503
Production gap: Partner-specific observability and support routing

Rate limits

Фактическое поведение: In-flight backpressure; Retry-After where documented
Production gap: Edge quotas and contractual limits

Events

Фактическое поведение: Transactional outbox, at-least-once, event_id dedupe
Production gap: TLS/SASL/ACL and external delivery

Webhooks

Фактическое поведение: Signed checkout envelope, tenant-scoped Inbox, subscription rotation, test events, bounded/manual retry
Production gap: External production HTTPS delivery, production secrets, UAT

SDK

Фактическое поведение: TypeScript, Python и Go SDK 0.1.0 source packages; local package/module gates
Production gap: Public npm/PyPI/Go module distribution, provenance attestation, owner approval

Opaque references

Передавайте subject references, а не персональные данные, если контракт не требует иного.

Retry same command

После timeout повторяйте тот же idempotency key и payload, а не создавайте новый intent.

Evidence ≠ execution

Decision, order draft или provider observation не доказывают движение денег или актива.