Pular para o conteúdo
Entrar Lista de espera

Ver preferências

GET /v1/preferences escopo read

Preferências do painel de quem está logado neste workspace (uma chave de API lê a linha do workspace): theme, language e notifications por evento, com os sinais email e panel. O que falta volta com o padrão (tema escuro, pt-BR, sem e-mail, painel ligado).

CabeçalhosAuthorization: Bearer praeko_… e X-Praeko-Contract: en. Sempre envie os dois.

Exemplo

curl "https://praeko.app/v1/preferences" \
  -H "Authorization: Bearer $PRAEKO_KEY" \
  -H "X-Praeko-Contract: en"

Resposta

Status de sucesso Quando
200 Sucesso.
Resposta 200
{
  "theme": "dark",
  "language": "pt-BR",
  "notifications": {
    "postSent": {
      "email": false,
      "panel": true
    },
    "postFailed": {
      "email": true,
      "panel": true
    },
    "scheduledFail": {
      "email": false,
      "panel": true
    },
    "weeklySummary": {
      "email": false,
      "panel": true
    },
    "newComment": {
      "email": false,
      "panel": true
    }
  }
}

Erros

Sem erros específicos desta rota além dos comuns.

Erros de qualquer rota

Status code Quando
401 unauthorized Faltou o cabeçalho Authorization: Bearer ….
401 invalid_api_key A chave não existe.
401 revoked_api_key A chave foi revogada.
401 expired_api_key A chave expirou.
403 forbidden O escopo da chave não basta para esta rota (veja o selo de escopo).
429 rate_limited Passou do limite de requisições por minuto.

O corpo de todo erro é { "error": { "code", "message", "details"? } }. Veja todos os códigos.

Testar

Testar

O teste ao vivo usa a sua chave e a sua conta. Para quem não entrou, fica desligado.

Entre para testar
Dúvida ou erro nesta página? contato@praeko.appVer .md

Digite para buscar páginas, rotas e códigos de erro.