Pular para o conteúdo
AchaduDevelopers
API operacionalIr para o site ↗
Painel →
Developers/API/templates_list
Templates

Listar templates

Lista modelos editoriais da conta.

GET/templatestemplates:read
COMPORTAMENTO

A leitura respeita os filtros e devolve somente recursos visíveis para a conta vinculada à chave.

EFEITO

Não altera recursos nem dispara publicação.

REPETIÇÃO

A operação é segura para repetição. Em 429 ou 5xx, use backoff exponencial com jitter.

Solicitação

limitinteger · queryQuantidade por página.min 1 · max 100 · default 30opcional
offsetinteger · queryDeslocamento da paginação.min 0 · default 0opcional
AuthorizationBearer ach_live_...
Acceptapplication/json
Escopotemplates:read

Exemplo executável

curl
curl 'https://achadu.com/api/v1/templates' \
  -H 'Authorization: Bearer ach_live_...' \
  -H 'Accept: application/json'

Resposta e erros

Toda resposta inclui request_id. Listas acrescentam pagination; recursos mutáveis retornam o estado persistido após a operação.

200 application/json
{
  "data": [
    {
      "id": "tpl_01J...",
      "name": "Direct deal",
      "body": "{{title}} for {{price}}",
      "has_preview": 1,
      "created_at": "2026-08-31T18:20:00.000Z"
    }
  ],
  "pagination": {
    "total": 1,
    "limit": 30,
    "offset": 0,
    "has_more": false
  },
  "request_id": "req_01J..."
}
200Operação concluída.
400Parâmetro, corpo ou transição inválida.
401Chave ausente, inválida, expirada ou revogada.
402O plano da conta não libera esta interface.
403A chave precisa do escopo templates:read.
404Recurso inexistente nesta conta.
409O estado atual impede esta operação.
413O corpo JSON ultrapassa 128 KB.
429A janela de 120 solicitações por minuto foi excedida.