Skip to the content

DoRoutes API · version 1

Service

GET/v1/health

Check the service

Answers 503 with {"status": "unavailable"} when the database cannot be reached.

Response 200 · object

Done.

  • statusstring, required

    One of: ok

Example response 200
{
  "status": "ok"
}

Response 500 · Error

Something failed on our side.

  • errorobject, required
    • codestring, required

      A short machine-readable name, such as not_found.

    • messagestring, required

      What went wrong, for people.

  • request_idstring, required

    Matches the X-Request-ID response header.

Example response 500
{
  "error": {
    "code": "string",
    "message": "string"
  },
  "request_id": "string"
}

Response 503 · object

The database cannot be reached.

  • statusstring

    One of: unavailable

Example response 503
{
  "status": "unavailable"
}
GET/v1/tenants/{slug}

Find a business's public key by its slug

Parameters

  • slugstring, in the path, required

Response 200 · object

Done.

  • tenantobject, required
    • slugstring, required
    • namestring, required
    • keystring, required

      Send as X-Tenant-Key on every other request.

Example response 200
{
  "tenant": {
    "slug": "string",
    "name": "string",
    "key": "string"
  }
}

Response 400 · Error

The request is not valid.

Fields as in Check the service

Response 404 · Error

Not found, or not yours.

Fields as in Check the service

Response 500 · Error

Something failed on our side.

Fields as in Check the service