Create a new bid
POST/truckers/auctions/bid
Permite que um transportador faça um lance em um leilão ativo.
Requisitos:
- Usuário autenticado e ativo
- Conta de pagamento verificada e habilitada
- Leilão no estado 'published'
- Valor do lance válido (maior que 0 e menor que o lance atual mais baixo)
- Transportador atende aos requisitos do leilão (tipo de veículo, capacidade, etc.)
Fluxo típico:
- Transportador consulta leilões disponíveis
- Obtém detalhes de um leilão específico
- Faz um lance com um valor competitivo
- Se o lance for o mais baixo, torna-se o lance vencedor temporário
Em caso de lance vencedor:
- O transportador e o embarcador são notificados
- O leilão é bloqueado para outros lances se o preço de adjudicação for atingido
Request
Responses
- 200
- 400
- 401
- 403
- 409
Puja criada com sucesso
Response Headers
Erro na solicitação. Possíveis causas:
- Valor do lance inválido
- Leilão não encontrado ou inválido
- Lance não atende aos requisitos
Response Headers
Não autorizado
Response Headers
Acesso negado. Possíveis causas:
- Usuário inativo
- Conta de pagamento não verificada
- Sem permissão para licitar neste leilão
Response Headers
Conflito. Possíveis causas:
- Leilão já adjudicado
- Lance mais baixo já existe
- Restrições de tempo/localização