İçeriğe geç
Geliştiriciler

OAuth uygulamaları

Diğer PostNimbo kullanıcılarının ürününüzü bağlamasına izin verin. Giriş yapar, ne istediğinizi görür, onaylar ve istedikleri zaman Settings > Apps altından iptal edebilirler.

Uygulamayı oluşturun

  1. 1PostNimbo'da Settings > Apps bölümünü açın ve adı, açıklaması, görseli ve yönlendirme adresiyle bir OAuth uygulaması oluşturun.
  2. 2Client id ve client secret değerlerini kopyalayın. Secret'ı sunucunuzda tutun; sızarsa aynı sayfadan yenileyin.

Yetkilendirme kodu akışı

Üyeyi client id'niz, yönlendirme adresi, bir state değeri ve bir PKCE S256 challenge ile onay ekranına gönderin. PKCE her uygulama için önerilir, secret saklayamayan uygulamalar için zorunludur.

1. Onay ekranını açın
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

Onayladıktan sonra PostNimbo, code ve state ile adresinize yönlendirir. State'i kontrol edin, ardından kodu birkaç dakika içinde takas edin:

2. Kodu takas edin
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. Yanıt
{
  "access_token": "pos_…",
  "token_type": "bearer",
  "scope": "posts:read posts:schedule"
}

Erişim token'ını REST API'nin Authorization başlığında gönderin. Üye uygulamanızın erişimini iptal edene kadar çalışmaya devam eder; şifrelenmiş olarak saklayın.

Kapsamlar

Yalnızca uygulamanızın kullandıklarını isteyin. Onay ekranı her birini bu ifadelerle listeler. Hiçbirini istememek token'a tam erişim verir, bu yüzden kapsam belirtmeyi tercih edin.

  • 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

Token neler yapabilir

  • Onu onaylayan üye adına işlem yapar: yalnızca o üyenin markaları ve kanalları ile çalışma alanının ona verdiği kanal yetki düzeyleri.
  • Çalışma alanı onay istediğinde, token'ın planladığı gönderiler de üyenin kendi gönderileri gibi onaylayıcıları bekler.
  • Kapsamları dışındaki bir rota 403 döndürür. Daha fazla izin vermesi için üyeden yeniden giriş yapmasını isteyin.

PostNimbo ile bir şey mi geliştiriyorsunuz?

Ne yaptığınızı bize anlatın. API konusunda yardımcı oluyor, dizin için uygulamaları inceliyor ve entegrasyonların ihtiyaç duyduğu uç noktaları ekliyoruz.