← Tüm entegrasyonlarREST API & Webhooks
Entegrasyon · REST APICanlı
REST API & Webhooks
Geliştiriciler için tam programmatik erişim
Pratik Gümrük'ün tüm yetenekleri OpenAPI 3.0 standardına uygun REST API ile erişilebilir. JWT veya API key auth, rate limit, OpenAPI spec, TypeScript tip otomasyonu. Webhook desteği yol haritasında.
Yetenekler
Bu entegrasyonun sunduğu özellikler.
OpenAPI 3.0 Spec
Tam spec /openapi.yaml — Swagger UI, Postman, openapi-typescript ile uyumlu.
JWT + API Key
İki auth seçeneği: kullanıcı oturumu için JWT, sistem entegrasyonu için pgk_<32hex>.
70+ Endpoint
Auth, Cases, GTİP, Tax, Documents, Risk, Regulations, BTB — hepsi REST.
Rate Limit
240 req/dk per user (auth), 20/dk per IP (login). 429 ile ban.
TypeScript Tip
openapi-typescript ile npm run gen:api → fully typed client.
CORS Hazır
Domain whitelist desteği ile cross-origin browser çağrıları.
İş akışı
01
API key oluştur
Profil → API Anahtarları. Tek seferlik gösterilir, kaydet.
02
Spec'i incele
/openapi.yaml veya Swagger UI.
03
Auth header
Authorization: Bearer pgk_<key> her istekte.
04
Endpoint çağır
JSON request/response, standart HTTP kodları.
Faydalar
- ✓ERP entegrasyonu (SAP, Logo, Mikro)
- ✓Müşavir yazılımına embed
- ✓Otomatik beyan iş akışları
- ✓Veri uzantısı ve raporlama scriptleri
Sıkça sorulanlar
Webhook ne zaman gelir?
Roadmap'te. Şu an polling tabanlı çalışıyor. Webhook ile case status, beyanname kabul/red bildirimleri planlı.
Versioning var mı?
URL prefix /api/v1. Breaking change'lerde /api/v2 açılır, eski sürüm 12 ay deprecated olarak kalır.
Ücreti nedir?
Profesyonel paketten itibaren dahil. Kurumsal'da rate limit 1000+/dk'ya yükseltilebilir.