इस वीडियो के बारे में

इस वीडियो में दिखाए गए रिस्पॉन्स असली API रिस्पॉन्स हैं, छोटे किए हुए। API कुंजियों और फ़ाइल सत्यापन के लिए सशुल्क खाता चाहिए।

वीडियो ट्रांसक्रिप्ट

1. 00:00फ़ाइल अपलोड करें

   CSV को /verify/file पर अपलोड करें, फिर वेबहुक को बताने दें कि काम कब पूरा हुआ। Bulk 50 पतों पर रुक जाता है। इससे बड़े किसी भी काम के लिए पूरी फ़ाइल multipart फ़ॉर्म डेटा के रूप में भेजें। CSV, TXT और XLSX स्वीकार होते हैं। email_column उस कॉलम का नाम बताता है जिसे पढ़ना है। उसे छोड़ दें, तो वह अपने आप पहचान लिया जाता है। यह टेस्ट फ़ाइल है। चार पंक्तियाँ, और एक source कॉलम जिसे हम नतीजों में रखना चाहते हैं। अपलोड जाँच पूरी होने का इंतज़ार नहीं करता। वह एक टास्क ID और pending स्टेटस के साथ जवाब देता है। वह यह भी बताता है कि उसने कौन-सा कॉलम पढ़ा, और उसे कितनी पंक्तियाँ और अनोखे पते मिले। API कुंजी की तरह ही फ़ाइल जॉब सशुल्क खातों के लिए हैं।

2. 00:43जॉब ट्रैक करें

   उसकी स्थिति देखने के लिए, उसी पाथ में टास्क ID जोड़कर GET करें। वही हेडर, कोई बॉडी नहीं। तुरंत पूछने पर यह छोटी फ़ाइल पहले ही merging में थी। चलते समय स्टेटस preparing, pending, processing और merging जैसे चरणों से गुज़रता है। जब completed, completed with warning, failed या cancelled दिखे, तो पूछना बंद कर दें। यह पूरा हुआ जॉब है। गिनतियाँ फ़ाइल को स्टेटस के हिसाब से बाँटती हैं: एक अमान्य, एक रोल, एक catch-all और एक डिस्पोजेबल। credits_used एक है, और cache_hit_not_charged तीन है। तीन पंक्तियाँ दोबारा जाँच थीं। उन पतों की इस खाते पर पिछले 24 घंटे में जाँच हो चुकी थी, और 24 घंटे के भीतर दोबारा जाँच पर शुल्क नहीं लगता। साथ में दो लिंक आते हैं। download_url स्थिर API पाथ है, इसलिए वही सहेजें। direct_download_url एक साइन किया हुआ स्टोरेज लिंक है, और दिखाए गए समाप्ति समय पर वह काम करना बंद कर देता है।

3. 01:35नतीजे पाएँ

   results को कॉल करें और आउटपुट को फ़ाइल में सहेजें। फ़िल्टर के बिना API पूरी नतीजा फ़ाइल पर रीडायरेक्ट करता है, और curl का -L उस रीडायरेक्ट को फ़ॉलो करता है। आपके कॉलम बिना बदले पहले आते हैं। फिर हर पंक्ति पर ev_ कॉलम आते हैं, जैसे status, score और reason। सिर्फ़ हटाई जाने वाली पंक्तियाँ चाहिए? फ़िल्टर जोड़ें। वे OR से जुड़ते हैं, इसलिए यह अमान्य या डिस्पोजेबल माँगता है। फ़िल्टर के साथ CSV बनकर सीधे लौट आती है। दो पंक्तियाँ लौटती हैं, जिन्हें हटाना है।

4. 02:04वेबहुक इस्तेमाल करें

   पोलिंग चलती है, लेकिन लंबे जॉब में बहुत सारे अनुरोध लगते हैं। वेबहुक इसे पलट देता है। फ़ाइल जॉब पूरा होने या विफल होने पर BillionVerify आपके सर्वर को कॉल करता है। /webhooks पर एक POST से उसे दर्ज करें। एक HTTPS URL और जो इवेंट चाहिए, वे दें। दो इवेंट हैं: file.completed और file.failed। उस रिस्पॉन्स में एक साइनिंग सीक्रेट होता है, और आप उसे सिर्फ़ एक बार देखेंगे। उसे तुरंत सहेज लें। हर डिलीवरी जाँचने के लिए वह चाहिए। हर डिलीवरी तीन हेडर वाला JSON POST है: इवेंट, टाइमस्टैम्प और सिग्नेचर। बॉडी इवेंट और समय बताती है। उसका data जॉब ID, गिनतियाँ, इस्तेमाल हुए क्रेडिट और डाउनलोड लिंक रखता है।

5. 02:44सिग्नेचर जाँचें

   किसी डिलीवरी पर कार्रवाई करने से पहले सिग्नेचर जाँचें। टाइमस्टैम्प हेडर, एक बिंदु और कच्ची बॉडी को जोड़ें। उस पर अपने सीक्रेट से HMAC-SHA256 चलाएँ, और सिग्नेचर हेडर से मिलाएँ। बॉडी को ठीक वैसे ही हैश करें जैसी वह पहुँची थी। पार्स करके दोबारा एन्कोड किया गया JSON मेल नहीं खाएगा। और पुराने टाइमस्टैम्प ठुकरा दें, ताकि कोई पुराना अनुरोध दोबारा न चलाया जा सके। तो पूरा फ़्लो छोटा है। अपलोड करें, टास्क ID सहेजें, वेबहुक का इंतज़ार करें, फिर स्थिर लिंक से नतीजे लाएँ।

6. 03:11अगले कदम

   स्टेटस मान, फ़िल्टर और वेबहुक का हर फ़ील्ड billionverify.com/docs/api-reference पर API रेफ़रेंस में है। खाते का उपयोग करने वाले हर दिन 20 निःशुल्क क्रेडिट, महीने में 600 तक। क्रेडिट कार्ड की ज़रूरत नहीं। billionverify.com पर शुरू करें।