Başlangıç

Kimlik doğrulama

Tüm istekler Bearer API anahtarıyla yapılır. Anahtarlar panelden oluşturulur ve iptal edilir.

Bearer anahtar

Anahtarı her istekte Authorization başlığıyla gönder. Anahtarlar odecik_sk_ ile başlar.

bash

Authorization: Bearer odecik_sk_xxxxxxxxxxxxxxxxxxxxxxxx

Anahtarın ham değeri saklanmaz; yalnızca özeti (SHA-256) tutulur. Bu yüzden kaybolan anahtar geri getirilemez — yenisini oluştur ve eskisini iptal et.

Yetkiler

Yetki	İzin verdikleri
`read`	Mağaza, bakiye, ürün, sipariş, müşteri, kupon ve webhook kayıtlarını okuma (`GET`).
`write`	Ürün/kupon/webhook oluşturma-güncelleme-silme, kargolama, iade, ödeme oturumu açma.

Gerekli yetkisi olmayan anahtar 403 insufficient_scope alır. Yalnızca ihtiyacın olan yetkiyi ver; raporlama için read yeterlidir.

Birden fazla mağaza

Anahtar hesaba bağlıdır. Varsayılan olarak hesabın ilk oluşturulan mağazası kullanılır. Başka bir mağazan için X-Odecik-Store başlığına mağaza slug'ını yaz:

bash

curl https://odecik.com/api/v1/orders \
  -H "Authorization: Bearer $ODECIK_API_KEY" \
  -H "X-Odecik-Store: ikinci-magazam"

Güvenlik önerileri

Anahtarı ortam değişkeninde tut; kaynak koda ve istemci tarafına koyma.
Her entegrasyon için ayrı anahtar oluştur; biri sızarsa yalnızca onu iptal edersin.
Anahtarın son kullanım zamanı panelde görünür; kullanılmayanları temizle.
İstekleri yalnızca HTTPS üzerinden yap.