Kimlik Doğrulama

Başlık tabanlı kimlik bilgilerini kullanarak API isteklerinizi nasıl doğrulayacağınızı öğrenin.

Kimlik Doğrulama Nasıl Çalışır

Semust API, başlık tabanlı kimlik doğrulama kullanır. Her istek, API kullanıcı kimlik bilgilerinizle iki özel başlık içermelidir.

Başlık	Tür	Açıklama
`SEMUST-API-USER`	string	API kullanıcınızın kullanıcı adı
`SEMUST-API-PASSWORD`	string	API kullanıcınızın şifresi

Her istekte her iki başlık da gereklidir. Herhangi biri eksik veya yanlışsa, API bir

401

hatası döndürür.

İstek Başlıkları

SEMUST-API-USER: your_username
SEMUST-API-PASSWORD: your_password

API Kullanıcıları Oluşturma

API istekleri, API kullanıcıları kullanılarak doğrulanır. Her API kullanıcısının, isteklerinizde başlık olarak eklediğiniz kendi kullanıcı adı ve şifresi vardır.

Kontrol panelinizde API Erişim sayfasına gidin.

Benzersiz bir kullanıcı adı ve şifre ile yeni bir API kullanıcısı oluşturmak için "API Kullanıcısı Oluştur" 'a tıklayın.

Kullanıcı adı ve şifreyi kopyalayın. Bu değerleri API isteklerinizde SEMUST-API-USER ve SEMUST-API-PASSWORD başlıkları olarak kullanın.

Farklı uygulamalar veya ortamlar arasında kullanımı ayırmak için birden fazla API kullanıcısı oluşturabilirsiniz.

Güvenlik: API kullanıcı kimlik bilgilerinizi asla istemci tarafı kodunda, genel depolarda veya tarayıcı isteklerinde açığa çıkarmayın. API çağrılarını her zaman sunucunuzdan yapın.

Kimlik Doğrulama Hataları

Kimlik doğrulama başarısız olursa, API HTTP

401

ile aşağıdaki hatayı döndürür:

Durum	Kod	Açıklama
401	`INVALID_API_KEY`	Kimlik doğrulama başarısız — geçersiz kullanıcı adı veya şifre

Her ikisinin de SEMUST-API-USER ve SEMUST-API-PASSWORD başlıklarının mevcut ve doğru olduğunu kontrol edin. Kimlik bilgilerinizi API Erişim sayfasında doğrulayabilirsiniz.

Hata Yanıtı

{
  "error": "Authentication failed — invalid username or password",
  "code": "INVALID_API_KEY"
}