Consultar preço de um produto

GET

/v2/products/{productCode}/price

Consulta o preço, em créditos, de um produto que o usuário pode consultar. O produto precisa estar entre os produtos de consulta ou de consulta individual do perfil de permissão do usuário; se não estiver, a API devolve 403 (Produto não permitido para consulta), mesmo que o código não exista no catálogo. Produto permitido, mas inexistente ou inativo no catálogo, devolve 404 (Produto não encontrado). A resposta traz o identificador do produto e o preço em credits. Requer autenticação via Bearer JWT ou header x-api-key, e o usuário precisa ter perfil de permissão: usuário sem perfil recebe 403 (Acesso negado); perfil inexistente, 401 (Permissão inválida!); usuário inativo, 404 (Usuário não encontrado).

Requisição

Authorization

Forneça seu token bearer no cabeçalho

Authorization

ao fazer requisições para recursos protegidos.

Exemplo:

Authorization: Bearer ********************

Parâmetros de Caminho

Parâmetros Header

Respostas

🟢200

application/json

Preço do produto

Bodyapplication/json

🟠400BadRequest

🟠401Unauthorized

🟠404NotFound

🟠429TooManyRequests

🔴500InternalError

🟠403Acesso negado ou produto não permitido

🟠404Produto ou usuário não encontrado

Request Example

Shell

JavaScript

Java

Swift

curl --location '/v2/products/cpr-mvp/price' \
--header 'x-api-key: SUA_CHAVE_DE_API' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Sucesso

{
    "_id": "5f8d0d55-2c1a-4b7e-9a31-0c6f1e2d3a4b",
    "credits": 10
}

Modificado em 2026-10-13 09:03:15

Página anterior

Listar produtos permitidos por tipo de consulta

Próxima página

Visualizar saldo de uma empresa