مواد پر جائیں
ڈویلپرز

OAuth ایپس

دوسرے PostNimbo صارفین کو اپنی پروڈکٹ کنیکٹ کرنے دیں۔ وہ سائن اِن کرتے ہیں، دیکھتے ہیں کہ آپ کیا مانگ رہے ہیں، اسے منظور کرتے ہیں، اور Settings > Apps میں کسی بھی وقت رسائی واپس لے سکتے ہیں۔

ایپ بنائیں

  1. 1PostNimbo میں Settings > Apps کھولیں اور نام، تفصیل، تصویر اور ری ڈائریکٹ ایڈریس کے ساتھ ایک OAuth ایپ بنائیں۔
  2. 2کلائنٹ id اور کلائنٹ سیکرٹ کاپی کریں۔ سیکرٹ اپنے سرور پر رکھیں؛ اگر لیک ہو جائے تو اسی پیج سے اسے بدل دیں۔

آتھرائزیشن کوڈ فلو

ممبر کو اپنی کلائنٹ id، ری ڈائریکٹ ایڈریس، ایک 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"
}

ایکسیس ٹوکن REST API کے Authorization ہیڈر میں بھیجیں۔ یہ تب تک کام کرتا ہے جب تک ممبر آپ کی ایپ کی رسائی واپس نہ لے لے؛ اسے انکرپٹ کر کے محفوظ کریں۔

اسکوپس

صرف وہی مانگیں جو آپ کی ایپ استعمال کرتی ہے۔ کنسینٹ اسکرین ہر ایک کو انہی الفاظ میں دکھاتی ہے۔ کوئی اسکوپ نہ مانگنے سے ٹوکن کو مکمل رسائی مل جاتی ہے، اس لیے اسکوپس کو ترجیح دیں۔

  • 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 میں مدد کرتے ہیں، ڈائریکٹری کے لیے ایپس کا جائزہ لیتے ہیں اور انٹیگریشنز کو درکار اینڈ پوائنٹس شامل کرتے ہیں۔