heroku-client
Version:
A wrapper for the Heroku v3 API
109 lines (65 loc) • 2.1 kB
Markdown
OAuth clients are applications that Heroku users can authorize to automate, customize or extend their usage of the platform. For more information please refer to the [Heroku OAuth documentation](https://devcenter.heroku.com/articles/oauth)
`heroku.oauth().clients().create({attributes}, {callback});`
Method | Path | Expected Status(es)
--- | --- | ---
POST | /oauth/clients | 201
#### Required Attributes
- name
- redirect_uri
### `list`
`heroku.oauth().clients().list({callback});`
Method | Path | Expected Status(es)
--- | --- | ---
GET | /oauth/clients | 200, 206
### `info`
`heroku.oauth().clients({client_id}).info({callback});`
Method | Path | Expected Status(es)
--- | --- | ---
GET | /oauth/clients/{client_id} | 200
`heroku.oauth().clients({client_id}).update({attributes}, {callback});`
Method | Path | Expected Status(es)
--- | --- | ---
PATCH | /oauth/clients/{client_id} | 200
- name
- redirect_uri
`heroku.oauth().clients({client_id}).delete({callback});`
Method | Path | Expected Status(es)
--- | --- | ---
DELETE | /oauth/clients/{client_id} | 200
*When oauth client was created.*
Example | Serialized? | Type
--- | --- | ---
`2012-01-01T12:00:00Z` | true | datetime
*Unique identifier of this oauth client.*
Example | Serialized? | Type
--- | --- | ---
`01234567-89ab-cdef-0123-456789abcdef` | true | uuid
*Oauth client name.*
Example | Serialized? | Type
--- | --- | ---
`example` | true | string
*Endpoint for redirection after authorization with oauth client.*
Example | Serialized? | Type
--- | --- | ---
`https://example.com/auth/heroku/callback` | true | string
*Secret used to obtain oauth authorizations under this client.*
Example | Serialized? | Type
--- | --- | ---
`01234567-89ab-cdef-0123-456789abcdef` | true | string
*When oauth client was updated.*
Example | Serialized? | Type
--- | --- | ---
`2012-01-01T12:00:00Z` | true | datetime