احراز هویت

اولین قدم برای اتصال به api‌های پذیرش۲۴، پیاده‌سازی دریافت access_token در ابزارک شماست. بدین منظور ابتدا ابزارک خود را بسازید و پس از آن با انجام مراحل پایین دسترسی‌های لازم را از او بگیرید و سپس می‌توانید به عنوان وکیل کاربر به منابع تحت مالکیت او دسترسی داشته باشید.

پیش‌نیازها

• ساخت ابزارک در همدست (opens in a new tab)
• تعیین دسترسی ها لازم ابزارک در تنظیمات همدست
• SDK همدست را در فرانت‌اند لود کرده‌اید.
• app_key اپ را در initialize ست کرده‌اید.
• x-api-key را در بک‌اند خود نگهداری می‌کنید.

دریافت دسترسی

window.hamdast.initialize({ app_key: "YOUR_APP_KEY" });
 
const sessionToken = await window.hamdast.getSessionToken({
  scope: ["provider.profile.read"],
});

POST https://hamdast.paziresh24.com/api/v1/apps/{app_key}/oauth/access_token

curl --request POST "https://hamdast.paziresh24.com/api/v1/apps/YOUR_APP_KEY/oauth/access_token" \
  --header "Content-Type: application/json" \
  --header "x-api-key: YOUR_DEVELOPER_API_KEY" \
  --data '{
    "session_token": "SESSION_TOKEN_FROM_SDK"
  }'

{
  "access_token": "eyJ...",
  "token_type": "Bearer",
}

Authorization: Bearer {access_token}

خطاهای رایج

نکات امنیتی

• x-api-key را فقط در بک‌اند نگهداری کنید.
• تبدیل توکن را فقط در بک‌اند انجام دهید.
• توکن‌ها را در لاگ عمومی چاپ نکنید.