الواجهة البرمجية (REST)
مفاتيح API والنطاقات ونقاط النهاية في الإصدار v1 من واجهة ناشر البرمجية.
واجهة ناشر البرمجية متاحة في باقتَي الفِرق والوكالات. كل النقاط تحت https://api.naasher.com/api/sdk/v1، والتوثيق التفاعلي على api.naasher.com/docs.
المصادقة
أنشئ مفتاحًا من الإعدادات ← المطوّرون ← مفاتيح API، ثم أرسله في كل طلب:
curl https://api.naasher.com/api/sdk/v1/posts \
-H "x-naasher-api-key: $NAASHER_API_KEY"أو عبر ترويسة Authorization:
curl https://api.naasher.com/api/sdk/v1/posts \
-H "Authorization: Bearer $NAASHER_API_KEY"المفتاح يُعرض مرة واحدة
لا نحتفظ بالمفتاح كنص ظاهر — نخزّن بصمته فقط. إن فقدته أنشئ مفتاحًا جديدًا واحذف القديم.
النطاقات (Scopes)
امنح كل مفتاح أقل صلاحية يحتاجها:
| النطاق | يسمح بـ |
|---|---|
channels:read | قراءة الحسابات المتصلة |
posts:read | قراءة المنشورات |
posts:create | إنشاء منشور |
posts:schedule | جدولة منشور |
posts:delete | حذف منشور |
analytics:read | قراءة التحليلات |
webhooks:read | قراءة روابط الويب هوك |
webhooks:create | إنشاء رابط ويب هوك |
webhooks:delete | حذف رابط ويب هوك |
* | كل ما سبق |
نقاط النهاية
المنشورات
| الطريقة | المسار | الوصف |
|---|---|---|
GET | /posts | قائمة المنشورات مع ترقيم وفلاتر |
POST | /posts | إنشاء منشور (مسودة أو مجدول) |
GET | /posts/:id | تفاصيل منشور |
POST | /posts/:id/schedule | جدولة منشور موجود |
DELETE | /posts/:id | حذف منشور |
مثال — إنشاء منشور مجدول:
curl -X POST https://api.naasher.com/api/sdk/v1/posts \
-H "x-naasher-api-key: $NAASHER_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"body": "أطلقنا اليوم تحديثنا الجديد ☕️",
"channelIds": ["ch_123"],
"scheduledAt": "2026-08-01T08:30:00.000Z"
}'الحسابات
| الطريقة | المسار | الوصف |
|---|---|---|
GET | /channels | قائمة الحسابات المتصلة |
GET | /channels/:id | تفاصيل حساب |
التحليلات
| الطريقة | المسار | الوصف |
|---|---|---|
GET | /analytics | ملخّص الوصول والتفاعل والنمو |
الويب هوكس
| الطريقة | المسار | الوصف |
|---|---|---|
GET | /webhooks | قائمة الروابط |
POST | /webhooks | إنشاء رابط |
DELETE | /webhooks/:id | حذف رابط |
راجع صفحة الويب هوكس للتحقق من التوقيع.
الحدود والأخطاء
الطلبات محدودة المعدّل لكل عنوان IP. عند تجاوز الحد تحصل على 429 مع ترويسة Retry-After. الأخطاء تعود بشكل موحّد:
{ "error": { "code": "billing:feature_not_in_plan", "message": "API access is available on Teams and Agency." } }الرمز (code) ثابت وصالح للاعتماد عليه برمجيًا؛ النص (message) قد يتغير.