Posta Kodu ve Kargo API
73.000'den fazla mahallenin posta kodu: koddan adrese, adresten koda.
/v1/posta-kodu bir posta kodunun il, ilçe ve mahallelerini; /v1/posta-kodu/ara il, ilçe ve mahalle adından posta kodunu bulur. Adres formlarında otomatik doldurma ve doğrulama için kullanılır.
/v1/kargo/takip takip numarasının biçiminden olası kargo firmasını tahmin eder ve resmî takip sayfasının bağlantısını verir (canlı gönderi durumu döndürmez). Firmaların listesi /v1/kargo/firmalar'da.
Hızlı başlangıç
Anahtarınızı X-API-Key başlığında gönderin (ücretsiz anahtar al).
Anahtarı tarayıcı koduna koymayın; sunucunuzdan çağırıp sonucu önbelleğe alın.
<?php
$ch = curl_init('https://api.veriapi.pro/v1/posta-kodu?kod=81650');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_TIMEOUT => 10,
CURLOPT_HTTPHEADER => ['X-API-Key: va_ANAHTARINIZ'],
]);
$yanit = json_decode(curl_exec($ch), true);
curl_close($ch);
print_r($yanit['veri']);
const yanit = await fetch("https://api.veriapi.pro/v1/posta-kodu?kod=81650", {
headers: { "X-API-Key": "va_ANAHTARINIZ" },
});
const { veri, kaynak } = await yanit.json();
console.log(veri);
import requests
r = requests.get("https://api.veriapi.pro/v1/posta-kodu?kod=81650",
headers={"X-API-Key": "va_ANAHTARINIZ"}, timeout=10)
print(r.json()["veri"])
curl -H "X-API-Key: va_ANAHTARINIZ" \ "https://api.veriapi.pro/v1/posta-kodu?kod=81650"
Örnek yanıt
GET https://api.veriapi.pro/v1/posta-kodu?kod=81650 — gerçek veriyle; listeler kısaltıldı.
{
"veri": {
"posta_kodu": "81650",
"adet": 8,
"yerler": [
{
"posta_kodu": "81650",
"il": "Düzce",
"plaka": 81,
"ilce": "Akçakoca",
"mahalle": "Ayazlı"
},
{
"posta_kodu": "81650",
"il": "Düzce",
"plaka": 81,
"ilce": "Akçakoca",
"mahalle": "Cumhuriyet"
},
{
"posta_kodu": "81650",
"il": "Düzce",
"plaka": 81,
"ilce": "Akçakoca",
"mahalle": "Hacı Yusuflar"
},
"… 5 öğe daha"
]
},
"kaynak": [
{
"kod": "posta_kodu",
"ad": "PTT posta kodları (turkey-neighbourhoods)",
"lisans": "MIT (veri derlemesi); kaynak PTT posta kodu listesi",
"atif": "Posta kodları: PTT listesinden derlenen turkey-neighbourhoods veri seti (MIT)",
"url": "https://github.com/muratgozel/turkey-neighbourhoods"
}
],
"guncelleme": null,
"bayat": false
}
Uçlar ve parametreler
GET /v1/posta-kodu
ücretsiz pakette
1 birim
Posta kodu → il, ilçe, mahalle
| Parametre | Tür | Açıklama |
|---|---|---|
| kod* | metin |
GET /v1/posta-kodu/ara
ücretli paket
1 birim
İl / ilçe (/ mahalle) → posta kodları
| Parametre | Tür | Açıklama |
|---|---|---|
| il* | metin | |
| ilce | metin | |
| mahalle | metin | |
| limit | tam sayı | varsayılan: 200 |
GET /v1/kargo/takip
ücretsiz pakette
1 birim
Takip numarasından kargo firması ve takip bağlantısı
| Parametre | Tür | Açıklama |
|---|---|---|
| no* | metin | |
| firma | metin | Firma kodu (liste: /v1/kargo/firmalar) |
GET /v1/kargo/firmalar
ücretsiz pakette
1 birim
Kargo firmaları ve resmî takip sayfaları
Konum alan uçlarda konum (slug), il + ilce (ad, slug ya da plaka) ya da enlem + boylam kullanılabilir.
Tüm parametreler: OpenAPI belgesi.
Nerelerde kullanılır?
- ✓E-ticaret ödeme sayfasında adres doldurma
- ✓CRM'de adres doğrulama
- ✓Sipariş e-postasında kargo takip bağlantısı
Kaynak ve lisans
- PTT posta kodları (turkey-neighbourhoods) · MIT (veri derlemesi); kaynak PTT posta kodu listesi · kaynak
Atıf: Posta kodları: PTT listesinden derlenen turkey-neighbourhoods veri seti (MIT)
- Kargo firmalarının takip sayfaları · Bağlantı bilgisi (olgu)
Atıf: Gönderi durumu firmanın kendi takip sayfasında gösterilir
Her yanıtın kaynak alanı bu bilgiyi taşır; veriyi gösterdiğiniz yerde atıf metnini yazın.
Sık sorulan sorular
Kargo durumunu gösteriyor mu?
Hayır; yalnızca firmayı tahmin eder ve resmî takip sayfasının bağlantısını verir.
Posta kodu verisi ne kadar güncel?
Mart 2024 tarihli derlemedir; yeni kurulan mahalleler eksik olabilir.
Bu sayfa şu aramalar için de: posta kodu sorgulama api · posta kodu json · kargo takip api · zip code api turkey