ابدأ خلال 5 خطوات

أنشئ حساباً

سجّل الدخول ببريدك الإلكتروني — يستخدم سما برايم رموزاً لمرة واحدة عبر البريد، بلا كلمة مرور لإدارتها.

أنشئ مفتاح API

افتح لوحة تحكم المطور وأنشئ مفتاح اختبار. سترى المفتاح الكامل مرة واحدة فقط — انسخه في مكان آمن.

أرسل أول طلب

استدعِ GET /v1/wallet بمفتاحك الجديد لقراءة رصيد محفظة حساب الاختبار.

curl -X GET "https://samaprime.com/api/v1/wallet" \
  -H "Authorization: Bearer sk_test_..." \
  -H "Content-Type: application/json"

تعامل مع الأخطاء

كل خطأ هو JSON منظّم بحقلي type/code ثابتين — ابنِ منطقك عليهما، لا على الرسالة المقروءة للبشر.

const res = await fetch(url, { headers });
const body = await res.json();
if (!res.ok) {
  // Branch on body.error.type / body.error.code — never on
  // body.error.message, which may change wording over time.
  if (body.error.type === "insufficient_balance") {
    // top up and retry
  } else if (body.error.type === "rate_limited") {
    // back off and retry after Retry-After
  }
  throw new Error(body.error.code);
}
console.log(body.data);

أعدّ الـ Webhooks

سجّل رابطاً حتى يعرف تكاملك بأحداث الطلبات والإيداعات فور حدوثها، بدلاً من الاستعلام المتكرر.