मुख्य सामग्री पर जाएं
GET
curl
Didit का Travel Rule डिलीवरी इतिहास API किसी लेन-देन की हर डिलीवरी प्रविष्टि लौटाता है, जो पृष्ठांकित होती है और सबसे पुरानी प्रविष्टि पहले आती है। अपनी x-api-key का उपयोग करें जिसके पास लेन-देन पढ़ने की अनुमति हो। transaction_id Didit लेन-देन UUID है। लेन-देन या स्थानांतरण न मिलने पर 404 लौटता है; अपर्याप्त अनुमति होने पर 403 लौटता है।

पेजिनेशन और क्रम

प्रतिक्रिया में count, next, previous और results शामिल होते हैं। limit का डिफ़ॉल्ट मान 100 है और इसकी अधिकतम सीमा भी 100 है। offset का डिफ़ॉल्ट मान शून्य है और यह 1,000,000 से अधिक नहीं होना चाहिए; इससे अधिक होने पर 400 लौटता है। count सामान्यतः अधिकतम 100 तक सीमित रहता है और बड़े इतिहास के लिए यह विश्वसनीय कुल संख्या नहीं है। count के बावजूद, next के null होने तक उसका अनुसरण करें। प्रविष्टियाँ निर्माण समय के अनुसार क्रमबद्ध होती हैं, और समान समय वाली प्रविष्टियों के लिए पहचानकर्ता के आधार पर क्रम तय होता है। हर प्रविष्टि में uuid, kind, status, rail, created_at, delivered_at और detail_lines होते हैं। rail का मान EMAIL, TRP, INTERNAL, NETWORK या चयन से पहले null हो सकता है। detail_lines संदेश के प्रकार और स्थिति का वर्णन करता है, लेकिन इसमें कच्चे त्रुटि संदेश या ट्रांसपोर्ट payload शामिल नहीं होते।

एम्बेडेड इतिहास

लेन-देन विवरण में travel_rule.deliveries की केवल नवीनतम 100 प्रविष्टियाँ शामिल होती हैं, जो सबसे पुरानी पहले के क्रम में दिखाई जाती हैं। deliveries_truncated आपको बताता है कि पुरानी प्रविष्टियाँ छोड़ी गई हैं या नहीं। लेन-देन सूचियों में ये दोनों इतिहास फ़ील्ड शामिल नहीं होते। मौजूदा delivery फ़ील्ड सबसे नई डिलीवरी का ही वर्णन करता रहता है। स्थिति के अर्थों के लिए डिलीवरी और पुनः प्रयास देखें। प्रतिपक्ष संदेश एक अलग संवाद endpoint है।

प्राधिकरण

x-api-key
string
header
आवश्यक

आपकी एप्लिकेशन की API कुंजी, Business Console में Developers -> API keys से। प्राथमिक कुंजी के पास पूर्ण एक्सेस होता है। एक नामित कुंजी को स्कोप किया जा सकता है: प्रति संसाधन none, read या write, कुछ वर्कफ़्लो या स्वीकृत सत्रों तक सीमित, IP पतों की सूची तक सीमित, और समाप्ति तिथि तक सीमित। 401 का अर्थ है कि कुंजी गलत है, निरस्त कर दी गई है या उसकी समय-सीमा समाप्त हो गई है; 403 का अर्थ है कि कोई कुंजी नहीं भेजी गई थी, कुंजी के पास इस संसाधन या कार्रवाई का एक्सेस नहीं है, या अनुरोध उसकी IP सूची से बाहर के पते से आया था; सत्र रूट पर 404 का अर्थ है कि सत्र कुंजी के वर्कफ़्लो या स्थितियों से बाहर है। मीडिया एक्सेस के बिना एक कुंजी को छवि, वीडियो और PDF URL null के रूप में प्राप्त होते हैं, और सत्र write के बिना एक कुंजी को सत्र लिंक और token null के रूप में प्राप्त होते हैं। देखें https://docs.didit.me/console/api-keys।

पथ पैरामीटर

transaction_id
string<uuid>
आवश्यक

ट्रांसफ़र का स्वामित्व रखने वाला Didit-स्थायी लेन-देन UUID।

क्वेरी पैरामीटर

limit
integer
डिफ़ॉल्ट:100

प्रति पृष्ठ प्रविष्टियाँ। डिफ़ॉल्ट 100 है, और इससे बड़े मान 100 तक सीमित कर दिए जाते हैं; 1,000,000 से अधिक मान 400 लौटाता है।

आवश्यक सीमा: 1 <= x <= 1000000
offset
integer
डिफ़ॉल्ट:0

छोड़ी जाने वाली प्रविष्टियों की संख्या, 1,000,000 तक। इससे बड़ा मान 400 लौटाता है।

आवश्यक सीमा: 0 <= x <= 1000000

प्रतिक्रिया

पृष्ठांकित डिलीवरी इतिहास, सबसे पुराना पहले।

count
integer
आवश्यक

गिनती सामान्यतः 100 तक सीमित रहती है; बड़े इतिहास के लिए यह विश्वसनीय कुल संख्या नहीं है। count चाहे जो हो, next के null होने तक आगे बढ़ते रहें।

आवश्यक सीमा: x >= 0
next
string<uri> | null
आवश्यक

अगले पेज का URL, या null।

previous
string<uri> | null
आवश्यक

पिछले पेज का URL, या null।

results
object[]
आवश्यक

प्रविष्टियाँ निर्माण समय के अनुसार सबसे पुरानी पहले, और फिर पहचानकर्ता के अनुसार क्रमबद्ध होती हैं।

अंतिम संशोधन 12 नवंबर 2026