API key ve authentication

Kimlik doğrulama

Noxery API, her isteği API key ile doğrular. Key'i HTTP Basic Auth veya query string ile değil, standart Bearer header'ı ile gönder. Böylece SDK'lar ve reverse proxy'ler beklenen davranışı korur.

Authorization: Bearer nox-YOUR_API_KEY
Content-Type: application/json

Key'i güvenli sakla

Key'i server-side environment variable olarak tut; tarayıcı koduna, mobil uygulamaya veya Git deposuna koyma. Bir key sızarsa API Keys sayfasından hemen iptal et ve yeni bir key oluştur.

Her key bir hesaba ve o hesabın plan limitlerine bağlıdır. Aynı key'i birden fazla agent paylaşabilir; session takibi için her agent konuşmasına ayrı session header'ı ver.

İlk kontrol

Key'in ve model erişiminin doğru olduğunu anlamak için önce küçük bir istek gönder. Model listesini public sayfadan kopyalamak yerine API'deki güncel id alanını kullan.