Με αυτό το εύχρηστο τελικό σημείο θα λάβετε μια λίστα ταχυδρομικών κωδικών που βρίσκονται σε μια δεδομένη απόσταση. Το παράδειγμα αιτήματος θα επιστρέψει μια λίστα με μοναδικούς ταχυδρομικούς κώδικες, μια πλήρη λίστα ταχυδρομικών κωδικών και τις λεπτομέρειες κάθε ταχυδρομικού κώδικα.
GET https://postalcodes.app/api/v1/?key=YOUR-APIKEY&distance=25&zipcode=10005&country=usΤο API μας δέχεται μετρήσεις απόστασης σε χιλιόμετρα (Προεπιλογή) ή μίλια.
Για να αλλάξετε τη μέτρηση σε χιλιόμετρα πρέπει να βάλετε την ms στο αίτημά σας:
GET https://postalcodes.app/api/v1/?key=YOUR-APIKEY&ms=km&distance=25&zipcode=10005&country=usΗ απάντηση θα μοιάζει με αυτήν:
{
"query":{
"code": "10005",
"country": "US",
"range": "25",
"measure": ""
},
"results":{
"range_codes_unique": ["07010", "07020", "07022", "07024", "07026", ...],
"range_codes": ["07010", "07020", "07022", "07024", "07026", ...],
"range_codes_details": [
{
"postal_code":"07010",
"country_code":"US",
"city":"Cliffside Park",
"state":"New Jersey",
"state_code":"NJ",
"province":"Bergen",
"province_code":"003"
},
{
"postal_code":"07020",
"country_code":"US",
"city":"Edgewater",
"state":"New Jersey",
"state_code":"NJ",
"province":"Bergen",
"province_code":"003"
},
{
"postal_code":"07022",
"country_code":"US",
"city":"Fairview",
"state":"New Jersey",
"state_code":"NJ",
"province":"Bergen",
"province_code":"003"
},
{
"postal_code":"07024",
"country_code":"US",
"city":"Fort Lee",
"state":"New Jersey",
"state_code":"NJ",
"province":"Bergen",
"province_code":"003"
},
{
"postal_code":"07026",
"country_code":"US",
"city":"Garfield",
"state":"New Jersey",
"state_code":"NJ",
"province":"Bergen",
"province_code":"003"
},
...
],
}
}
Το ακόλουθο παράδειγμα θα επιστρέψει τις λεπτομέρειες των ταχυδρομικών κωδικών που ταιριάζουν με το ερώτημα αναζήτησης.
GET https://postalcodes.app/api/v1/?key=YOUR-APIKEY&zipcode=10005&country=usΗ απάντηση θα μοιάζει με αυτήν:
{
"query":{
"code": "10005",
"country": "us",
"range": "",
"measure": ""
},
"results":{
"range_codes_unique": ["10005"],
"range_codes": ["10005"],
"range_codes_details": [
{
"postal_code":"10005",
"country_code":"US",
"city":"New York",
"state":"New York",
"state_code":"NY",
"province":"New York",
"province_code":"061"
}
],
}
}
Μπορείτε να περάσετε επιπλέον παραμέτρους για να λάβετε μόνο όσα χρειάζεστε στα αποτελέσματα, απλώς προσθέστε τα fields τιμών στο αίτημά σας.
GET https://postalcodes.app/api/v1/?key=YOUR-APIKEY&fields=["range_codes_unique"]&distance=25&zipcode=10005&country=usΗ απάντηση θα μοιάζει με αυτήν:
{
"query":{
"code": "10005",
"country": "US",
"range": "25",
"measure": ""
},
"results":{
"range_codes_unique": ["07010", "07020", "07022", "07024", "07026", ...]
}
}