Avaliar um pedido de recomendação

POST

/v2/recommendations/evaluate/{recommendationId}

Registra a avaliação do usuário autenticado sobre o cliente de um pedido de recomendação: notas de pontualidade de pagamento, tempo de atividade, nível tecnológico e relacionamento comercial, se há histórico de inadimplência, se recomenda o cliente (approval) e um comentário opcional. Cada usuário avalia um mesmo pedido uma única vez. Os usuários ativos da empresa que fez o pedido passam a ver a avaliação como novidade. Requer autenticação via Bearer JWT ou header x-api-key.

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

Parâmetros Bodyapplication/jsonNecessário

Examples

Respostas

🟢200

application/json

Inferred 200 (from source code)

Bodyapplication/json

🟠400BadRequest

🟠401Unauthorized

🟠404NotFound

🟠429TooManyRequests

🔴500InternalError

🟠422Campos inválidos

🟠404Pedido de recomendação não encontrado

🟠409Avaliação já registrada

Request Example

Shell

JavaScript

Java

Swift

curl --location '/v2/recommendations/evaluate/' \
--header 'x-api-key: SUA_CHAVE_DE_API' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "paymentScore": 5,
    "activityTime": 4,
    "technologicalLevel": 3,
    "businessRelationship": 5,
    "defaultHistory": false,
    "approval": true,
    "note": "Cliente há 8 anos, sempre pagou em dia."
}'

Response Example

200 - Sucesso

{
    "message": "Recomendação enviada com sucesso"
}

Modificado em 2026-10-13 09:47:06

Página anterior

Listar avaliações de um pedido de recomendação

Próxima página

Consultar as permissões do usuário autenticado