इरादे से सबूत तक.

एक 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. बाह्य रूप से भुगतान करें, फिर हैश सबमिट करें

आपका अपना टेस्टनेट भुगतान कोड भुगतान भेजता है। सेवा को कभी भी वॉलेट सीड या निजी कुंजी न भेजें।

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 संपत्ति। सफल आंशिक भुगतान वितरित मेटाडेटा का उपयोग करते हैं, अनुरोधित राशि का नहीं। जटिल पथ, रूपांतरण और गैर-भुगतान लेनदेन समर्थित नहीं हैं। नोड टाइमआउट लंबित रहता है और डेड-लेटर कतार से ऑपरेटर पुनर्प्राप्ति की आवश्यकता हो सकती है।

सबूत और गोपनीयता सीमाएँ

रिपोर्ट और घोषणाएँ आपके खाते के लिए निजी हैं। सार्वजनिक प्रमाण हैश और न्यूनतम बैच/नेटवर्क जानकारी को उजागर करते हैं। एक एंकर आपूर्ति किए गए रिकॉर्ड की अखंडता को साबित करता है, न कि उसके दावों, वितरण या हर भुगतान के कवरेज को। प्लेटफ़ॉर्म एंकरिंग एक समर्पित प्रतिबंधित टेस्टनेट हस्ताक्षरकर्ता, स्पष्ट बजट और एक ऑपरेटर सक्षम चरण का उपयोग करती है।