Kimlik doğrulama

Atlas API’si Bearer belirteci kullanır. Her isteğe bir Authorization başlığı eklersiniz; başlık yoksa veya geçersizse yanıt 401 olur.

curl https://api.atlas.example/v1/users \
  -H "Authorization: Bearer atl_live_••••••••"

Anahtar üretme

Panelde Ayarlar → Anahtarlar → Yeni anahtar yolunu izleyin. İki tür anahtar vardır:

• atl_live_ — Üretim verisine erişir.
• atl_test_ — Yalıtılmış kum havuzuna erişir; gerçek e-posta göndermez, fatura oluşturmaz.

Anahtar yalnızca üretildiği anda tam hâliyle görüntülenir. Sonrasında panelde son dört karakteri görünür.

Belirteç ömrü

İstemci kimliği ve gizli anahtarla ürettiğiniz erişim belirteci 1 saat geçerlidir. Süre dolmadan yenileyin:

curl -X POST https://api.atlas.example/v1/auth/refresh \
  -H "Content-Type: application/json" \
  -d '{ "refresh_token": "rft_••••••••" }'

Yenileme sırasında eski belirteç anında geçersizleşir. İki isteği aynı anda yenilerseniz biri 401 alır — yenilemeyi tek bir noktadan yapın ve sonucu paylaşın.

Anahtarı saklama

Anahtar bir paroladır; koda gömmeyin, tarayıcıya göndermeyin.

// Yanlış — anahtar istemci paketine girer ve herkes görür
const res = await fetch('https://api.atlas.example/v1/users', {
  headers: { Authorization: 'Bearer atl_live_gercek_anahtar' },
});

// Doğru — istek kendi sunucunuzdan çıkar, anahtar ortam değişkeninde durur
export async function listUsers() {
  const res = await fetch('https://api.atlas.example/v1/users', {
    headers: { Authorization: `Bearer ${process.env.ATLAS_API_KEY}` },
  });
  if (!res.ok) throw new Error(`Atlas ${res.status}`);
  return res.json();
}

Anahtar sızdıysa

1. Panelden anahtarı iptal edin — iptal anında yürürlüğe girer.
2. Yeni anahtar üretip dağıtımlarınızı güncelleyin.
3. Ayarlar → Erişim günlüğü’nden anahtarın son 30 günlük kullanımını inceleyin.

İptal edilen anahtarla gelen istekler 401 ve invalid_key hata koduyla reddedilir.

Sırada ne var

İsteği imzaladıktan sonra webhookları kurabilir, hata yanıtlarını hata kodları sayfasından çözümleyebilirsiniz.