Buat aplikasinya
- 1Di PostNimbo, buka Settings > Apps dan buat aplikasi OAuth dengan nama, deskripsi, gambar, dan alamat redirect-nya.
- 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.
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:
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"
}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 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
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.
