← Tüm entegrasyonlarBeyannameAPI
Entegrasyon · APICanlı
BeyannameAPI
Pratik Gümrük'ü kendi sisteminize bağlayan REST API
Tüm modüllerin arkasındaki Go REST API, OpenAPI 3.0 spec ile dökümante edilmiş. Kendi ERP, müşavir yazılımı veya iş akışınıza entegre edebilir; GTİP tespit, vergi hesabı, beyanname hazırlama hepsini API üzerinden çağırabilirsiniz.
Yetenekler
Bu entegrasyonun sunduğu özellikler.
OpenAPI 3.0
Tam spec dosyası /openapi.yaml — tüm endpoint'ler, şemalar, örnekler.
Bearer Token
JWT veya API key (pgk_<32hex>). Hesap ayarlarından üretilir.
Rate Limit
240 istek/dakika/kullanıcı (Profesyonel paket).
Webhook
Status değişikliklerinde callback URL'inize POST (planlanan).
TypeScript Tipleri
openapi-typescript ile otomatik tip üretimi (npm run gen:api).
Dokümantasyon
Swagger UI + Postman koleksiyon (planlanan).
İş akışı
01
API key üret
Profil → API Anahtarları → "Yeni Anahtar" — tek seferlik gösterilir.
02
Auth header
Authorization: Bearer pgk_xxxxx (her istekte).
03
Endpoint çağır
POST /api/v1/gtip/suggest, /tax/preview, /risk/preview vb.
04
Yanıt işle
Yapılandırılmış JSON, error'lar standart httpx.Error formatı.
Faydalar
- ✓Kendi yazılımınızla derin entegrasyon
- ✓Toplu işlem otomasyonu (ERP'den batch gönderim)
- ✓Müşavir yazılımına embed (CAS, Bilgi)
- ✓Webhook ile asenkron entegrasyon
Sıkça sorulanlar
API ücretli mi?
API erişimi Profesyonel ve Kurumsal paketlere dahil. Başlangıç paketi web arayüzüyle sınırlı.
Test ortamı var mı?
Production aynı zamanda 14 günlük deneme süresinde test ortamı görevi görür. Ayrı sandbox şu an yok.
Hangi diller desteklenir?
API dil-bağımsız (JSON). TypeScript için tip dosyası üretiyoruz; Python/Go/PHP'de manuel.