Langsung ke konten
Developer

Aplikasi OAuth

Biarkan pengguna PostNimbo lain menghubungkan produk Anda. Mereka masuk, melihat apa yang Anda minta, menyetujuinya, dan dapat mencabutnya kapan saja di Settings > Apps.

Buat aplikasinya

  1. 1Di PostNimbo, buka Settings > Apps dan buat aplikasi OAuth dengan nama, deskripsi, gambar, dan alamat redirect-nya.
  2. 2Salin client id dan client secret. Simpan secret di server Anda; ganti dari halaman yang sama jika bocor.

Alur authorization code

Arahkan anggota ke layar persetujuan dengan client id Anda, alamat redirect, nilai state, dan challenge PKCE S256, yang disarankan untuk setiap aplikasi dan wajib untuk aplikasi yang tidak dapat menyimpan secret.

1. Buka layar persetujuan
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

Setelah mereka menyetujui, PostNimbo mengalihkan ke alamat Anda dengan code dan state. Periksa state, lalu tukarkan code dalam beberapa menit:

2. Tukarkan 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. Jawabannya
{
  "access_token": "pos_…",
  "token_type": "bearer",
  "scope": "posts:read posts:schedule"
}

Kirim token akses di header Authorization pada REST API. Token tetap berlaku sampai anggota mencabut aplikasi Anda; simpan dalam keadaan terenkripsi.

Scope

Minta hanya yang digunakan aplikasi Anda. Layar persetujuan mencantumkan masing-masing dengan kata-kata ini. Tidak meminta satu pun akan memberi token akses penuh, jadi sebaiknya gunakan 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

Apa yang bisa dilakukan token

  • Token bertindak sebagai anggota yang menyetujuinya: hanya brand dan saluran milik mereka, serta tingkat akses saluran yang diberikan workspace kepada mereka.
  • Saat workspace mewajibkan persetujuan, postingan yang dijadwalkan token menunggu pemberi persetujuan seperti postingan anggota itu sendiri.
  • Rute di luar scope-nya menghasilkan 403. Minta anggota untuk masuk lagi agar memberikan akses lebih.

Sedang membangun sesuatu dengan PostNimbo?

Ceritakan apa yang sedang Anda buat. Kami membantu soal API, meninjau aplikasi untuk direktori, dan menambahkan endpoint yang dibutuhkan integrasi.