{
"countryCode": "US",
"postalCode": "90210",
"found": true,
"partialMatch": false,
"count": 1,
"places": [
{
"countryCode": "US",
"postalCode": "90210",
"place": "Beverly Hills",
"region": "California",
"province": "Los Angeles",
"community": null,
"latitude": 34.0901,
"longitude": -118.4065,
"accuracy": "place"
}
],
"attribution": "Postal code data © GeoNames (https://www.geonames.org), CC BY 4.0."
}
curl --location --request GET 'https://zylalabs.com/api/14239/postal+code+api+-+121+countries+zip+lookup/35344/look+up+a+postal+code&country=Required&/=Required&code=Required' --header 'Authorization: Bearer YOUR_API_KEY'
{
"from": {
"countryCode": "ES",
"postalCode": "37007",
"place": "Salamanca",
"region": "Castilla - Leon",
"province": "Salamanca",
"community": "Salamanca",
"latitude": 40.9688,
"longitude": -5.6716,
"accuracy": "place"
},
"to": {
"countryCode": "ES",
"postalCode": "28013",
"place": "Madrid",
"region": "Madrid",
"province": "Madrid",
"community": "Madrid",
"latitude": 40.4187,
"longitude": -3.7076,
"accuracy": "place"
},
"distanceKm": 176.5,
"distanceMiles": 109.7,
"note": "Straight-line (great-circle) distance between postal code centroids.",
"attribution": "Postal code data © GeoNames (https://www.geonames.org), CC BY 4.0."
}
curl --location --request GET 'https://zylalabs.com/api/14239/postal+code+api+-+121+countries+zip+lookup/35345/distance+between+postal+codes?from=ES:37007&to=ES:28013' --header 'Authorization: Bearer YOUR_API_KEY'
{
"countryCode": "DE",
"postalCode": "10115",
"valid": true,
"places": 1
}
curl --location --request GET 'https://zylalabs.com/api/14239/postal+code+api+-+121+countries+zip+lookup/35346/validate+a+postal+code?country=DE&code=10115' --header 'Authorization: Bearer YOUR_API_KEY'
{
"count": 121,
"countries": [
{
"countryCode": "AD",
"postalCodes": 7
},
{
"countryCode": "AE",
"postalCodes": 178171
},
{
"countryCode": "AI",
"postalCodes": 1
},
{
"countryCode": "AL",
"postalCodes": 494
},
{
"countryCode": "AR",
"postalCodes": 20260
},
{
"countryCode": "AS",
"postalCodes": 1
},
{
"countryCode": "AT",
"postalCodes": 19225
},
{
"countryCode": "AU",
"postalCodes": 18521
},
{
"countryCode": "AX",
"postalCodes": 37
},
{
"countryCode": "AZ",
"postalCodes": 1186
},
{
"countryCode": "BD",
"postalCodes": 1349
},
{
"countryCode": "BE",
"postalCodes": 2781
},
{
"countryCode": "BG",
"postalCodes": 5304
},
{
"countryCode": "BM",
"postalCodes": 112
},
{
"countryCode": "BR",
"postalCodes": 5525
},
{
"countryCode": "BY",
"postalCodes": 3133
},
{
"countryCode": "CA",
"postalCodes": 1657
},
{
"countryCode": "CC",
"postalCodes": 1
},
{
"countryCode": "CH",
"postalCodes": 4520
},
{
"countryCode": "CL",
"postalCodes": 346
},
{
"countryCode": "CN",
"postalCodes": 2352
},
{
"countryCode": "CO",
"postalCodes": 3681
},
{
"countryCode": "CR",
"postalCodes": 473
},
{
"countryCode": "CX",
"postalCodes": 1
},
{
"countryCode": "CY",
"postalCodes": 1127
},
{
"countryCode": "CZ",
"postalCodes": 15507
},
{
"countryCode": "DE",
"postalCodes": 23300
},
{
"countryCode": "DK",
"postalCodes": 1159
},
{
"countryCode": "DO",
"postalCodes": 544
},
{
"countryCode": "DZ",
"postalCodes": 15951
},
{
"countryCode": "EC",
"postalCodes": 1225
},
{
"countryCode": "EE",
"postalCodes": 5398
},
{
"countryCode": "ES",
"postalCodes": 37867
},
{
"countryCode": "FI",
"postalCodes": 3576
},
{
"countryCode": "FK",
"postalCodes": 1
},
{
"countryCode": "FM",
"postalCodes": 4
},
{
"countryCode": "FO",
"postalCodes": 130
},
{
"countryCode": "FR",
"postalCodes": 51611
},
{
"countryCode": "GB",
"postalCodes": 27450
},
{
"countryCode": "GF",
"postalCodes": 77
},
{
"countryCode": "GG",
"postalCodes": 14
},
{
"countryCode": "GI",
"postalCodes": 1
},
{
"countryCode": "GL",
"postalCodes": 33
},
{
"countryCode": "GP",
"postalCodes": 105
},
{
"countryCode": "GS",
"postalCodes": 1
},
{
"countryCode": "GT",
"postalCodes": 548
},
{
"countryCode": "GU",
"postalCodes": 21
},
{
"countryCode": "HK",
"postalCodes": 1
},
{
"countryCode": "HM",
"postalCodes": 1
},
{
"countryCode": "HN",
"postalCodes": 38
},
{
"countryCode": "HR",
"postalCodes": 6774
},
{
"countryCode": "HT",
"postalCodes": 236
},
{
"countryCode": "HU",
"postalCodes": 3571
},
{
"countryCode": "ID",
"postalCodes": 81058
},
{
"countryCode": "IE",
"postalCodes": 139
},
{
"countryCode": "IM",
"postalCodes": 87
},
{
"countryCode": "IN",
"postalCodes": 155570
},
{
"countryCode": "IO",
"postalCodes": 1
},
{
"countryCode": "IS",
"postalCodes": 195
},
{
"countryCode": "IT",
"postalCodes": 18415
},
{
"countryCode": "JE",
"postalCodes": 5
},
{
"countryCode": "JP",
"postalCodes": 146883
},
{
"countryCode": "KE",
"postalCodes": 890
},
{
"countryCode": "KR",
"postalCodes": 35583
},
{
"countryCode": "LI",
"postalCodes": 13
},
{
"countryCode": "LK",
"postalCodes": 1837
},
{
"countryCode": "LT",
"postalCodes": 21870
},
{
"countryCode": "LU",
"postalCodes": 4519
},
{
"countryCode": "LV",
"postalCodes": 6101
},
{
"countryCode": "MA",
"postalCodes": 1325
},
{
"countryCode": "MC",
"postalCodes": 29
},
{
"countryCode": "MD",
"postalCodes": 1753
},
{
"countryCode": "MH",
"postalCodes": 2
},
{
"countryCode": "MK",
"postalCodes": 220
},
{
"countryCode": "MO",
"postalCodes": 1
},
{
"countryCode": "MP",
"postalCodes": 3
},
{
"countryCode": "MQ",
"postalCodes": 100
},
{
"countryCode": "MT",
"postalCodes": 73
},
{
"countryCode": "MW",
"postalCodes": 491
},
{
"countryCode": "MX",
"postalCodes": 144655
},
{
"countryCode": "MY",
"postalCodes": 2818
},
{
"countryCode": "NC",
"postalCodes": 52
},
{
"countryCode": "NF",
"postalCodes": 1
},
{
"countryCode": "NL",
"postalCodes": 4334
},
{
"countryCode": "NO",
"postalCodes": 5132
},
{
"countryCode": "NR",
"postalCodes": 1
},
{
"countryCode": "NU",
"postalCodes": 1
},
{
"countryCode": "NZ",
"postalCodes": 1738
},
{
"countryCode": "PA",
"postalCodes": 729
},
{
"countryCode": "PE",
"postalCodes": 96943
},
{
"countryCode": "PF",
"postalCodes": 207
},
{
"countryCode": "PH",
"postalCodes": 2317
},
{
"countryCode": "PK",
"postalCodes": 2563
},
{
"countryCode": "PL",
"postalCodes": 72899
},
{
"countryCode": "PM",
"postalCodes": 2
},
{
"countryCode": "PN",
"postalCodes": 1
},
{
"countryCode": "PR",
"postalCodes": 177
},
{
"countryCode": "PT",
"postalCodes": 206942
},
{
"countryCode": "PW",
"postalCodes": 1
},
{
"countryCode": "RE",
"postalCodes": 152
},
{
"countryCode": "RO",
"postalCodes": 37915
},
{
"countryCode": "RS",
"postalCodes": 1155
},
{
"countryCode": "RU",
"postalCodes": 43538
},
{
"countryCode": "SE",
"postalCodes": 18887
},
{
"countryCode": "SG",
"postalCodes": 121154
},
{
"countryCode": "SI",
"postalCodes": 556
},
{
"countryCode": "SJ",
"postalCodes": 8
},
{
"countryCode": "SK",
"postalCodes": 5233
},
{
"countryCode": "SM",
"postalCodes": 26
},
{
"countryCode": "TC",
"postalCodes": 1
},
{
"countryCode": "TH",
"postalCodes": 903
}
],
"_note": "Response truncated for documentation purposes"
}
curl --location --request GET 'https://zylalabs.com/api/14239/postal+code+api+-+121+countries+zip+lookup/35347/supported+countries' --header 'Authorization: Bearer YOUR_API_KEY'
साइन अप करने के बाद, प्रत्येक डेवलपर को एक पर्सनल API एक्सेस की असाइन की जाती है, जो अक्षरों और अंकों का एक यूनिक संयोजन होता है, जिसका उपयोग हमारे API एंडपॉइंट तक पहुंचने के लिए किया जाता है। प्रमाणीकरण के लिए पोस्टल कोड एपीआई - 121 देशों की ज़िप खोज API के साथ बस अपने बेयरर टोकन को Authorization हेडर में शामिल करें।
| हेडर | विवरण |
|---|---|
Authorization
|
आवश्यक
होना चाहिए Bearer access_key. जब आप सब्सक्राइब हों तो ऊपर "Your API Access Key" देखें।
|
कोई लंबी अवधि की प्रतिबद्धता नहीं। कभी भी अपग्रेड, डाउनग्रेड या कैंसल करें। फ्री ट्रायल में 50 रिक्वेस्ट तक शामिल हैं।
प्रत्येक अंत बिंदु पोस्टल कोड के बारे में विस्तृत जानकारी возвращाता है जिसमें स्थान नाम क्षेत्र प्रांत समन्वय और कोड के बीच की दूरी शामिल होती है सत्यापन अंत बिंदु इस बात की पुष्टि करता है कि क्या एक पोस्टल कोड मान्य है जबकि समर्थित देशों का अंत बिंदु सभी देशों और प्रत्येक के लिए उपलब्ध पोस्टल कोड की संख्या को सूचीबद्ध करता है
मुख्य क्षेत्रों में `countryCode`, `postalCode`, `place`, `region`, `province`, `latitude`, `longitude`, और `distanceKm` या `distanceMiles` शामिल हैं ये क्षेत्र डाक कोड के बारे में आवश्यक भौगोलिक और प्रशासनिक विवरण प्रदान करते हैं
प्रतिक्रिया डेटा JSON प्रारूप में संरचित है जिसमें स्थानों और दूरी के लिए नेस्टेड ऑब्जेक्ट्स हैं प्रत्येक एंडपॉइंट एक सुसंगत संरचना लौटाता है जिससे डेटा को प्रोग्रामेटिक रूप से पार्स और उपयोग करना आसान होता है
लुकअप एंडपॉइंट स्थान विवरण और प्रमाणीकरण स्थिति प्रदान करता है दूरी एंडपॉइंट पोस्टल कोड के बीच की दूरी की गणना करता है और समर्थित देशों का एंडपॉइंट सभी देशों की सूची देता है जिनके अपने-अपने पोस्टल कोड की संख्याएँ होती हैं
उपयोगकर्ता पोस्टल कोड को स्पेस और डैश के साथ या बिना इनपुट कर सकते हैं दूरी एंडपॉइंट को दो पोस्टल कोड की आवश्यकता होती है जबकि मान्यता एंडपॉइंट को एक की आवश्यकता होती है लुकअप एंडपॉइंट विस्तृत जानकारी के लिए एकल पोस्टल कोड को स्वीकार करता है
डेटा की सटीकता को GeoNames से स्रोत बनाकर बनाए रखा जाता है जो विश्वसनीय भौगोलिक जानकारी प्रदान करता है नियमित अपडेट और मान्यता जांच यह सुनिश्चित करती हैं कि डेटा अद्यतित और सटीक बना रहे
विशिष्ट उपयोग के मामलों में स्थान-आधारित सेवाएं लॉजिस्टिक्स योजना जनसांख्यिकी विश्लेषण और अनुप्रयोगों में पते को मान्य करना शामिल है व्यवसाय इस डेटा का उपयोग ग्राहक अनुभव को बढ़ाने और सेवा वितरण में सुधार के लिए कर सकते हैं
उपयोगकर्ता मैपिंग के लिए `latitude` और `longitude` जैसे विशिष्ट फ़ील्ड निकाल सकते हैं यात्रा गणनाओं के लिए `distanceKm` का उपयोग कर सकते हैं या फॉर्म में पते को मान्य कर सकते हैं संरचित JSON प्रारूप अनुप्रयोगों और सेवाओं में आसान एकीकरण की अनुमति देता है