Self-service agent onboarding
AA.Docs public synthetic sandbox
Это бесплатный self-service developer tier для первого вызова, contract tests и проверки integration flow. Он принимает только синтетические metadata и не может изменить production state.
Бесплатно, без регистрации и API key
Без файлов и сохранения данных
Sample document и process preview
01
Первый полезный результат
Сначала агент получает фиксированный synthetic contract. Затем он отправляет document type, amount, currency и признаки комплектности. В ответ приходят checks, stages, readyToStart и nextAction.
Этот flow показывает форму AA.Docs document process без имитации production environment. Ответ явно содержит sandbox true и persisted false.
curl -sS https://aadocs.ru/api/sandbox/v1/documents/sample
curl -sS https://aadocs.ru/api/sandbox/v1/processes/preview -H "Content-Type: application/json" -d '{"documentType":"contract","amount":125000}'02
Что sandbox никогда не делает
Sandbox не принимает документы, session cookies, OAuth tokens или персональные данные. Он не создает document, process, comment или decision в приложении.
Все identifiers относятся к фиксированным примерам. Для real integration test нужен отдельный authenticated environment с согласованными synthetic fixtures.
- No account and no API key
- No persistence and no production writes
- No file upload and no personal data
- Human confirmation remains required in production
03
Machine-readable contract
Все sandbox endpoints входят в root OpenAPI и имеют security с пустым списком. Capabilities endpoint сообщает live status, authentication requirements и data policy.
Capabilities JSON подтверждает free tier, self-service onboarding и zero-auth first call. Публичный sandbox явно разрешен в robots.txt. CORS разрешает browser contract tests, а RateLimit headers помогают агенту регулировать частоту вызовов. Ошибки возвращают error, message, hint и requestId.
Запустить synthetic preview
Получите sample document и process preview без регистрации. Для production data используйте authenticated environment.