API

Tehlikeli Madde REST API

UN numarası doğrulamasını kendi TMS, WMS veya ERP'nize bağlayın. Yanıtlar JSON, kimlik doğrulama anonim tier'da gerekmez.

Yanıttaki verified_at: null alanı, o kaydın resmî ADR Tablo A ile teyit edilmediğini bildirir. Entegrasyonunuzda bu alanı sessizce yutmayın — kullanıcıya gösterin veya onay akışına sokun.

GET/api/tehlikelimadde/search

UN numarası, Türkçe veya İngilizce taşıma adıyla arama.

`q`	zorunlu	Sorgu. “1203”, “UN1203” veya “aseton”. En az 2 karakter.
`class`	opsiyonel	Tehlike sınıfı filtresi (ör. “3”).
`limit`	opsiyonel	Kayıt sayısı, en çok 50. Varsayılan 20.

İstek

curl "https://tehlikelimadde.movetech.app/api/tehlikelimadde/search?q=1203"

Yanıt

{
  "query": "1203",
  "count": 1,
  "results": [
    {
      "un_number": "1203",
      "name_tr": "Benzin (motor benzini)",
      "name_en": "Motor spirit / Gasoline / Petrol",
      "class": "3",
      "classification_code": "F1",
      "packing_group": "II",
      "labels": ["3"],
      "tunnel_code": null,
      "verified_at": null,
      "source": "curated-starter"
    }
  ],
  "unverified_count": 1,
  "quota": { "anon_used": 1, "anon_limit": 5 }
}

POST/api/tehlikelimadde/ai-search

Madde tarifinden gerekçeli UN kaydı önerisi. Yalnız veritabanındaki kayıtlara dayanır.

description zorunlu Madde tarifi. En az 5 karakter.

İstek

curl -X POST "https://tehlikelimadde.movetech.app/api/tehlikelimadde/ai-search" \
  -H "Content-Type: application/json" \
  -d '{"description":"Parlama noktası 12 °C olan temizleme solventi"}'

Yanıt

{
  "query": "Parlama noktası 12 °C olan temizleme solventi",
  "response": "…gerekçeli öneri metni…",
  "candidates_considered": 7,
  "grounded": true,
  "unverified_in_context": 7,
  "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 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. AI sorgusunda veritabanında hiç aday bulunamazsa model çağrılmaz ve kontör düşmez (grounded: false). Daha yüksek limitler ve API key için fiyatlandırma.

Yasal uyarı: API yanıtları referans amaçlıdır ve resmî ADR metninin yerine geçmez. Sınıflandırma ve taşıma kararlarında yetkili TMGD onayı gerekir.