Tạo ứng dụng
- 1Trong PostNimbo, mở Cài đặt > Ứng dụng và tạo một ứng dụng OAuth với tên, mô tả, hình ảnh và địa chỉ chuyển hướng.
- 2Sao chép client id và client secret. Giữ secret trên máy chủ của bạn; nếu bị lộ, hãy đổi secret ngay trên trang đó.
Luồng mã ủy quyền (authorization code)
Đưa thành viên đến màn hình xin đồng ý kèm client id, địa chỉ chuyển hướng, giá trị state và một challenge PKCE S256, điều này được khuyến nghị cho mọi ứng dụng và bắt buộc với ứng dụng không thể giữ bí mật.
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
Sau khi họ chấp thuận, PostNimbo chuyển hướng về địa chỉ của bạn kèm code và state. Kiểm tra state, rồi đổi code trong vòng vài phút:
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"
}Gửi access token trong header Authorization của REST API. Token vẫn hoạt động cho đến khi thành viên thu hồi ứng dụng của bạn; hãy lưu token ở dạng mã hóa.
Scope
Chỉ yêu cầu những gì ứng dụng của bạn dùng. Màn hình xin đồng ý liệt kê từng scope bằng đúng những từ này. Không yêu cầu scope nào sẽ cho token toàn quyền, vì vậy nên dùng 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
Token có thể làm gì
- Token hoạt động với tư cách thành viên đã chấp thuận nó: chỉ thương hiệu và kênh của họ, cùng mức quyền trên kênh mà không gian làm việc đã cấp cho họ.
- Khi không gian làm việc yêu cầu phê duyệt, bài đăng do token lên lịch cũng chờ người phê duyệt như bài của chính thành viên đó.
- Route nằm ngoài scope sẽ trả về 403. Hãy nhờ thành viên đăng nhập lại để cấp thêm quyền.
