От намерения к доказательствам.

Получите ключ API

curl -X POST https://agenttrail.online/api/v1/accounts \
  -H 'Content-Type: application/json' -d '{}'

Ответ содержит account_id, key_id и одноразовый api_key. Сохраните его надежно. Создание учетной записи и выдача нового ключа создают новые учетные данные при каждом успешном вызове; они не являются конечными точками воспроизведения. Утерянные ключи не могут быть восстановлены этой службой разработки. Выдавайте ключи агента с определенной областью действия с консоли.

1. Запишите ожидаемый платеж

export AUDIT_KEY='<save the one-time API key securely>'
curl -X POST https://agenttrail.online/api/v1/audit/intents \
  -H "Authorization: Bearer $AUDIT_KEY" \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: your-stable-intent-reference' \
  -d '{"agent_id":"research-01","network":"xrpl-testnet", "asset":{"type":"native","currency":"XRP"},"expected_amount":"1","recipient":"<recipient classic address>","purpose":"purchase_market_data"}'

Суммы представляют собой десятичные строки. Тестовую сеть и основную сеть нельзя смешивать. Цель и личность агента являются декларациями, а не доказательством авторизации. Дополнительный payer_address включает сопоставление отправителей; без него сопоставление плательщиков не проверяется. Используйте context_hash для конфиденциального контекста задачи.

2. Оплатите внешнюю систему, затем отправьте хэш

Ваш собственный платежный код Testnet отправляет платеж. Никогда не отправляйте сервису начальное значение кошелька или закрытый ключ.

curl -X POST https://agenttrail.online/api/v1/audit/transactions \
  -H "Authorization: Bearer $AUDIT_KEY" \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: your-stable-payment-reference' \
  -d '{"audit_id":"<audit_id>","network":"xrpl-testnet","tx_hash":"<64-character hash>"}'

Ответ 202 означает, что ожидается проверка. Повторите аудит записи с тем же Idempotency-Key и телом запроса после ошибок транспорта. Повторное использование ключа с другим телом возвращает 409.

3. Проверьте статус, скачайте и выполните независимую проверку

curl -H "Authorization: Bearer $AUDIT_KEY" \
  https://agenttrail.online/api/v1/audit/records/<audit_id>
curl -H "Authorization: Bearer $AUDIT_KEY" \
  https://agenttrail.online/api/v1/audit/records/<audit_id>/report -o audit.json

Статус платежа и статус привязки разделены. Только anchor_validated устанавливает завершенную привязку. Загруженные отчеты могут находиться в ожидании; тогда независимая проверка должна явно потерпеть неудачу. Используйте страницу проверки локально или запустите скрипты/verify_report.py из репозитория.

Ошибки и границы поддержки

400: неверный ввод, неправильная сеть или отключен эмитент. 401: неверный/отозванный ключ. 403: недостаточный объем. 404: запись отсутствует или недоступна. 409: конфликт идемпотентности/транзакций или отчет не готов. 413: тело слишком велико. 429: квота превышена, повторите попытку позже. 503: хранилище/провайдер недоступен; повторите попытку безопасно.

Поддерживаемая интерпретация платежей: прямые активы XRP и активные активы RLUSD. Для успешных частичных платежей используются доставленные метаданные, а не запрошенная сумма. Сложные пути, конверсионные и неплатёжные транзакции не поддерживаются. Тайм-ауты узла остаются в ожидании и могут потребовать восстановления оператора из очереди недоставленных сообщений.

Границы доказательств и конфиденциальности

Отчеты и декларации доступны только в вашей учетной записи. Публичные доказательства раскрывают хеши и минимальную информацию о пакете/сети. Якорь доказывает целостность предоставленной записи, а не ее претензий, доставки или покрытия каждого платежа. Привязка платформы использует выделенную ограниченную подписывающую сторону Testnet, явные бюджеты и этап включения оператора.