सीधे कॉन्टेंट पर जाएं
डेवलपर

OAuth ऐप

दूसरे PostNimbo यूज़र्स को अपना प्रोडक्ट कनेक्ट करने दें। वे साइन इन करते हैं, देखते हैं कि आप क्या मांग रहे हैं, उसे मंज़ूरी देते हैं, और Settings > Apps में कभी भी ऐक्सेस वापस ले सकते हैं।

ऐप बनाएं

  1. 1PostNimbo में Settings > Apps खोलें और नाम, विवरण, तस्वीर और रीडायरेक्ट पते के साथ एक OAuth ऐप बनाएं।
  2. 2क्लाइंट id और क्लाइंट सीक्रेट कॉपी करें। सीक्रेट अपने सर्वर पर रखें; लीक हो जाए तो उसी पेज से बदल दें।

ऑथराइज़ेशन कोड फ़्लो

मेंबर को अपने क्लाइंट id, रीडायरेक्ट पते, एक state वैल्यू और PKCE S256 चैलेंज के साथ सहमति स्क्रीन पर भेजें। PKCE हर ऐप के लिए सुझाया जाता है और उन ऐप के लिए ज़रूरी है जो सीक्रेट सुरक्षित नहीं रख सकते।

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 में मदद करते हैं, डायरेक्टरी के लिए ऐप रिव्यू करते हैं और इंटीग्रेशन के लिए ज़रूरी एंडपॉइंट जोड़ते हैं।