Pular para o conteúdo
AchaduDevelopers
API operacionalIr para o site
Painel
Developers/API/store_collections
Store

Listar coleções da loja

Lista coleções editoriais e sua ordem pública.

GET/store/collectionsstore: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
Escopostore:read

Exemplo executável

curl
curl 'https://achadu.com/api/v1/store/collections' \
  -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": "site_01J...",
      "subdomain": "mystore",
      "name": "Ana's Finds",
      "theme": "light",
      "active": 1,
      "domain_verified": 1
    }
  ],
  "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 store: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.