بدء سريع · المصادقة
الحصول على مفتاح API الخاص بك
كل طلب على واجهة Wasaas البرمجية يحتاج مفتاح API واحد. هذه الصفحة تغطي إنشاءه والتحقق من أنه يعمل فعليًا — في أقل من دقيقتين، وقبل أي محاولة لإرسال رسالة.
١. أنشئ المفتاح من لوحة التحكم
سجّل الدخول إلى لوحة التحكم، ثم اذهب إلى مفاتيح API واضغط إنشاء مفتاح جديد. المفتاح يبدأ دائمًا بـ wsa_، ويُعرض نصه الكامل مرة واحدة فقط لحظة الإنشاء — انسخه فورًا إلى متغير بيئة، فلا توجد طريقة لعرضه مرة أخرى بعد إغلاق الصفحة (تستطيع إنشاء مفتاح جديد إذا فقدته، لكن ليس استرجاع القديم).
WASAAS_API_KEY=wsa_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx٢. استخدمه في ترويسة Authorization
كل طلب REST API يحمل المفتاح في ترويسة Authorization بصيغة Bearer token. لا يوجد اسم مستخدم أو كلمة مرور ولا توقيع HMAC — المفتاح وحده هو بيانات الاعتماد:
Authorization: Bearer wsa_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx٣. تحقق أن المفتاح يعمل فعليًا
لا تنتظر حتى محاولة إرسال رسالة لتكتشف أن المفتاح خاطئ. نقطة GET /api/v1/sessions لا تستهلك أي حصة، فهي أرخص طريقة للتأكد:
curl https://wasaas.org/api/v1/sessions \
-H "Authorization: Bearer wsa_your_api_key"مفتاح صالح — حتى بدون أي جلسة واتساب متصلة بعد — يرجع مصفوفة (قد تكون فارغة):
[]مفتاح خاطئ أو ملغى يرجع:
{ "error": "Invalid API key" }برمز حالة 401. لا رسالة خطأ غامضة ولا إعادة توجيه — فقط 401 أو مصفوفة صالحة.
احتفظ بالمفتاح في مكان آمن
المفتاح يمنح وصولًا كاملًا لحساب واتساب المتصل: إرسال رسائل، قراءة سجل الجلسات، والتحقق من الأرقام. ضعه في متغير بيئة على السيرفر، ولا تضعه أبدًا في كود JavaScript من جهة العميل أو في مستودع عام. إذا تسرّب، احذفه من مفاتيح API وأنشئ مفتاحًا جديدًا فورًا — الحذف فوري ولا يحتاج انتظار دورة فوترة.
إلى أين تذهب بعد ذلك
- إرسال أول رسالة واتساب — الخطوة التالية بعد أن يصبح المفتاح جاهزًا
- بدء سريع: Node.js — نفس المفتاح من مكتبة wasaas الرسمية
- بدء سريع: Laravel وPHP — نفس المفتاح من حزمة Composer
- توثيق REST API: المصادقة (بالإنجليزية) — الترويسات المطلوبة وكل حالات الخطأ