從意圖到證據。

取得 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.外部支付，然後提交hash

您自己的測試網付款代碼會發送付款。切勿向服務發送錢包助記詞或私鑰。

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資產。成功的部分付款使用交付的元數據，而不是請求的金額。不支援複雜路徑、轉換和非支付交易。節點逾時處於待處理狀態，可能需要操作員從死信佇列中復原。

證明和隱私邊界

報告和聲明對您的帳戶來說是私人的。公開證明公開了哈希值和最少的批次/網路資訊。錨點證明所提供記錄的完整性，而不是其索賠、交付或每筆付款的承保範圍。平台錨定使用專用的受限測試網簽署者、明確的預算和營運商支援步驟。