Pular para o conteúdo

GET /v1/sites/me

Retorna metadados básicos do site dono da chave de API. Esta é a forma canônica de resolver o domínio público do site (para montar URLs de verificação) e o idioma padrão dele, sem deixá-los fixos no código do consumidor.

  • URL: https://api.canverly.com/v1/sites/me
  • Método: GET
  • Auth: chave de API Bearer — escopo sites:read
  • Limite de requisição: 60 req/min por chave

Sem parâmetros — o site é inferido a partir da chave. Não há :id para passar; para inspecionar outro site, use uma chave emitida naquele site.

Janela do terminal
curl https://api.canverly.com/v1/sites/me \
-H "Authorization: Bearer ck_live_xxx"
{
"id": "01KVPWYKT6AJDGG2EJN7DW4VT5",
"slug": "schematize",
"primary_domain": "blog.schematize.me",
"default_language": "pt-BR"
}
Campo Tipo Observações
id string (ULID) Identificador do site.
slug string Slug interno (usado nos subdomínios de fallback *.canverly.com).
primary_domain string O domínio canônico — monte URLs públicas como https://<primary_domain>/<slug>.
default_language string A tag de idioma BCP-47 padrão do site.
  • Montar URLs de verificação — depois de publicar, confirme que o post está no ar em https://<primary_domain>/<slug>.
  • Escolher um idioma — use default_language como padrão para posts novos quando a origem não especificar um.
  • Health check — uma chamada barata que prova que a chave é válida e que o site é resolvido.

Guarde a resposta em cache — ela raramente muda. Não consulte a cada publicação.

Status error.code Quando
401 unauthorized Chave ausente/inválida.
403 forbidden A chave não tem sites:read.
429 rate_limited Acima de 60 req/min.