التخطي إلى المحتوى
المطوّرون

تطبيقات OAuth

اسمح لمستخدمي PostNimbo الآخرين بربط منتجك. يسجّلون الدخول، ويرون ما تطلبه، ويوافقون عليه، ويمكنهم إلغاؤه في أي وقت من Settings > Apps.

أنشئ التطبيق

  1. 1في PostNimbo افتح Settings > Apps وأنشئ تطبيق OAuth باسمه ووصفه وصورته وعنوان إعادة التوجيه.
  2. 2انسخ معرّف العميل (client id) والسر (client secret). احتفظ بالسر على خادمك، وجدّده من الصفحة نفسها إذا تسرّب.

مسار رمز التفويض

أرسل العضو إلى شاشة الموافقة مع معرّف العميل وعنوان إعادة التوجيه وقيمة state، ومعها تحدٍّ PKCE S256، وهو موصى به لكل تطبيق وإلزامي للتطبيقات التي لا تستطيع الاحتفاظ بسرّ.

1. افتح شاشة الموافقة
https://postnimbo.com/oauth/authorize
  ?client_id=<client id>
  &response_type=code
  &redirect_uri=<your redirect address>
  &state=<random value>
  &code_challenge=<base64url(sha256(verifier))>
  &code_challenge_method=S256
  &scope=posts:read posts:schedule

بعد الموافقة، يعيد PostNimbo التوجيه إلى عنوانك مع code وstate. تحقّق من state، ثم استبدل code خلال بضع دقائق:

2. استبدل الـ code
curl -X POST https://postnimbo.com/api/oauth/token \
  -d grant_type=authorization_code \
  -d code=<code> \
  -d client_id=<client id> \
  -d client_secret=<client secret> \
  -d code_verifier=<verifier> \
  -d redirect_uri=<your redirect address>
3. الإجابة
{
  "access_token": "pos_…",
  "token_type": "bearer",
  "scope": "posts:read posts:schedule"
}

أرسل رمز الوصول في ترويسة Authorization لواجهة REST API. يظل يعمل حتى يُلغي العضو تطبيقك؛ خزّنه مشفّرًا.

النطاقات

اطلب فقط ما يستخدمه تطبيقك. تعرض شاشة الموافقة كل نطاق بهذه الكلمات. عدم طلب أي نطاق يمنح الرمز وصولًا كاملًا، لذا فضّل استخدام النطاقات.

  • ideas:writeSave ideas to your Ideas board, and remove ideas you saved (Undo)
  • media:writeAdd images to your media library
  • posts:readSee your brands, channels, scheduled posts and the posts waiting for approval
  • posts:scheduleSchedule posts to your channels (when your workspace asks for approval, your approvers get them first)
  • ai:useWrite drafts with PostNimbo AI, within your plan's AI features
  • link-in-bio:writeAdd links to your link-in-bio pages
  • analytics:readSee a summary of your analytics
  • inbox:readSee how many inbox conversations are unread
  • webhooks:writeSend an event to an address you choose (like Zapier, Make or n8n) when a post is published, a flow captures a lead (with its email or phone number) or a flow is completed

ما يمكن للرمز فعله

  • يعمل باسم العضو الذي وافق عليه: علاماته التجارية وقنواته فقط، ومستويات القنوات التي منحته إياها مساحة العمل.
  • عندما تتطلب مساحة العمل موافقة، تنتظر المنشورات التي يجدولها المعتمِدين تمامًا مثل منشورات العضو نفسه.
  • المسار الواقع خارج نطاقاته يُرجع 403. اطلب من العضو تسجيل الدخول مجددًا لمنح المزيد.

هل تبني شيئًا باستخدام PostNimbo؟

أخبرنا بما تعمل عليه. نساعدك في الـ API، ونراجع التطبيقات لإدراجها في الدليل، ونضيف نقاط النهاية التي تحتاجها عمليات التكامل.