Pular para o conteúdo principal

GET /api/products/{id}

Retorna um produto pelo ID interno. O isolamento por supplier_id é garantido — retorna 404 caso o produto não exista ou pertença a outro fornecedor.

Autenticação

Requer header Authorization: Bearer <access_token> emitido pelo endpoint POST /api/external-auth/token.

Request

Headers

HeaderValor
AuthorizationBearer <access_token>

Path Parameters

ParâmetroTipoObrigatórioDescrição
idintID interno do produto (campo Id da listagem).
curl -s "https://<host>/api/products/<id>" \
-H "Authorization: Bearer <access_token>"

Response

200 OK

{
"Id": 0,
"ExternalId": "<material_id>",
"Name": "<material> - <material_variant>",
"Sku": "<sku>",
"Description": "material_variant_id=<id> | dimensions=<w>x<h>x<d> | weight=<kg>",
"Price": 0.00,
"Stock": 0,
"Category": "<material_variant>",
"Status": "synced",
"ErrorMessage": null,
"SyncedAt": "<iso8601>",
"CreatedAt": "<iso8601>",
"UpdatedAt": "<iso8601>"
}

404 Not Found

Produto não encontrado ou não pertence ao fornecedor autenticado.

{ "message": "Product <id> not found." }

401 Unauthorized

Token ausente, expirado ou inválido.

{ "message": "Invalid token." }