API

GTİP REST API

MoveTech GTİP servisini kendi sisteminize entegre edin. Açık API, rate limit, kontör tabanlı.

Authentication

Tüm istekler Authorization: Bearer mvtch_live_... header gerektirir.

API key oluşturmak için hesabınıza giriş yapın → Dashboard → API Keys (Beta).

GET /api/v1/gtip/search

Kelime veya kod parçasıyla arama.

curl https://gtip.movetech.app/api/v1/gtip/search?q=buzdolab%C4%B1 \
  -H "Authorization: Bearer mvtch_live_xxx"
{
  "query": "buzdolabı",
  "count": 12,
  "results": [
    { "code": "8418.10.20", "description_tr": "...", "level": 8 },
    ...
  ],
  "credits_used": 1,
  "credits_remaining": 999
}

GET /api/v1/gtip/lookup/:code

Tek bir GTİP kodunun tam detayı.

curl https://gtip.movetech.app/api/v1/gtip/lookup/8418 \
  -H "Authorization: Bearer mvtch_live_xxx"

POST /api/v1/gtip/ai-search

Doğal dil ile ürün tarifi → AI önerisi (5 kontör).

curl -X POST https://gtip.movetech.app/api/v1/gtip/ai-search \
  -H "Authorization: Bearer mvtch_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{"description": "buzdolabı kompresörü Çin'''den"}'

Rate Limits

PlanSorgu/dkAşımda
Starter5429
Pro60429
EnterpriseÖzel

Aşım durumunda Retry-After header döner.

Beta: API v1 şu an beta. Breaking değişiklikler olabilir, deprecated endpoint'ler 30 gün önceden duyurulur.