API Platformu

Kimlik Doğrulama

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

Ürün sayfası: API Platform.

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.

Header	Type	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.

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.

API Erişim sayfasını açın
Kontrol panelinizde API Erişim sayfasına gidin.
API kullanıcısı oluşturun
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.
Bilgileri kopyalayı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:

HTTP	Kod	Anlamı
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.

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

Son güncelleme: 2026-08-22