Developers
Build apps that act for members who allow them: read their profile and friends, read and publish posts.
How it works
- Create an app below and keep its secret safe; it is shown once.
- Send the member to this page; they choose to allow or deny:
https://karyty.com/oauth/authorize?client_id=CLIENT_ID&redirect_uri=REDIRECT_URI&response_type=code&scope=profile+friends+posts_read+posts_write&state=RANDOM - Swap the one-time code (valid 10 minutes) for an access token:
POST https://karyty.com/api/oauth/token grant_type=authorization_code&client_id=โฆ&client_secret=โฆ&code=โฆ&redirect_uri=โฆ - Call the API with the token in a header:
Authorization: Bearer ACCESS_TOKEN
| Endpoint | Permission | What it does |
|---|---|---|
GET /api/v1/me | profile | The member's profile |
GET /api/v1/me/friends | friends | Their friends |
GET /api/v1/me/posts | posts_read | Their latest posts |
POST /api/v1/posts | posts_write | Publish a text post for them |
Each app has a requests-per-minute limit set by the site team. Members can revoke access any time in Settings โบ Connected apps.
