Posta Kodu ve Kargo API

73.000'den fazla mahallenin posta kodu: koddan adrese, adresten koda.

Ücretsiz pakette var JSON · Türkçe4 uç Kaynak: PTT posta kodları (turkey-neighbourhoods), Kargo firmalarının takip sayfaları

/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

ParametreTürAçıklama
kod* metin
GET /v1/posta-kodu/ara ücretli paket 1 birim

İl / ilçe (/ mahalle) → posta kodları

ParametreTürAçı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ı

ParametreTürAçı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