API legada/Referência completa/Características do produto

Paginação de características

Controle quantas características voltam e qual página é exibida com page e items_per_page.

Ao consultar as características do produto pela API, você controla quantos resultados voltam e qual página é exibida por meio de parâmetros de paginação. Os catálogos costumam ter muitas características, por isso a paginação é essencial para recuperar e exibir os dados com eficiência.

Parâmetros de paginação

Acrescente estes parâmetros às requisições para paginar as características do produto.

GET/api/featuresAdmin

Paginar características

Retorna as características do produto, uma página por vez.

Parâmetros de consulta

pageintegerpadrão: 1

Indica qual página de características exibir. As páginas são numeradas a partir de 1.

items_per_pageintegerpadrão: 10

Controla quantas características aparecem em cada página.

Exemplos

Requisição	Resultado
`GET /api/features?page=5`	Retorna 10 características da 5ª página. Como `items_per_page` não foi informado, vale o padrão de 10.
`GET /api/features?items_per_page=20`	Retorna 20 características da primeira página. Como `page` não foi informado, vale o padrão de 1.
`GET /api/features?page=5&items_per_page=20`	Retorna 20 características da 5ª página. Os dois parâmetros foram informados, o que dá controle total sobre o resultado.

Exemplo de requisição

bash

curl "$BASE_URL/api/features?page=5&items_per_page=20" \
  -u "$EMAIL:$API_KEY"

Formato da resposta

A API retorna uma lista JSON com os objetos de característica da página pedida. Cada objeto de característica traz detalhes como o ID, o nome, a descrição, o tipo (por exemplo, texto, numérico, booleano) e os valores disponíveis (nas características de seleção).

Veja também