Pular para o conteúdo principal

Get my active auctions

GET 
/company/bid-auctions/mine

Retorna uma listagem paginada de todos os leilões nos quais o usuário autenticado realizou lances. Inclui leilões com status 'published', 'awarded', 'approved', etc.

Objetivo​

Permitir que os transportadores gerenciem seus lances ativos, revisem o status de suas participações e filtrem de acordo com diferentes critérios de interesse.

Casos de Uso​

  • Transportador quer ver todos os seus lances ativos
  • Filtrar leilões que estão pendentes de assinatura
  • Revisar leilões ganhos ou perdidos
  • Ver histórico completo de participações

Diagrama de Filtros:

flowchart TD
  A[GET /mine?filter=X] --> B{Tipo de filtro}

  B -->|all| C[Todos os lances do usuário]
  B -->|open| D[Leilões publicados<br/>date_end >= hoje<br/>status: published]
  B -->|to_sign| E[Adjudicados pendentes<br/>status: awarded<br/>signed_by_trucker: false]
  B -->|awarded| F[Todos os adjudicados<br/>status: awarded]
  B -->|closed| G[Leilões encerrados<br/>status: locked/canceled/rejected]
  B -->|lost| H[Perdidos<br/>status: approved<br/>usuário NÃO é vencedor]
  B -->|won| I[Ganhos<br/>status: approved<br/>usuário SIM é vencedor]

  C --> J[Retornar AuctionsResponse]
  D --> J
  E --> J
  F --> J
  G --> J
  H --> J
  I --> J

  style D fill:#90EE90
  style E fill:#FFD700
  style I fill:#87CEEB
  style H fill:#FFB6C1

Exemplo de uso:

GET /company/bid-auctions/mine?filter=to_sign&page=1&limit=10

Campos destacados na resposta:

  • my_bid: Valor do lance do usuário
  • `bid_current

Request​

Responses​

Lista de leilões obtida com sucesso. Inclui metadados de paginação e array de leilões com os lances do usuário.

Response Headers