आपके पास एक SWIFT/BIC कोड है जो एक फॉर्म, वेबहुक, या CSV से आ रहा है और आपको इसे भुगतान भेजने या इसे स्टोर करने से पहले प्रोग्रामेटिक रूप से मान्य करने की आवश्यकता है। इस लेख के अंत तक, आप एक SWIFT कोड को मान्य करने और इसके पार्स किए गए घटकों को एकल HTTP GET का उपयोग करके प्राप्त करने में सक्षम होंगे, जिसे आप इस सप्ताह शिप कर सकते हैं।
यह API क्या करती है और इसका उपयोग कब करें
SWIFT कोड लुकअप API एक दिए गए SWIFT (BIC) कोड को मान्य करती है और इसके बारे में संरचित डेटा लौटाती है। टीमें इसका उपयोग बैंक ट्रांसफर प्रवाह को गेट करने, वित्तीय डेटा सेट को साफ करने, और ऑनबोर्डिंग या भुगतान में सर्वर-साइड मान्यता जोड़ने के लिए करती हैं। आप एक SWIFT कोड पास करते हैं; API एक स्थिति, एक मानव-पठनीय संदेश, और एक संरचित ऑब्जेक्ट के साथ प्रतिक्रिया करती है जिसमें कोड और एक ब्रेकडाउन शामिल होता है।
क्योंकि यह Zyla API Hub पर एक API है, आपको एक खाता, एक API कुंजी, और मार्केटप्लेस में एक सब्सक्रिप्शन-और-कोटा मॉडल मिलता है। यदि आप पहले से ही वित्त या सत्यापन के लिए अन्य Zyla APIs का उपयोग कर रहे हैं, तो आप बिना किसी अन्य क्रेडेंशियल का प्रबंधन किए इस जांच को अपने स्टैक में जोड़ सकते हैं।
व्यापक कैटलॉग पर ब्राउज़ करें zylalabs.com—यहां 10,000 से अधिक सार्वजनिक APIs उपलब्ध हैं जो एक सुसंगत डेवलपर अनुभव के तहत हैं।
Zyla API Hub पर शुरू करना
त्वरित एकीकरण के लिए:
- Zyla API Hub पर SWIFT कोड लुकअप API लिस्टिंग खोलें और सब्सक्राइब पर क्लिक करें। आप जो पहली API जोड़ते हैं वह 7-दिन की परीक्षण अवधि या 50 अनुरोधों के साथ शुरू हो सकती है, उपलब्धता के आधार पर। कोई मुफ्त योजना नहीं है; उपयोग सब्सक्रिप्शन + कोटा है, प्रति कॉल भुगतान नहीं है—वर्तमान पहुंच विकल्पों और मूल्य निर्धारण के लिए API पृष्ठ की जांच करें।
- अपने खाते से अपनी API कुंजी कॉपी करें। प्रमाणीकरण हेडर के माध्यम से है: Authorization: Bearer YOUR_API_KEY।
- नीचे दिए गए एंडपॉइंट को अपने सर्वर या पसंद के टूल से कॉल करें।
आप हमेशा zylalabs.com पर वापस जा सकते हैं ताकि आप सब्सक्रिप्शन, कोटा, और API के बीच कुंजी प्रबंधित कर सकें।
एंडपॉइंट जिसका आप वास्तव में उपयोग करेंगे
SWIFT कोड लुकअप API एकल लुकअप एंडपॉइंट को उजागर करती है जिसे आप सीधे HTTP GET के साथ कॉल कर सकते हैं। इसका उपयोग तब करें जब आपके पास एक SWIFT/BIC कोड हो और आप एक मान्यता परिणाम और एक पार्स किया हुआ ब्रेकडाउन चाहते हों।
कोड लुकअप
- विधि: GET
- URL: https://zylalabs.com/api/1714/swift-code-lookup-api/1327/code-lookup
- आवश्यक क्वेरी पैरामीटर:
- कोड (स्ट्रिंग): SWIFT/BIC जिसे आप मान्य करना चाहते हैं। उदाहरण मान: ADTVBRDF
- प्रमाणन: Authorization: Bearer YOUR_API_KEY
कॉपी-पेस्ट cURL
यह आपके टर्मिनल से लाइव सेवा का परीक्षण करने का सबसे तेज़ तरीका है। अपनी कुंजी के साथ YOUR_API_KEY को बदलें:
curl -s -X GET "https://zylalabs.com/api/1714/swift-code-lookup-api/1327/code-lookup?code=ADTVBRDF"
-H "Authorization: Bearer YOUR_API_KEY"
आधिकारिक उदाहरण प्रतिक्रिया
API एक JSON दस्तावेज़ लौटाती है जिसमें एक शीर्ष-स्तरीय स्थिति और सफलता संकेतक, एक संदेश, और एक डेटा ऑब्जेक्ट होता है जिसमें कोड और इसका ब्रेकडाउन होता है। यहां आधिकारिक नमूना पेलोड है:
{
"status": 200,
"success": true,
"message": "SWIFT कोड AXISINBB301 मान्य है",
"data": {
"swift_code": "AXISINBB301",
"bank": null,
"city": null,
"branch": null,
"address": null,
"post_code": null,
"country": null,
"country_code": null,
"breakdown": {
"swift_code": "AXISINBB301",
"bank_code": null,
"country_code": null,
"location_code": null,
"code_status": null,
"branch_code": null
}
}
}
व्यवहार में पढ़ने के लिए:
- स्थिति और सफलता: इनका उपयोग अपने प्रवाह को गेट करने के लिए करें। 200 के साथ सफलता: true का मतलब है कि लुकअप सफल रहा।
- संदेश: एक मानव-पठनीय मान्यता संदेश जिसे आप ऑपरेटरों के लिए लॉग कर सकते हैं या प्रशासनिक उपकरणों में प्रदर्शित कर सकते हैं।
- data.swift_code: मान्य SWIFT/BIC।
- data.breakdown: कोड को घटकों में संरचित विभाजन। व्यक्तिगत फ़ील्ड उपलब्ध नहीं होने पर null हो सकते हैं।
आपकी सेवा में पेस्ट करने के लिए Python उदाहरण
नीचे दिया गया स्निपेट उसी एंडपॉइंट को कॉल करता है और प्रतिक्रिया फ़ील्ड और nulls को सुरक्षित रूप से संभालने का तरीका दिखाता है। URL और पैरामीटर मान ऊपर दिए गए आधिकारिक cURL से मेल खाते हैं, इसलिए आप इसे अपनी API कुंजी के अलावा कुछ भी संपादित किए बिना चला सकते हैं।
import os
import requests
API_KEY = os.environ.get("ZYLALABS_API_KEY", "YOUR_API_KEY")
URL = "https://zylalabs.com/api/1714/swift-code-lookup-api/1327/code-lookup"
params = {"code": "ADTVBRDF"}
headers = {"Authorization": f"Bearer {API_KEY}"}
resp = requests.get(URL, params=params, headers=headers, timeout=10)
resp.raise_for_status()
data = resp.json()
# बुनियादी गेटिंग
if not data.get("success"):
raise SystemExit(f"लुकअप विफल: {data.get('message')}")
print(f"संदेश: {data.get('message')}")
payload = data.get("data", {}) or {}
swift = payload.get("swift_code")
bank = payload.get("bank") # None हो सकता है
country = payload.get("country") # None हो सकता है
breakdown = (payload.get("breakdown") or {})
bank_code = breakdown.get("bank_code") # None हो सकता है
country_code = breakdown.get("country_code") # None हो सकता है
branch_code = breakdown.get("branch_code") # None हो सकता है
print("मान्य SWIFT कोड:", swift)
print("बैंक (यदि उपलब्ध हो):", bank)
print("देश (यदि उपलब्ध हो):", country)
print("ब्रेकडाउन:", {
"bank_code": bank_code,
"country_code": country_code,
"branch_code": branch_code
})
इसे वास्तविक प्रवाह में कैसे वायर करें
अधिकांश टीमें इस API को भुगतान निर्माण या लाभार्थी ऑनबोर्डिंग एंडपॉइंट से सर्वर-साइड कॉल करती हैं। एक सामान्य पैटर्न:
- उपयोगकर्ता बैंक विवरण प्रस्तुत करता है, जिसमें एक SWIFT/BIC कोड शामिल है।
- आपका बैकएंड SWIFT कोड को कोड लुकअप एंडपॉइंट को कॉल करके मान्य करता है, इसे सहेजने या उपयोग करने से पहले।
- यदि सफलता true है, तो जारी रखें; यदि false है या स्थिति 200 नहीं है, तो इनपुट को अस्वीकार करें और समीक्षा के लिए संदेश लॉग करें।
अन्य व्यावहारिक उपयोग:
- बैच क्लीनअप: एक CSV में SWIFT कोड पर पुनरावृत्ति करें और केवल उन पंक्तियों को स्टोर करें जो मान्यता पास करती हैं।
- सुलह उपकरण: मैनुअल QA के लिए अप्रत्याशित ब्रेकडाउन मानों के साथ प्रविष्टियों को स्वचालित रूप से फ्लैग करें।
- प्रशासनिक डैशबोर्ड: उपयोगकर्ता द्वारा प्रस्तुत SWIFT कोड के बगल में संदेश और ब्रेकडाउन दिखाएं।
समय बचाने के लिए कार्यान्वयन विवरण
- प्रमाणीकरण: प्रत्येक अनुरोध में Authorization: Bearer YOUR_API_KEY शामिल होना चाहिए।
- HTTP विधि: केवल GET। कोड को क्वेरी पैरामीटर के रूप में शामिल करें।
- Nulls: बैंक, देश, और व्यक्तिगत ब्रेकडाउन भागों जैसे फ़ील्ड null हो सकते हैं। उपयोग से पहले हमेशा null-चेक करें।
- कैशिंग: यदि आप बार-बार एक ही SWIFT कोड को मान्य करते हैं, तो विलंबता और कोटा उपयोग को कम करने के लिए अपने डेटा स्टोर में परिणाम को कैश करें। एक साधारण इन-मेमोरी TTL कैश या SWIFT कोड द्वारा की गई पंक्ति आमतौर पर पर्याप्त होती है।
- पर्यवेक्षण: समर्थन वृद्धि में तेजी से डिबगिंग के लिए इनपुट को अस्वीकार करते समय संदेश फ़ील्ड को लॉग करें।
- सुरक्षा: उपयोगकर्ता API कुंजी को लॉग न करें। अपने Zyla API कुंजी को पर्यावरण चर या एक सीक्रेट्स प्रबंधक में स्टोर करें।
- कोटा: Zyla APIs पर उपयोग सब्सक्रिप्शन + कोटा है। पहली API 7-दिन की परीक्षण अवधि या 50 अनुरोधों के साथ शुरू हो सकती है। वर्तमान सीमाओं के लिए, अपने खाते में API पृष्ठ देखें।
त्रुटि हैंडलिंग पैटर्न
हालांकि ऊपर दिया गया उदाहरण एक सफल लुकअप दिखाता है, उत्पादन कोड को निम्नलिखित के लिए सुरक्षा करनी चाहिए:
- गैर-200 HTTP प्रतिक्रियाएँ: संदर्भ के आधार पर अस्थायी विफलताओं या उपयोगकर्ता इनपुट त्रुटियों के रूप में व्यवहार करें।
- सफलता false: लॉग के लिए संक्षिप्त मानव व्याख्या के लिए संदेश पढ़ें और यह तय करें कि पुनः प्रयास करना है या अस्वीकार करना है।
- नेटवर्क टाइमआउट: उचित क्लाइंट टाइमआउट सेट करें और यदि ऑपरेशन आइडेम्पोटेंट है तो कॉल को पुनः प्रयासों के साथ लपेटें।
MCP के माध्यम से AI एजेंटों से API का उपयोग करना
यदि आप इस लुकअप को एक AI कोडिंग एजेंट या IDE सहायक में वायर करना पसंद करते हैं, तो Zyla MCP के माध्यम से संगत उपकरणों को उजागर करता है। अपने MCP-संगत क्लाइंट (जैसे, Claude Code, Cursor, Windsurf) को यहां दस्तावेज़ित एंडपॉइंट पर इंगित करें और अपनी API कुंजी के साथ अधिकृत करें। विवरण के लिए MCP दस्तावेज़ देखें:
यह आपको एक एजेंट कार्यप्रवाह के भीतर उसी कोड लुकअप को ट्रिगर करने की अनुमति देता है बिना अपने बैकएंड को बदले। आपका एजेंट वही GET अनुरोध भेजेगा और वही फ़ील्ड (स्थिति, सफलता, संदेश, data.swift_code, data.breakdown) पढ़ेगा। जब एजेंट एकीकरण का परीक्षण कर रहा हो तो अपनी API कुंजी को विकास वातावरण तक सीमित रखें।
एंड-टू-एंड मान्यता चेकलिस्ट
- Zyla API Hub पर सक्रिय सब्सक्रिप्शन और सुरक्षित रूप से स्टोर की गई API कुंजी।
- कोड को उपयोगकर्ता द्वारा प्रदान किए गए SWIFT/BIC के साथ कोड लुकअप एंडपॉइंट पर सर्वर-साइड GET कॉल।
- भुगतान करने या लाभार्थी को सहेजने से पहले सफलता और स्थिति की जांच करें।
- अपने UI या डेटा परत में null फ़ील्ड को सुचारू रूप से संभालें।
- जहां उपयुक्त हो SWIFT कोड द्वारा लुकअप को कैश करें।
- ऑपरेशनों और समर्थन के लिए संदेश लॉग करें।
आपकी कुंजी प्राप्त करने और अपना पहला अनुरोध चलाने के लिए कहाँ
API के लिए सब्सक्राइब करें, उपलब्ध होने पर 7-दिन की परीक्षण अवधि शुरू करें, और अपनी कुंजी कॉपी करें। आप ऊपर दिए गए cURL के साथ तुरंत एंडपॉइंट को कॉल कर सकते हैं और फिर Python उदाहरण को अपनी सेवा में डाल सकते हैं। अपने उपयोग का प्रबंधन करें और एक ही खाते से वित्त, डेटा समृद्धि, और उपयोगिताओं के अन्य APIs जोड़ें zylalabs.com पर।
SWIFT कोड लुकअप API पर 7-दिन की परीक्षण अवधि शुरू करें
अक्सर पूछे जाने वाले प्रश्न
कोड पैरामीटर के लिए कौन से इनपुट प्रारूप समर्थित हैं?
एक SWIFT/BIC कोड को GET अनुरोध में कोड क्वेरी पैरामीटर के माध्यम से एक साधारण स्ट्रिंग के रूप में पास करें।
मैं यह कैसे तय करूं कि SWIFT कोड मान्य है?
सफलता और स्थिति की जांच करें। लॉग या प्रशासनिक UI के लिए उपयुक्त संक्षिप्त व्याख्या के लिए संदेश भी पढ़ें।
क्यों कुछ फ़ील्ड डेटा या ब्रेकडाउन में null हैं?
हर कोड के लिए सभी मेटाडेटा उपलब्ध नहीं होते हैं। उपयोग करने से पहले हमेशा बैंक, देश, और ब्रेकडाउन के भागों जैसे फ़ील्ड की null-चेक करें।
क्या मैं एकीकरण से पहले अपने टर्मिनल से इसका परीक्षण कर सकता हूँ?
हाँ। अपने API कुंजी के साथ प्रदान किए गए cURL कमांड का उपयोग करें ताकि आप एंडपॉइंट और अपने प्रमाणीकरण हेडर को जल्दी से सत्यापित कर सकें।
बिलिंग कैसे संभाली जाती है?
Zyla APIs सब्सक्रिप्शन + कोटा मॉडल का उपयोग करती हैं, प्रति कॉल भुगतान नहीं। पहली API 7-दिन की परीक्षण अवधि या 50 अनुरोधों के साथ शुरू हो सकती है, उपलब्धता के आधार पर—वर्तमान विकल्पों के लिए अपने खाते में API लिस्टिंग की जांच करें।