Kimlik doğrulama

Anahtarlar, token ve güvenli saklama

API, iki anahtarla alınan kısa ömürlü bir Bearer token kullanır. Anahtarlar yalnız giriş isteğinde gönderilir; diğer tüm isteklerde token kullanılır.

Giriş

POST https://www.aloyemek.com/aloapi/v1/auth/login
Content-Type: application/json

{
  "appSecretKey": "ayk_app_2f6c…",
  "restaurantSecretKey": "ayk_rst_6fa7…"
}

{
  "success": true,
  "data": {
    "token": "9f1c2b7e…",
    "tokenType": "Bearer",
    "expiresAt": "2026-09-18T17:19:13+03:00",
    "expiresIn": 86400,
    "restaurantId": "0b484214-4740-407b-b3ec-d3987e6f1bb4",
    "scopes": ["restaurant", "menu", "orders", "reports"]
  }
}

Token kullanımı

GET https://www.aloyemek.com/aloapi/v1/orders/active
Authorization: Bearer 9f1c2b7e…

Token 24 saat geçerlidir. Süre dolmadan yenilemek zorunda değilsiniz; 401 TOKEN_EXPIRED veya 401 UNAUTHORIZED aldığınızda tekrar giriş yapıp isteği yineleyin.
Her istekte yeni token almayın; token'ı restoran bazında önbellekte tutun. Bir bağlantı için aynı anda en fazla 20 geçerli token saklanır.
Authorization başlığını gönderemeyen ortamlarda X-Api-Token: <token> başlığı da kabul edilir.

Token ne zaman geçersiz olur?

Durum	Hata kodu	Yapmanız gereken
24 saat doldu	`TOKEN_EXPIRED`	Tekrar giriş yapın
Restoran anahtarını yeniledi	`UNAUTHORIZED` → girişte `INVALID_CREDENTIALS`	Restorandan yeni anahtarı isteyin
Restoran bağlantıyı kaldırdı	`CONNECTION_REVOKED`	Restoranın entegrasyonunu pasifleştirin
Firma uygulama anahtarı yenilendi	`INVALID_CREDENTIALS`	Yeni appSecretKey'i sunucunuza girin
Firma askıya alındı	`INTEGRATOR_SUSPENDED`	AloYemek ile iletişime geçin

Anahtarları güvenle saklayın

appSecretKey yalnız sunucunuzda (ortam değişkeni veya gizli anahtar kasası) durmalı; kaynak koduna, mobil uygulamaya veya restoranın bilgisayarındaki kuruluma koymayın.
AloYemek anahtarların yalnız SHA-256 özetini saklar; biz de anahtarınızı göremeyiz. Kaybederseniz yenisi oluşturulur ve eskisi hemen geçersiz olur.
Tüm istekler HTTPS üzerinden yapılmalıdır.

Sorunuz mu var? destek@aloyemek.com