API PartsGov

1Autenticação

Todas as requisições à API devem ser autenticadas através de um Bearer Token enviado no cabeçalho da requisição.

CopiarAuthorization: Bearer seu_token_aqui

Nota: para obter seu token de acesso, entre em contato com nossa equipe de suporte ou acesse o painel administrativo.

2Buscar Peças

Realiza a busca de peças no banco de dados utilizando filtros específicos.

Parâmetros da Requisição

Parâmetro	Tipo	Obrigatório	Descrição
descricao	string	Condicional*	Descrição da peça (mín. 4 caracteres)
codigo_partnumber	string	Condicional*	Código Part Number
codigo_om	string	Condicional*	Código OM
page	int	Não	Número da página (padrão: 1)

* Pelo menos um dos parâmetros condicionais deve ser enviado.

Exemplo de Requisição

Copiarcurl -X GET "https://partsgov.com.br/api/v1/pecas/search?descricao=filtro+oleo&page=1" \
  -H "Authorization: Bearer seu_token_aqui" \
  -H "Accept: application/json"

Exemplo de Resposta

Copiar{
  "success": true,
  "message": "Busca realizada com sucesso.",
  "data": {
    "pecas": [
      {
        "id": 1,
        "descricao": "Filtro de Óleo",
        "codigo_partnumber": "ABC123",
        "codigo_om": "OM456",
        "montadora": "FIAT",
        "preco": "45.90"
      }
    ],
    "pagination": {
      "total": 50,
      "per_page": 15,
      "current_page": 1,
      "last_page": 4
    }
  }
}

3Códigos de Status

4Boas Práticas