აპის შექმნა
- 1PostNimbo-ში გახსენით პარამეტრები > აპები და შექმენით OAuth აპი სახელით, აღწერით, სურათითა და გადამისამართების მისამართით.
- 2დააკოპირეთ client id და client secret. secret შეინახეთ თქვენს სერვერზე; თუ გაჟონა, იმავე გვერდიდან შეცვალეთ.
ავტორიზაციის კოდის ნაკადი
გადაიყვანეთ წევრი თანხმობის ეკრანზე თქვენი client id-ით, გადამისამართების მისამართით, state მნიშვნელობით და PKCE S256 challenge-ით, რომელიც რეკომენდებულია ყველა აპისთვის და სავალდებულოა აპებისთვის, რომლებსაც საიდუმლოს შენახვა არ შეუძლიათ.
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 სათაურში. ის მუშაობს მანამ, სანამ წევრი თქვენს აპს არ გააუქმებს; შეინახეთ დაშიფრული სახით.
Scope-ები
მოითხოვეთ მხოლოდ ის, რასაც თქვენი აპი იყენებს. თანხმობის ეკრანი თითოეულს ამ სიტყვებით ჩამოთვლის. თუ არცერთს არ მოითხოვთ, ტოკენი სრულ წვდომას იღებს, ამიტომ scope-ები ჯობია.
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
რისი გაკეთება შეუძლია ტოკენს
- ის მოქმედებს იმ წევრის სახელით, ვინც დაამტკიცა: მხოლოდ მისი ბრენდები და არხები და არხების ის დონეები, რაც სამუშაო სივრცემ მას მისცა.
- როცა სამუშაო სივრცე დამტკიცებას ითხოვს, ტოკენით დაგეგმილი პოსტები დამმტკიცებლებს ისევე ელოდება, როგორც წევრის საკუთარი.
- scope-ების გარეთ მყოფი მარშრუტი 403-ს აბრუნებს. მეტი წვდომისთვის სთხოვეთ წევრს ხელახლა შესვლა.
