API

GTİP açık uçları

Web sitesinin kullandığı arama ve AI uçlarını kendi sisteminizden de çağırabilirsiniz. Yanıtlar JSON, kimlik doğrulama gerekmez; sitedeki günlük kota aynen geçerlidir. Anahtarlı API ve yüksek kota bugün sunulmuyor.

Veri WCO HS6 düzeyindedir: level en fazla 6. Beyanname için gereken 12 haneli kod bu uçlardan çıkmaz; entegrasyonunuzda sonucu beyan edilebilir kod gibi kullanmayın.

GET/api/gtip/search

Kod parçası veya anahtar kelimeyle arama. Türkçe ve İngilizce açıklamada arar.

`q`	zorunlu	Sorgu. “8418”, “84.18” veya “buzdolabı”. En az 2 karakter.
`limit`	opsiyonel	Kayıt sayısı, en çok 50. Varsayılan 20.

İstek

curl "https://gtip.movetech.app/api/gtip/search?q=8418&limit=2"

Yanıt

{
  "query": "8418",
  "count": 2,
  "results": [
    {
      "code": "8418",
      "hs6": "841800",
      "description_tr": "Buzdolapları, dondurucular ve diğer soğutma veya dondurma ekipmanları, …",
      "description_en": "Refrigerators, freezers and other refrigerating or freezing equipment, …",
      "level": 4,
      "parent_code": "84",
      "category_code": "XVI"
    },
    {
      "code": "841810",
      "hs6": "841810",
      "description_tr": "Buzdolapları ve dondurucular; ayrı dış kapılı kombinasyon buzdolabı-dondurucu, …",
      "description_en": "Refrigerators and freezers; combined refrigerator-freezers, …",
      "level": 6,
      "parent_code": "8418",
      "category_code": "XVI"
    }
  ],
  "translated_from": null,
  "quota": { "anon_used": 1, "anon_limit": 5 }
}

POST/api/gtip/ai-search

Ürün tarifinden gerekçeli 6 haneli kod önerisi. Yalnız veritabanındaki kodlara dayanır.

description zorunlu Ürün tarifi. En az 5 karakter.

İstek

curl -X POST "https://gtip.movetech.app/api/gtip/ai-search" \
  -H "Content-Type: application/json" \
  -d '{"description":"ev tipi kombi buzdolabı, ayrı dondurucu kapılı"}'

Yanıt

{
  "query": "ev tipi kombi buzdolabı, ayrı dondurucu kapılı",
  "response": "…gerekçeli öneri metni…",
  "candidates_considered": 8,
  "grounded": true,
  "tokens_in": 912,
  "tokens_out": 356,
  "quota": { "ai_used": 1, "ai_limit": 2 }
}

Kota ve hata kodları

Kod	Anlamı
`200`	Başarılı. Sonuç boş olabilir (count: 0).
`400`	Sorgu çok kısa veya eksik parametre.
`429`	Günlük kota doldu. Yanıtta upgrade_url (fiyatlandırma sayfası) döner.
`503`	AI sağlayıcı yapılandırılmamış (yalnız ai-search).

Anonim kota: 5 arama ve 2 AI sorgu / gün / IP; Türkiye saatiyle gece yarısı yenilenir. AI sorgusunda veritabanında hiç aday bulunamazsa model çağrılmaz ve hak düşmez (grounded: false). Ayrıntı için fiyatlandırma.

Yasal uyarı: Yanıtlar referans amaçlıdır ve gümrük müşaviri görüşü yerine geçmez. Beyanname tescili öncesi yetkili gümrük müşavirinize danışın.