Aplicar em massa
Aprova todos os itens em revisão de um lote e aplica os aprovados aos produtos, em passadas com limite de tempo.
Quando o lote tem centenas de propostas, revisar uma a uma não é viável. Estas duas operações aplicam em massa. approve-all aprova todos os itens em generated e já os aplica. apply aplica os itens que estão em approved e ainda não foram gravados, o que acontece quando uma passada anterior foi interrompida.
Cada chamada trabalha dentro de um orçamento: no máximo 500 itens e 3 minutos. Se o orçamento acaba antes de a fila esvaziar, a resposta traz interrupted: true e remaining com o que sobrou. Repita a chamada (a de apply basta) até remaining chegar a 0. Os mesmos cuidados do aprovar item a item valem aqui: se o produto mudou desde a geração, o item vira invalidated e não é gravado. Itens com proposta vencida (mais de 7 dias) viram expired.
/api/v1/admin/ai-product-fill/batches/{id}/approve-allAdminAprova e aplica todos os itens em revisão
Privilégio exigido: manage_ai_tools ou manage_catalog. Sem corpo.
Parâmetros de caminho
iduuidobrigatórioExemplo de requisição (aprovar todos)
curl -X POST "$BASE_URL/api/v1/admin/ai-product-fill/batches/7d87db3d-2682-42f5-9c40-a91d94e7bf98/approve-all" \
-H "Authorization: Bearer $TOKEN"Resposta (aprovar todos)
{
"applied": 500,
"invalidated": 3,
"failed": 1,
"expired": 0,
"remaining": 1219,
"interrupted": true
}Campos da resposta
appliedintegerinvalidatedintegerfailedintegerexpiredintegerremaininginteger0 significa que acabou.interruptedbooleantrue se a passada parou por limite de tempo ou de itens, ou porque a conexão caiu.Erros (aprovar todos)
| 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 ou atualizar a fila (inclui id de lote que não é UUID). | {"error":"..."} |
/api/v1/admin/ai-product-fill/batches/{id}/applyAdminAplica os itens já aprovados
Privilégio exigido: manage_ai_tools ou manage_catalog. Sem corpo. Pega só os itens em approved (do mais antigo ao mais novo) e os grava, com o mesmo orçamento de 500 itens e 3 minutos.
Parâmetros de caminho
iduuidobrigatórioExemplo de requisição (aplicar)
curl -X POST "$BASE_URL/api/v1/admin/ai-product-fill/batches/7d87db3d-2682-42f5-9c40-a91d94e7bf98/apply" \
-H "Authorization: Bearer $TOKEN"Resposta (aplicar)
{
"applied": 1219,
"invalidated": 0,
"failed": 0,
"expired": 0,
"remaining": 0,
"interrupted": false
}Os campos são os mesmos de approve-all.
Erros (aplicar)
| 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 a fila. | {"error":"..."} |