অ্যাপ তৈরি করুন
- 1PostNimbo-তে Settings > Apps খুলুন এবং নাম, বিবরণ, ছবি ও রিডাইরেক্ট ঠিকানা দিয়ে একটি OAuth অ্যাপ তৈরি করুন।
- 2client id ও client secret কপি করুন। সিক্রেটটি আপনার সার্ভারে রাখুন; ফাঁস হলে একই পেজ থেকে বদলে নিন।
অথরাইজেশন কোড ফ্লো
আপনার client 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। আরও অ্যাক্সেস দিতে সদস্যকে আবার সাইন ইন করতে বলুন।
