डेवलपर
ग्राहक API जॉब सबमिट करें
कुंजियाँ, idempotency, सीमाएँ और परिणाम पेजिनेशन।
स्कोप वाली कुंजी का उपयोग करें
प्रोडक्शन सत्यापन के लिए submit स्कोप वाली Live कुंजी का उपयोग करें। इसे अपने सर्वर पर रखें और केवल वही submit, read या balance स्कोप दें जिनकी आपको ज़रूरत है। Test कुंजियाँ आरक्षित उदाहरण पतों का सिमुलेशन करती हैं, जिसमें न कोई प्रदाता कॉल होती है और न क्रेडिट उपयोग होते हैं।
लाइव कुंजी की सीमा में काटे गए क्रेडिट और स्वीकृत आरक्षण दोनों गिने जाते हैं। सीमा पूरी होने पर, नया जॉब क्रेडिट रोके बिना अस्वीकार कर दिया जाता है। जाँचें प्रोसेसिंग के लिए स्वीकार होते ही वर्कस्पेस क्रेडिट आरक्षित किए जाते हैं, और डैशबोर्ड वाले ही कटौती तथा वापसी नियम लागू होते हैं।
सुरक्षित पुनःप्रयास
किसी जॉब के साथ एक स्थिर Idempotency-Key भेजें। मेल खाने वाला पुनःप्रयास वही जॉब लौटाता है। स्थिति और पेजिनेटेड परिणाम पढ़ने के लिए लौटाई गई जॉब ID का उपयोग करें। अलग पेलोड के साथ दोहराई गई कुंजी अस्वीकार कर दी जाती है।
परिचालन विराम के दौरान नए लाइव जॉब अस्थायी रूप से HTTP 503 live_verification_unavailable के साथ अस्वीकार हो सकते हैं, और कोई क्रेडिट नहीं रोका जाता। बाद में उसी idempotency key के साथ फिर से कोशिश करें। यह API कुंजी की अनुमतियों, कुंजी सीमाओं और रेट लिमिट से अलग है।