Dokuméntasi API

Mimitian nganggo API anu gampang kami gunakeun ayeuna, turutan conto pikeun diajar kumaha ngagunakeunana.




GET Kéngingkeun kode pos dina jarak anu jauh

Kalayan titik akhir anu gampang dianggo ieu anjeun bakal kéngingkeun daptar kode Pos anu aya dina jarak anu ditangtoskeun. Conto pamundut bakal ngiringan daptar kode pos anu unik, daptar lengkep kode pos sareng detil unggal kode pos.

GET https://postalcodes.app/api/v1/?key=YOUR-APIKEY&distance=25&zipcode=10005&country=us

API kami nampi pangukuran jarak dina kilométer (Default) atanapi mil.

Pikeun ngarobih pangukuran kana kilométer anjeun kedah nempatkeun ms dina pamundut anjeun:

GET https://postalcodes.app/api/v1/?key=YOUR-APIKEY&ms=km&distance=25&zipcode=10005&country=us

Résponna bakal siga kieu:

{
   "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 Meunang detil kode pos

Conto ieu bakal balikkeun detil kode pos anu cocog sareng pamundut pamilarian.

GET https://postalcodes.app/api/v1/?key=YOUR-APIKEY&zipcode=10005&country=us

Résponna bakal siga kieu:

{
   "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"
          }
       ],
   }
}

GET Kéngingkeun data khusus

Anjeun tiasa lulus params tambahan pikeun meunang ukur naon nu peryogi dina hasil, ngan nambah nilai fields di pamundut anjeun.

GET https://postalcodes.app/api/v1/?key=YOUR-APIKEY&fields=["range_codes_unique"]&distance=25&zipcode=10005&country=us

Résponna bakal siga kieu:

{
   "query":{
      "code": "10005",
      "country": "US",
      "range": "25",
      "measure": ""
   },
   "results":{
       "range_codes_unique": ["07010", "07020", "07022", "07024", "07026", ...]
   }
}



Ngawitan nganggo API kami gratis ayeuna!

Kéngingkeun 240 pamundut gratis unggal dinten

+94 Nagara anu dirojong

AD (Andorra)
AR (Argéntina)
AS (Samoa Amérika)
AT (Austria)
AU (Australia)
AX (Kapuloan Åland)
AZ (Azerbaijan)
BD (Bangladés)
BE (Bélgia)
BG (Bulgaria)
BM (Bermuda)
BR (Brazil)
Flag of Belarus
BY (Bélarus)
CA (Kanada)
CH (Swiss)
CL (Chili)
CO (Colombia)
CR (Kosta Rika)
CY (Siprus)
CZ (Républik Czech)
Flag of Germany
DE (Jérman)
DK (Dénmark)
DO (Républik Dominika)
DZ (Aljazair)
EE (Éstonia)
ES (Spanyol)
FI (Finlandia)
FM (Mikronésia)
FO (Kapuloan Faroe)
FR (Perancis)
GB (karajaan Inggris)
GF (Guiana Perancis)
GG (Guernsey na Alderney)
GL (Greenland)
GP (Guadelup)
GT (Guatemala)
GU (Guam)
HR (Kroasia (Hrvatska))
HU (Hungaria)
IE (Irlandia)
IM (Lalaki (Pulo))
IN (India)
IS (Islandia)
IT (Itali)
JE (Jersey)
JP (Jepang)
Flag of South Korea
KR (Koréa Kidul)
LI (Liechtenstéin)
LK (Sri Lanka)
LT (Lituania)
LU (Luksemburg)
LV (Latvia)
MC (Monako)
MD (Moldova)
Flag of the Marshall Islands
MH (Kapuloan Marshall)
MK (Makédonia)
MP (Kapuloan Mariana Kalér)
MQ (Martinik)
MT (Malta)
Flag of Malawi
MW (Malawi)
MX (Méksiko)
MY (Malaysia)
Flag of New Caledonia
NC (Kalédonia anyar)
NL (Walanda The)
NO (Norwégia)
NZ (Selandia Baru)
PE (Peru)
Flag of the Philippines Coding according to the official "description and specification of the FILIPINO flag" in Executive Order No. 23 from 1936
PH (Filipina)
Flag of Pakistan
PK (Pakistan)
PL (Polandia)
PM (Saint-Piér jeung Mikélon)
the star is in the center of gravity of the triangle, so the x-pos is irrational (tan(30 deg) * 15)
PR (Puerto Rico)
PT (Portugal)
PW (Palau)
RE (reuni)
RO (Romania)
RS (Sérbia)
RU (Rusia)
SE (Swédia)
SG (Singapura)
Flag of Slovenia
SI (Slovénia)
SJ (Jan Mayen Kapuloan Svalbard Jeung)
Flag of Slovakia
SK (Slowakia)
SM (San Marino)
TH (Thailand)
TR (kalkun)
UA (Wikivoyage)
US (Amérika Sarikat)
Flag of Uruguay
UY (Uruguay)
Flag of Vatican City
VA (Vatikan Kota Propinsi (Tahta Suci))
VI (Virgin Islands (AS))
WF (Kapuloan Futuna Wallis Jeung)
YT (Mayotte)
ZA (Afrika Kidul)