API hızlı başlangıç

Gümrük AI REST API'si, JSON-over-HTTPS protokolü ile çalışır. Tüm uçlar https://api.gumruk.ai altındadır.

Yetkilendirme

API isteği için Bearer access token gerekir. Token'ı /auth/login ucundan edinirsiniz.

``bash curl -X POST "https://api.gumruk.ai/auth/login" \ -H "Content-Type: application/json" \ -d '{ "email": "siz@firma.com", "password": "**********", "tenant_id": "default" }' ``

Cevap:

``json { "access_token": "eyJ…", "refresh_token": "eyJ…", "expires_at": 1735000000000, "user": { "user_id": "u_…", "email": "siz@firma.com", "tenant_id": "default", "role": "owner" } } ``

access_token kısa ömürlüdür (1 saat); süresi dolduğunda /auth/refresh ile yenileyin.

GTİP araması

``bash curl -X POST "https://api.gumruk.ai/gtip/search" \ -H "Content-Type: application/json" \ -H "Authorization: Bearer ${TOKEN}" \ -d '{ "query": "polietilen granül, beyaz, gıda temaslı, ithalat", "tenant_id": "default" }' ``

Cevap:

``json { "candidates": [ { "gtip": "3902.30.00.00.11", "confidence": 0.81, "reasoning": "...", "citations": [ { "source": "TGTC fasıl notu 39.02", "excerpt": "..." } ] } ] } ``

Vergi hesaplama

``bash curl -X POST "https://api.gumruk.ai/taxes/calculate" \ -H "Content-Type: application/json" \ -H "Authorization: Bearer ${TOKEN}" \ -d '{ "gtip": "3902.30.00.00.11", "origin_country": "DE", "cif_value": 100000, "currency": "TRY", "quantity": 1000, "quantity_unit": "kg" }' ``

Dosya ön kontrolü

``bash curl -X POST "https://api.gumruk.ai/cases/precheck" \ -H "Content-Type: application/json" \ -H "Authorization: Bearer ${TOKEN}" \ -d '{ "case_id": "case_abc", "documents": [ { "kind": "proforma", "url": "https://...signed-url..." } ] }' ``

Hız ve kota

Hız limitleri planınıza göre değişir; güncel plan kapsamları fiyatlandırma sayfası'nda görünür. Kota aşıldığında 429 Too Many Requests döner; Retry-After başlığını takip edin.

OpenAPI

Tam şema için /docs/api sayfasını inceleyin (Swagger UI ile ReDoc embed edilmiştir).