API legada/Referência completa/Propostas de preço

Criar proposta

Registra uma proposta de preço (make_an_offer) na API legada e explica o comportamento atual da rota.

A rota existe no contrato da Venddor 1.0, e o corpo abaixo é o que ela espera. Leia o aviso sobre o comportamento atual antes de integrar.

Criar uma proposta

Registra uma proposta de preço de um cliente, com os produtos, quantidades e o preço pedido para cada um.

POST/api/v1.0/make_an_offerAdmin

Criar uma proposta de preço

Autenticação: HTTP Basic com e-mail:chave_de_api de um administrador, ou Authorization: Bearer <JWT>.

Corpo da requisição

user_idstringobrigatório

Id do cliente (UUID).

productsarrayobrigatório

Itens da proposta. Pelo menos um.

products[].product_idstring

Id do produto (UUID).

products[].qtyinteger

Quantidade. Omitida ou 0 vale 1.

products[].pricestring

Preço pedido por unidade, em string decimal ("39.90"). Omitido, a proposta fica sem preço pedido.

Exemplo de requisição

bash

curl -X POST -u "$EMAIL:$API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"user_id": "5b0c3a8e-6d3f-4c55-9a1e-2f7d8b4c1a90", "products": [{"product_id": "48e87591-5fb1-40da-b32e-edec3a8c596d", "qty": 10, "price": "39.90"}]}' \
  "$BASE_URL/api/v1.0/make_an_offer"

Resposta

500Resposta atual

json

{
  "message": "vendor_id is required",
  "status": 500
}

Erros

Status	Quando	Corpo
400	Corpo que não é JSON válido	`{"message":"invalid request body","status":400}`
401	Sem credenciais ou chave inválida	`{"message":"Authentication required. Use HTTP Basic with email:api_key or Bearer <jwt>.","status":401}`
403	O usuário não é administrador	`{"message":"Forbidden: admin scope required","status":403}`
404	`user_id` ou `products` ausentes	`{"message":"user_id and products are required","status":404}`
500	Hoje, para qualquer corpo válido	`{"message":"vendor_id is required","status":500}`

Veja também