platform

Embed
Preview of the card
<a href="https://hermeticor.com/docs/ref-platform"><img src="https://hermeticor.com/docs/_api/public/orgs/5fcd8b3c-a27c-4688-972f-de710125592f/spaces/caf5dc05-15f7-4e0c-bdb8-ab29ede6211e/pages/321b0769-f874-4137-9e26-67f97f7ed220/social-card.svg?v=3e7ae33eec8b" alt="platform" width="600" height="315"></a>
POSThttps://hermeticor.com/oauth/token

RFC 6749 token endpoint: authorization_code (with PKCE) and refresh_token grants

Request body

application/json
grant_typestringrequired
authorization_code | refresh_token
client_idstringrequired
client_secretstring
codestring
redirect_uristring
code_verifierstring
refresh_tokenstring
{
  "grant_type": "authorization_code",
  "client_id": "string",
  "client_secret": "string",
  "code": "string",
  "redirect_uri": "string",
  "code_verifier": "string",
  "refresh_token": "string"
}

Code samples

cURL
curl -X POST "https://hermeticor.com/oauth/token" \
  -H "Content-Type: application/json" \
  -d '{"grant_type":"authorization_code","client_id":"string","client_secret":"string","code":"string","redirect_uri":"string","code_verifier":"string","refresh_token":"string"}'
TypeScript
Python
Go
PHP
Ruby
Java

Responses

200 Default Response
Example
{
  "access_token": "string",
  "token_type": "Bearer",
  "expires_in": 0,
  "refresh_token": "string",
  "scope": "string"
}
Schema
access_tokenstringrequired
token_typestringrequired
Bearer
expires_inintegerrequired
refresh_tokenstringrequired
scopestringrequired
4XX Default Response
Example
{
  "error": {
    "code": "string",
    "message": "string",
    "details": {}
  }
}
Schema
errorobjectrequired
Show child parameters
codestringrequired
messagestringrequired
detailsobject
5XX Default Response

Same as 4XX · POST /oauth/token

POSThttps://hermeticor.com/oauth/revoke

RFC 7009 token revocation

Request body

application/json
tokenstringrequired
client_idstringrequired
client_secretstring
{
  "token": "string",
  "client_id": "string",
  "client_secret": "string"
}

Code samples

cURL
curl -X POST "https://hermeticor.com/oauth/revoke" \
  -H "Content-Type: application/json" \
  -d '{"token":"string","client_id":"string","client_secret":"string"}'
TypeScript
Python
Go
PHP
Ruby
Java

Responses

200 Default Response
Example
{
  "ok": true
}
Schema
okbooleanrequired
true
4XX Default Response

Same as 4XX · POST /oauth/token

5XX Default Response

Same as 4XX · POST /oauth/token

GEThttps://hermeticor.com/v1/authorized-apps

Parameters

limitintegerquery
Page size; omitted returns the whole list
cursorstringquery
Opaque: the nextCursor of the previous page

Code samples

cURL
curl -X GET "https://hermeticor.com/v1/authorized-apps" \
  -H "Authorization: Bearer $HERMETICOR_API_KEY"
TypeScript
Python
Go
PHP
Ruby
Java

Responses

200 Default Response
Example
{
  "items": [
    {
      "clientId": "string",
      "name": "string",
      "scopes": [
        "string"
      ],
      "grantedBy": "string",
      "grantedAt": "2024-01-01T00:00:00Z",
      "lastUsedAt": "2024-01-01T00:00:00Z"
    }
  ],
  "nextCursor": "string"
}
Schema
itemsItemsItem150[]required
Show child parameters
clientIdstringrequired
namestringrequired
scopesstring[]required
grantedBystringrequired
grantedAtstringrequired
lastUsedAtstringrequired
nextCursorstringrequired
4XX Default Response

Same as 4XX · POST /oauth/token

5XX Default Response

Same as 4XX · POST /oauth/token

GEThttps://hermeticor.com/v1/authorized-apps/{clientId}

Parameters

clientIdstringpathrequired

Code samples

cURL
curl -X GET "https://hermeticor.com/v1/authorized-apps/{clientId}" \
  -H "Authorization: Bearer $HERMETICOR_API_KEY"
TypeScript
Python
Go
PHP
Ruby
Java

Responses

200 Default Response
Example
{
  "clientId": "string",
  "name": "string",
  "scopes": [
    "string"
  ],
  "grantedBy": "string",
  "grantedAt": "2024-01-01T00:00:00Z",
  "lastUsedAt": "2024-01-01T00:00:00Z"
}
Schema
clientIdstringrequired
namestringrequired
scopesstring[]required
grantedBystringrequired
grantedAtstringrequired
lastUsedAtstringrequired
4XX Default Response

Same as 4XX · POST /oauth/token

5XX Default Response

Same as 4XX · POST /oauth/token

DELETEhttps://hermeticor.com/v1/authorized-apps/{clientId}

Parameters

clientIdstringpathrequired

Code samples

cURL
curl -X DELETE "https://hermeticor.com/v1/authorized-apps/{clientId}" \
  -H "Authorization: Bearer $HERMETICOR_API_KEY"
TypeScript
Python
Go
PHP
Ruby
Java

Responses

200 Default Response

Same as 200 · POST /oauth/revoke

4XX Default Response

Same as 4XX · POST /oauth/token

5XX Default Response

Same as 4XX · POST /oauth/token

Updated