Releasesv0.1.0
Api referenceEndpointsAdmin

One provider and how it stands (instance admin)

GET
/v1/admin/providers/{provider}

Authorization

tenantKey
headerAuthorizationBearer <token>

Tenant API key, ohs_sk_ + 43 base62 characters.

Path Parameters

provider*string

Connector slug, see GET /v1/providers.

Header Parameters

Authorization*string

The tenant API key, as a bearer secret.

Response Body

The provider.

application/json
  1. response
slug*string
name*string
kinds*array<>
status*string

active runs; off was turned off; not_configured lacks a required key; error has keys the provider's rules refuse (see error); built_in needs no key and is always on.

Value in"active""off""not_configured""error""built_in"
enabled*boolean
source*|

Where the keys come from. Environment variables win over the console as a whole.

Value in"env""console"null
keys*array<>
error*string|null
urls*

The addresses to register in the provider's developer portal.

updated_at*|
Formatdate-time
updated_by*|

The id of the API key that saved the last change.

curl -X GET 'http://localhost:8080/v1/admin/providers/withings' \  -H 'Authorization: Bearer ohs_sk_...'
{  "slug": "string",  "name": "string",  "kinds": [    "oauth"  ],  "status": "active",  "enabled": true,  "source": "env",  "keys": [    {      "name": "CLIENT_ID",      "env": "OHS_OURA_CLIENT_ID",      "required": true,      "secret": true,      "set": true,      "value": "string"    }  ],  "error": "string",  "urls": {    "redirect": "string",    "inbound": "string"  },  "updated_at": "2019-08-24T14:15:22Z",  "updated_by": "string"}
Edit on GitHub