BetakuryeGeliştirici

Başlarken

Kimlik doğrulama

OAuth 2.0 client_credentials: kimliğinizle 30 dakikalık erişim jetonu alır, her istekte Bearer olarak gönderirsiniz.

Jeton almak

POST /oauth/token, gövde JSON (Content-Type: application/json).

AlanTürAçıklama
grant_typezorunlustringclient_credentials
client_idzorunlustringBetakurye'nin verdiği kimlik
client_secretzorunlustringKimliğin sırrı; yalnız sunucunuzda tutun
curl
curl -X POST https://betakurye.com/oauth/token \
  -H "Content-Type: application/json" \
  -d '{"grant_type":"client_credentials","client_id":"bk_xxxxxxxxxxxx","client_secret":"…"}'
Yanıt · 200
{
  "access_token": "eyJhbGciOiJIUzI1NiJ9…",
  "token_type": "Bearer",
  "expires_in": 1800
}
Hatalı kimlik · 401
{
  "error": {
    "code": "invalid_client",
    "message": "client_id ya da client_secret hatalı"
  }
}

Jetonu kullanmak

Başlık
Authorization: Bearer eyJhbGciOiJIUzI1NiJ9…
  • Jeton 30 dakika geçerlidir. Süresine 1–2 dakika kala yenisini alın ya da 401 aldığınızda bir kez yenileyip isteği tekrarlayın.
  • Yenileme jetonu yoktur; yeni jeton için aynı isteği yaparsınız.
  • Jeton isteği dakikada 30 ile sınırlıdır: jetonu her istekte değil, süresi boyunca bellekte saklayıp kullanın.

Ne görürsünüz

Kimliğiniz yalnız kendi bağladığınız restoranları ve onların siparişlerini görür. Başka bir entegratörün siparişi kimliği bilinse de 404 döner. Restoran kurye firmasından eşleme koduyla bağlandığı için hangi firmanın kuryesinin gideceğine restoran karar verir.