Auth

Core Resources · 3 endpoints

POST/v1/auth/device/code

Create Device Authorization

public_device_authorization

Request body · application/json

Field	Type	Required	Description
`client_name`	`string`	optional

Returns · 200

Field	Type	Required
`data`	`DeviceAuthorizationCreateResponse`	required
`data.device_code`	`string`	required
`data.expires_in`	`integer`	required
`data.interval`	`integer`	required

Loading documentation...

data.object

cURL

curl https://api.getmeonline.io/v1/auth/device/code \
  -X POST \
  -H "Authorization: Bearer $GETME_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "client_name": "client_name"
  }'

POST/v1/auth/device/token

Poll Device Authorization

public_device_authorization

Request body · application/json

Field	Type	Required	Description
`device_code`	`string`	required

Returns · 200

Field	Type	Required	Description
`data`	`DeviceAuthorizationTokenResponse`	required
`data.error`	`string`	optional
`data.interval`	`integer`	required
`data.object`	`string`	optional	device_authorization_token
`data.profile_hint`	`string`	optional
`data.raw_key`	`string`	optional
`data.status`	`string`	required
`success`	`boolean`	required	true

Errors 400401403404409422429500

cURL

curl https://api.getmeonline.io/v1/auth/device/token \
  -X POST \
  -H "Authorization: Bearer $GETME_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "device_code": "device_code"
  }'

GET/v1/auth/status

Auth Status

app_install_bearer

Returns · 200

Field	Type	Required	Description
`data`	`DeveloperAuthStatusObject`	required
`data.app`	`string`	optional	Developer app public identifier for app-install tokens.
`data.app_install`	`string`	optional	App install public identifier for app-install tokens.
`data.authenticated`	`boolean`	optional
`data.company`	`string`	optional	Company public identifier for the token scope.
`data.credential_type`	`string`	required
`data.environment`	`string`	required
`data.id`	`string`	required	API key public identifier.
`data.name`	`string`	optional
`data.object`	`string`	optional	developer_auth_status
`data.rate_limit`	`integer`	required
`data.scopes`	`string[]`	optional
`success`	`boolean`	required	true

Errors 400401403404409422429500

cURL

curl https://api.getmeonline.io/v1/auth/status \
  -H "Authorization: Bearer $GETME_API_KEY"