{"openapi":"3.1.0","info":{"title":"KargoKonum API","version":"1.0.0","description":"T\u00fcrk kargo firmalar\u0131 i\u00e7in otomatik firma tespiti, g\u00f6nderi durumu, hareket ge\u00e7mi\u015fi ve \u015fube rehberi REST API."},"servers":[{"url":"https:\/\/kargokonum.com","description":"KargoKonum API Sunucusu"}],"security":[{"BearerAuth":[]}],"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer","description":"API anahtar\u0131n\u0131z\u0131 Authorization: Bearer kk_live_... ba\u015fl\u0131\u011f\u0131yla g\u00f6nderin."}}},"paths":{"\/v1\/detect\/{number}":{"get":{"summary":"Takip numaras\u0131ndan kargo firmas\u0131 tespiti (kotadan d\u00fc\u015fmez)","parameters":[{"name":"number","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Numaraya uyan firma adaylar\u0131"},"401":{"description":"Ge\u00e7ersiz veya eksik API anahtar\u0131"}}}},"\/v1\/track\/{number}":{"get":{"summary":"G\u00f6nderi durumu, hareket ge\u00e7mi\u015fi ve \u015fube bilgisi (KVKK maskeli)","parameters":[{"name":"number","in":"path","required":true,"schema":{"type":"string"}},{"name":"carrier","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"G\u00f6nderi detaylar\u0131 ve hareket ge\u00e7mi\u015fi"},"401":{"description":"Ge\u00e7ersiz veya eksik API anahtar\u0131"},"404":{"description":"G\u00f6nderi bulunamad\u0131"},"422":{"description":"Firma tespit edilemedi veya birden fazla aday var"},"429":{"description":"Dakikal\u0131k rate limit (60\/dk) veya ayl\u0131k kota a\u015f\u0131ld\u0131"}}}},"\/v1\/branches":{"get":{"summary":"Kargo \u015fube rehberi sorgulama","parameters":[{"name":"carrier","in":"query","required":false,"schema":{"type":"string"}},{"name":"city","in":"query","required":false,"schema":{"type":"string"}},{"name":"district","in":"query","required":false,"schema":{"type":"string"}},{"name":"q","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"E\u015fle\u015fen \u015fube listesi"},"401":{"description":"Ge\u00e7ersiz veya eksik API anahtar\u0131"}}}},"\/v1\/webhooks":{"post":{"summary":"G\u00f6nderi durum de\u011fi\u015fimi i\u00e7in HMAC imzal\u0131 webhook kayd\u0131 (Pro ve Limitsiz)","responses":{"201":{"description":"Webhook aboneli\u011fi olu\u015fturuldu"},"403":{"description":"Plan y\u00fckseltmesi gerekiyor"}}}}}}