انتقل إلى المحتوى الرئيسي

ابدأ مع Ithbat IAM

أضف المصادقة لتطبيقك في دقائق.

الخطوة 1 — التثبيت​

npm install @ithbatiam/sdk

الخطوة 2 — التهيئة​

import { IthbatSDK } from "@ithbatiam/sdk"

const sdk = new IthbatSDK({
  basePath: "https://api.ithbat.io/api/v1",
  tenantId: "YOUR_TENANT_ID"
})

الخطوة 3 — تسجيل الدخول​

const result = await sdk.auth.login({
  email: "[email protected]",
  password: "your-password"
})

if (result.mfaRequired) {
  const mfaResult = await sdk.auth.verifyMfa({
    mfaToken: result.mfaToken,
    code: "123456"
  })
  sdk.setAccessToken(mfaResult.accessToken)
} else {
  sdk.setAccessToken(result.accessToken)
}

إذا كانت MFA مفعّلة، result.accessToken يكون undefined والـ Response يحتوي mfaRequired: true و mfaToken. مرّر الـ mfaToken مع رمز TOTP لـ auth.verifyMfa() لإكمال تسجيل الدخول.

الخطوة 4 — استخدام الـ API​

const result = await sdk.users.listUsers()
console.log(result.items)        // User[]
console.log(result.totalItems)   // total count

listUsers() ترجع PagedResult<User> مع .items (مصفوفة المستخدمين) و .totalItems (العدد الإجمالي عبر كل الصفحات).

تم​

الآن لديك مصادقة تعمل في تطبيقك.

ما الذي تبنيه بعد ذلك​

متى تستخدم كل طريقة دمج​

طريقة الدمجالأنسب لـ
SDKتطبيقات الـ Frontend والـ Node.js
REST APIخدمات الـ Backend، أي لغة برمجة

API Base URL​

https://api.ithbat.io/api/v1

الـ Headers المطلوبة في كل Protected Request:

Headerالقيمة
AuthorizationBearer <access_token>
X-Tenant-ID<tenant_id>

تحتاج مساعدة؟​