Grade de produtos
GET para listar produtos dos seus blocos (requer chave de API). POST para atualizar ou adicionar produtos (requer chave de API).
GET https://lerline.com/api/products-grid
Endpoint GET `api/products-grid`. Requer header Authorization: Bearer {api_key}. Lista produtos do bloco indicado (o bloco deve ser seu). Parâmetros: block_id (obrigatório), q (busca), category, page, results_per_page.
| Parâmetros | Obrigatório | Descrição |
|---|---|---|
| block_id | Obrigatório | ID do bloco de grade de produtos. |
| q | Opcional | Termo de busca. |
| category | Opcional | Filtrar por categoria. |
| page | Opcional | Página (padrão 1). |
| results_per_page | Opcional | Itens por página: 10, 25, 50, 100, 250, 500 ou 1000 (padrão conforme a conta). |
curl --request GET \
--url 'https://lerline.com/api/products-grid?block_id=123' \
--header 'Authorization: Bearer {api_key}'
{
"data": [
{
"product_id": "prod_123_1700000000_123",
"biolink_block_id": 123,
"title": "Produto",
"description": "",
"category": "",
"link": "https://...",
"canonical_link": "",
"price": "0.00",
"currency": "",
"status": "visible",
"display_favicon": false,
"open_in_new_tab": true,
"search_tags": "",
"product_sku": "",
"affiliate_link_set": false,
"media_gallery": null,
"order": 0,
"datetime": "2026-01-01 12:00:00"
}
],
"meta": {
"page": 1,
"results_per_page": 25,
"total": 1,
"total_pages": 1
},
"links": {
"first": "https://lerline.com/api/products-grid?block_id=123&page=1",
"last": "https://lerline.com/api/products-grid?block_id=123&page=1",
"next": null,
"prev": null,
"self": "https://lerline.com/api/products-grid?block_id=123&page=1"
}
}
POST https://lerline.com/api/products-grid
Requer o header Authorization: Bearer {api_key}. Corpo JSON: block_id, products (array), mode (append ou replace). Opcional: products[].product_id — se existir no bloco, atualiza o produto em vez de duplicar.
| Campo | Obrigatório | Descrição |
|---|---|---|
| block_id | Obrigatório | ID do bloco (deve ser seu). |
| products | Obrigatório | Array de produtos (formato grade ou Apify). |
| products[0].product_id | Opcional | ID do produto dentro do array products. Se informado e existir no bloco, o produto é atualizado (em vez de inserir um novo). |
| mode | Opcional | append (adicionar) ou replace (substituir todos). Padrão: append. |
curl --request POST \
--url 'https://lerline.com/api/products-grid' \
--header 'Authorization: Bearer {api_key}' \
--header 'Content-Type: application/json' \
--data '{"block_id": 123, "products": [{"title": "Produto", "link": "https://...", "media_gallery": {"items": [{"type": "image", "url": "https://..."}]}}], "mode": "append"}'
curl --request POST \
--url 'https://lerline.com/api/products-grid' \
--header 'Authorization: Bearer {api_key}' \
--header 'Content-Type: application/json' \
--data '{"block_id": 123, "products": [{"product_id":"prod_123_1700000000_123","title":"Produto (atualizado)","link":"https://...","media_gallery":{"items":[{"type":"image","url":"https://..."}]}}], "mode": "append"}'
{
"data": {
"imported": 1,
"skipped": 0,
"limit_reached": false
}
}
DELETE https://lerline.com/api/products-grid
Endpoint DELETE `api/products-grid`. Requer header Authorization: Bearer {api_key}. Use block_id (obrigatório) + product_id (query) para deletar 1 produto, ou envie JSON {"product_ids":[...]} para deletar em lote.
| Parâmetros | Obrigatório | Descrição |
|---|---|---|
| block_id | Obrigatório | ID do bloco de grade de produtos. |
| product_id | Opcional | ID do produto a deletar (string retornada no GET como product_id). |
curl --request DELETE \
--url 'https://lerline.com/api/products-grid?block_id=123&product_id=prod_123_1700000000_123' \
--header 'Authorization: Bearer {api_key}'
curl --request DELETE \
--url 'https://lerline.com/api/products-grid?block_id=123' \
--header 'Authorization: Bearer {api_key}' \
--header 'Content-Type: application/json' \
--data '{"product_ids":["prod_123_1700000000_123","prod_123_1700000001_456"]}'
{
"data": {
"deleted": 2
}
}