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.
Exemplo
Seção intitulada “Exemplo”curl https://api.canverly.com/v1/sites/me \ -H "Authorization: Bearer ck_live_xxx"Resposta
Seção intitulada “Resposta”{ "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. |
Quando usar
Seção intitulada “Quando usar”- 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_languagecomo 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. |
Veja também
Seção intitulada “Veja também”- Configurações do site — a configuração editável, sob
os escopos separados
site:read/site:write. - SEO do site — padrões de SEO do site inteiro.