v1.0.0 Public

API para Desenvolvedores

Construa um mercado mais seguro. Integre nossa base de dados de bicicletas ao seu e-commerce, seguradora ou aplicativo de mobilidade com nossa API REST pública.

Por que integrar?

Segurança para você e seus usuários.

Marketplaces

Valide automaticamente se uma bicicleta anunciada consta como roubada em nossa base antes de publicar.

Seguradoras

Consulte o histórico de propriedade e verifique a existência de alertas ativos durante a cotação.

Oficinas

Proteja seu negócio consultando status de bicicletas que entram para manutenção.

Endpoints Públicos

# Base URL
https://api.bikeid.io/public

GET

/bikes/{publicId}

Consulta o status público de uma bicicleta pelo seu ID público (presente no QR Code ou link). Ideal para validação rápida de status.

Exemplo de Resposta (200 OK)

{
  "bike": {
    "publicId": "bik_123abc...",
    "brand": "Caloi",
    "model": "Elite Carbon",
    "year": 2023,
    "color": "Preto",
    "status": "ACTIVE", // ou "STOLEN"
    "owner": {
      "name": "Elton *****",
      "city": "Curitiba",
      "state": "PR"
    }
  }
}

GET

/stolen-bikes

Retorna um feed paginado das bicicletas reportadas como roubadas recentemente. Suporta filtros por cidade e estado.

Query Parameters

city- Nome da cidade
state- UF (ex: PR)
page- Num. página

Exemplo de Resposta (200 OK)

{
  "total": 150,
  "page": 1,
  "bikes": [
    {
      "publicId": "bik_999xyz...",
      "brand": "Specialized",
      "model": "Tarmac",
      "status": "STOLEN",
      "theftReports": [
        {
          "city": "São Paulo",
          "eventDate": "2024-12-08T..."
        }
      ]
    },
    ...
  ]
}

Política de Uso Responsável

Esta API é de acesso livre para tornar a comunidade mais segura. Pedimos que implemente cache local e evite requisições excessivas (crawling).