მთავარ შინაარსზე გადასვლა
დეველოპერები

OAuth აპები

მიეცით PostNimbo-ს სხვა მომხმარებლებს თქვენი პროდუქტის დაკავშირების საშუალება. ისინი შედიან, ხედავენ, რას ითხოვთ, ამტკიცებენ და ნებისმიერ დროს შეუძლიათ გაუქმება გვერდზე პარამეტრები > აპები.

აპის შექმნა

  1. 1PostNimbo-ში გახსენით პარამეტრები > აპები და შექმენით OAuth აპი სახელით, აღწერით, სურათითა და გადამისამართების მისამართით.
  2. 2დააკოპირეთ client id და client secret. secret შეინახეთ თქვენს სერვერზე; თუ გაჟონა, იმავე გვერდიდან შეცვალეთ.

ავტორიზაციის კოდის ნაკადი

გადაიყვანეთ წევრი თანხმობის ეკრანზე თქვენი client id-ით, გადამისამართების მისამართით, state მნიშვნელობით და PKCE S256 challenge-ით, რომელიც რეკომენდებულია ყველა აპისთვის და სავალდებულოა აპებისთვის, რომლებსაც საიდუმლოს შენახვა არ შეუძლიათ.

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 სათაურში. ის მუშაობს მანამ, სანამ წევრი თქვენს აპს არ გააუქმებს; შეინახეთ დაშიფრული სახით.

Scope-ები

მოითხოვეთ მხოლოდ ის, რასაც თქვენი აპი იყენებს. თანხმობის ეკრანი თითოეულს ამ სიტყვებით ჩამოთვლის. თუ არცერთს არ მოითხოვთ, ტოკენი სრულ წვდომას იღებს, ამიტომ scope-ები ჯობია.

  • 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

რისი გაკეთება შეუძლია ტოკენს

  • ის მოქმედებს იმ წევრის სახელით, ვინც დაამტკიცა: მხოლოდ მისი ბრენდები და არხები და არხების ის დონეები, რაც სამუშაო სივრცემ მას მისცა.
  • როცა სამუშაო სივრცე დამტკიცებას ითხოვს, ტოკენით დაგეგმილი პოსტები დამმტკიცებლებს ისევე ელოდება, როგორც წევრის საკუთარი.
  • scope-ების გარეთ მყოფი მარშრუტი 403-ს აბრუნებს. მეტი წვდომისთვის სთხოვეთ წევრს ხელახლა შესვლა.

PostNimbo-ზე რამეს ქმნით?

გვითხარით, რას აკეთებთ. გეხმარებით API-ში, ვამოწმებთ აპებს კატალოგისთვის და ვამატებთ endpoint-ებს, რომლებიც ინტეგრაციებს სჭირდება.