المصادقة

عنوان الـ API وصيغته، وكيف يثبت برنامجك هويته.

العنوان

كل الطلبات تُرسل إلى:

https://api.wa.goupdev.net/v1

v1 هو إصدار الـ API. إذا احتجنا يومًا إلى تغيير يكسر برنامجك فسننشره باسم v2 ونُبقي v1 يعمل.

الطلبات والردود بصيغة JSON. أرسل الترويسة Content-Type: application/json مع كل طلب له محتوى.

كل رد بخطأ له الشكل نفسه:

{ "error": "Device not found" }

راجع الأخطاء للقائمة الكاملة.

أنشئ مفتاح API من لوحة التحكم (راجع مفاتيح API) وأرسله في الترويسة Authorization مع كل طلب:

Authorization: Bearer YOUR_API_KEY

المفتاح يحدد المؤسسة التي تعمل عليها، فلا ترى ولا تغيّر إلا أجهزتها ورسائلها والويب هوك الخاص بها.

curl https://api.wa.goupdev.net/v1/devices \
  -H "Authorization: Bearer YOUR_API_KEY"

الرد	السبب
`401 {"error": "Missing or invalid Authorization header"}`	الترويسة مفقودة، أو لا تبدأ بـ `Bearer` .
`401 {"error": "Invalid API key"}`	المفتاح خاطئ أو أُلغي.

استدعِ الـ API من خادمك فقط. من يرى مفتاحك يستطيع إرسال الرسائل باسمك.