ऐप बनाएं
- 1PostNimbo में Settings > Apps खोलें और नाम, विवरण, तस्वीर और रीडायरेक्ट पते के साथ एक OAuth ऐप बनाएं।
- 2क्लाइंट id और क्लाइंट सीक्रेट कॉपी करें। सीक्रेट अपने सर्वर पर रखें; लीक हो जाए तो उसी पेज से बदल दें।
ऑथराइज़ेशन कोड फ़्लो
मेंबर को अपने क्लाइंट id, रीडायरेक्ट पते, एक state वैल्यू और PKCE S256 चैलेंज के साथ सहमति स्क्रीन पर भेजें। PKCE हर ऐप के लिए सुझाया जाता है और उन ऐप के लिए ज़रूरी है जो सीक्रेट सुरक्षित नहीं रख सकते।
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 एक्सचेंज करें:
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>
{
"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 libraryposts:readSee your brands, channels, scheduled posts and the posts waiting for approvalposts: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 featureslink-in-bio:writeAdd links to your link-in-bio pagesanalytics:readSee a summary of your analyticsinbox:readSee how many inbox conversations are unreadwebhooks: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 देता है। ज़्यादा ऐक्सेस के लिए मेंबर से दोबारा साइन इन करने को कहें।
