Início rápido

Crie uma chave de API.

No admin, abra Configurações → Integrações API, clique em Gerar chave, selecione o escopo posts:write (acrescente post_types:read e sites:read se a sua ferramenta inspeciona o site) e copie o segredo ck_…. Ele é exibido uma única vez. Detalhes: Autenticação.

Publique um post.

curl -X POST https://api.canverly.com/v1/posts \
  -H "Authorization: Bearer ck_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "My first API post",
    "status": "published",
    "blocks_json": {
      "v": 1,
      "blocks": [
        { "id": "p1", "type": "paragraph", "text": "Hello, world." }
      ]
    }
  }'

Resposta:

{ "id": "01K…", "slug": "my-first-api-post", "status": "published", "public_url": null }

Confirme que está no ar.

# Descubra o domínio do seu site (uma vez):
curl -s https://api.canverly.com/v1/sites/me -H "Authorization: Bearer ck_live_xxx"
# → { "id": "...", "slug": "...", "primary_domain": "blog.example.com", "default_language": "pt-BR" }

# Depois abra https://blog.example.com/my-first-api-post

Solução de problemas na primeira chamada

Você vê	Causa	Correção
`401 unauthorized`	`Authorization` ausente ou digitado errado, ou chave revogada	Reenvie `Authorization: Bearer ck_…`; gere outra se tiver sido revogada
`403 forbidden`	A chave não tem `posts:write`	Gere uma chave com o escopo certo
`400 bad_request` (`title is required`)	`title` vazio ou ausente	Informe um `title` não vazio
`422` (`missing field blocks_json`)	Nenhum documento de blocos no corpo	Inclua `blocks_json: { "v": 1, "blocks": [...] }`
`429 rate_limited`	Acima de 60 req/min	Espere antes de tentar de novo; respeite o `Retry-After`