API atual/Referência completa/Preenchimento de produto com IA

Histórico de gerações

Lista, com paginação e filtros, tudo o que foi gerado, aplicado ou testado no preenchimento com IA da loja.

Toda ação do modo individual deixa uma linha de histórico: cada preview, cada apply, cada falha e cada test. Use esta lista para auditar quem pediu o quê e quando, descobrir por que uma geração falhou ou ligar uma aplicação à prévia que a originou (pelo preview_log_id).

As linhas vêm da mais nova para a mais antiga. As gerações do modo em lote não aparecem aqui; elas ficam nos próprios itens do lote.

GET/api/v1/admin/ai-product-fill/logsAdmin

Lista o histórico de gerações

Privilégio exigido: manage_ai_tools ou manage_catalog.

Parâmetros de consulta

pageintegerpadrão: 1

Página, a partir de 1. Valor inválido ou menor que 1 vira 1.

per_pageintegerpadrão: 25

Itens por página, de 1 a 200. Atenção: um valor acima de 200 volta ao padrão de 25, não é limitado a 200.

product_iduuid

Só linhas deste produto. Um valor que não seja UUID faz a chamada falhar com 500.

user_iduuid

Só linhas geradas por este administrador. Um valor que não seja UUID faz a chamada falhar com 500.

statusstring

previewappliederrortest

Só linhas com este status.

Exemplo de requisição

bash

curl "$BASE_URL/api/v1/admin/ai-product-fill/logs?status=applied&per_page=25" \
  -H "Authorization: Bearer $TOKEN"

Resposta

200Histórico retornado

json

{
  "entries": [
    {
      "id": "ce6a9a25-2a28-4c40-82cf-8a9cc3583db4",
      "product_id": "1cf8135a-e349-4dbe-ba70-02257b07bf55",
      "user_id": "ec5e10b3-8cb1-43e9-9aa8-964b64eda8de",
      "fields_filled": ["description", "short_description", "meta_title", "meta_description"],
      "tokens_in": 0,
      "tokens_out": 0,
      "status": "applied",
      "created_at": "2026-07-19T21:28:58.93352Z"
    }
  ],
  "total": 89,
  "page": 1,
  "per_page": 25,
  "total_pages": 4
}

Campos da resposta

entriesarray

Linhas da página.

entries[].iduuid

Id da linha. É o log_id devolvido por preview e apply.

entries[].product_iduuid

Produto envolvido. Ausente em test e em prévias de produto ainda não salvo.

entries[].user_iduuid

Administrador que disparou a ação. Pode faltar.

entries[].fields_filledarray

Campos gerados ou gravados nesta ação.

entries[].prompt_usedstring

Presente em prévias e em linhas cuja geração falhou: o texto enviado para a geração, guardado para auditoria. Omitido nas linhas applied.

entries[].model_usedstring

Identificador do modelo que respondeu. Omitido quando não se aplica (por exemplo em applied).

entries[].tokens_ininteger

Reservado. Hoje 0.

entries[].tokens_outinteger

Reservado. Hoje 0.

entries[].statusstring

previewappliederrortest

preview (prévia gerada), applied (gravado no produto), error (falha; veja error_message) ou test (teste de conexão bem-sucedido).

entries[].error_messagestring

Motivo da falha, quando status é error.

entries[].created_atstring

Data e hora em RFC 3339, UTC.

totalinteger

Total de linhas que atendem aos filtros, em todas as páginas.

pageinteger

Página devolvida.

per_pageinteger

Tamanho de página aplicado.

total_pagesinteger

Quantidade de páginas.

Erros

Status	Quando	Corpo de exemplo
401	Token ausente, inválido ou expirado.	`{"error":"invalid or expired token"}`
403	Sem `manage_ai_tools` nem `manage_catalog`.	`{"error":"insufficient privileges","privilege_required_any":["manage_ai_tools","manage_catalog"]}`
500	Falha ao consultar o histórico.	`{"error":"..."}`

Veja também

Histórico de gerações

Lista, com paginação e filtros, tudo o que foi gerado, aplicado ou testado no preenchimento com IA da loja.

As linhas vêm da mais nova para a mais antiga. As gerações do modo em lote não aparecem aqui; elas ficam nos próprios itens do lote.

GET/api/v1/admin/ai-product-fill/logsAdmin

Lista o histórico de gerações

Privilégio exigido: manage_ai_tools ou manage_catalog.

Parâmetros de consulta

pageintegerpadrão: 1

Página, a partir de 1. Valor inválido ou menor que 1 vira 1.

per_pageintegerpadrão: 25

Itens por página, de 1 a 200. Atenção: um valor acima de 200 volta ao padrão de 25, não é limitado a 200.

product_iduuid

Só linhas deste produto. Um valor que não seja UUID faz a chamada falhar com 500.

user_iduuid

Só linhas geradas por este administrador. Um valor que não seja UUID faz a chamada falhar com 500.

statusstring

previewappliederrortest

Só linhas com este status.

Exemplo de requisição

bash

curl "$BASE_URL/api/v1/admin/ai-product-fill/logs?status=applied&per_page=25" \
  -H "Authorization: Bearer $TOKEN"

Resposta

200Histórico retornado

json

{
  "entries": [
    {
      "id": "ce6a9a25-2a28-4c40-82cf-8a9cc3583db4",
      "product_id": "1cf8135a-e349-4dbe-ba70-02257b07bf55",
      "user_id": "ec5e10b3-8cb1-43e9-9aa8-964b64eda8de",
      "fields_filled": ["description", "short_description", "meta_title", "meta_description"],
      "tokens_in": 0,
      "tokens_out": 0,
      "status": "applied",
      "created_at": "2026-07-19T21:28:58.93352Z"
    }
  ],
  "total": 89,
  "page": 1,
  "per_page": 25,
  "total_pages": 4
}

Campos da resposta

entriesarray

Linhas da página.

entries[].iduuid

Id da linha. É o log_id devolvido por preview e apply.

entries[].product_iduuid

Produto envolvido. Ausente em test e em prévias de produto ainda não salvo.

entries[].user_iduuid

Administrador que disparou a ação. Pode faltar.

entries[].fields_filledarray

Campos gerados ou gravados nesta ação.

entries[].prompt_usedstring

Presente em prévias e em linhas cuja geração falhou: o texto enviado para a geração, guardado para auditoria. Omitido nas linhas applied.

entries[].model_usedstring

Identificador do modelo que respondeu. Omitido quando não se aplica (por exemplo em applied).

entries[].tokens_ininteger

Reservado. Hoje 0.

entries[].tokens_outinteger

Reservado. Hoje 0.

entries[].statusstring

previewappliederrortest

preview (prévia gerada), applied (gravado no produto), error (falha; veja error_message) ou test (teste de conexão bem-sucedido).

entries[].error_messagestring

Motivo da falha, quando status é error.

entries[].created_atstring

Data e hora em RFC 3339, UTC.

totalinteger

Total de linhas que atendem aos filtros, em todas as páginas.

pageinteger

Página devolvida.

per_pageinteger

Tamanho de página aplicado.

total_pagesinteger

Quantidade de páginas.

Erros

Status	Quando	Corpo de exemplo
401	Token ausente, inválido ou expirado.	`{"error":"invalid or expired token"}`
403	Sem `manage_ai_tools` nem `manage_catalog`.	`{"error":"insufficient privileges","privilege_required_any":["manage_ai_tools","manage_catalog"]}`
500	Falha ao consultar o histórico.	`{"error":"..."}`