Erros, problem types e requestId

Endpoints /v1 retornam application/problem+json. Faça branching por status e code; detail é texto para humanos e não deve ser parseado como contrato. A URL em type resolve para uma página deste portal com orientação do problema.

{
  "type": "https://developers.hubday.com.br/problems/insufficient-scope",
  "title": "Insufficient scope",
  "status": 403,
  "detail": "O access token não possui todos os scopes exigidos por esta operação.",
  "code": "INSUFFICIENT_SCOPE",
  "requestId": "req_...",
  "requiredScopes": ["appointments:write"]
}

Endpoints OAuth usam error/error_description conforme o protocolo OAuth. Guarde requestId junto dos seus logs de integração para investigação com a Hubday.