# Revisión técnica

Revisión técnica mediante una consulta autenticada.

POST https://api.datosperu.net/api/v1/vehiculo/revision-tecnica

## Autenticación

Authorization: Bearer seguido de una API Key de DatosPerú. Cuenta verificada y permiso para el endpoint. Credencial solo en servidor. Una consulta exitosa consume un crédito.

## Esquema de entrada

```json
{
  "type": "object",
  "required": [
    "placa"
  ],
  "properties": {
    "placa": {
      "type": "string",
      "description": "La placa a consultar",
      "pattern": "^[A-Za-z0-9-]{5,9}$",
      "maxLength": 200,
      "minLength": 1
    }
  },
  "additionalProperties": false
}
```

## Ejemplo ilustrativo (sustituye por datos autorizados)

```sh
curl --request POST 'https://api.datosperu.net/api/v1/vehiculo/revision-tecnica' \
  --header "Authorization: Bearer $DATOSPERU_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "placa": "ABC123"
}'
```

## Schema de data

Una respuesta exitosa contiene success: true, data y meta: {request_id, timestamp}. Campos opcionales o nulos según la fuente.

```json
{
  "type": [
    "array",
    "null"
  ],
  "description": "Historial de revisiones técnicas del vehículo",
  "items": {
    "type": [
      "object",
      "null"
    ],
    "properties": {
      "placa": {
        "type": [
          "string",
          "null"
        ],
        "description": "Placa del vehículo"
      },
      "tipo_documento": {
        "type": [
          "string",
          "null"
        ],
        "description": "Tipo de documento (NRO DE CERTIFICADO, NRO DE INFORME)"
      },
      "numero_certificado": {
        "type": [
          "string",
          "null"
        ],
        "description": "Número de certificado o informe"
      },
      "vigente_desde": {
        "type": [
          "string",
          "null"
        ],
        "description": "Fecha de inicio de vigencia"
      },
      "vigente_hasta": {
        "type": [
          "string",
          "null"
        ],
        "description": "Fecha de fin de vigencia"
      },
      "resultado_inspeccion": {
        "type": [
          "string",
          "null"
        ],
        "description": "Resultado de la inspección (APROBADO, DESAPROBADO)"
      },
      "estado": {
        "type": [
          "string",
          "null"
        ],
        "description": "Estado del certificado (VENCIDO, VIGENTE, etc.)"
      },
      "empresa_certificadora": {
        "type": [
          "string",
          "null"
        ],
        "description": "Nombre de la empresa certificadora"
      },
      "direccion": {
        "type": [
          "string",
          "null"
        ],
        "description": "Dirección del centro de inspección"
      },
      "ambito": {
        "type": [
          "string",
          "null"
        ],
        "description": "Ámbito de la inspección"
      },
      "tipo_servicio": {
        "type": [
          "string",
          "null"
        ],
        "description": "Tipo de servicio del vehículo (PARTICULAR, etc.)"
      },
      "observaciones": {
        "type": [
          "string",
          "null"
        ],
        "description": "Observaciones de la inspección"
      },
      "orden": {
        "type": [
          "string",
          "null"
        ],
        "description": "Orden cronológico del registro (ULTIMO, PENULTIMO, ANTEPENULTIMO)"
      }
    },
    "additionalProperties": false
  }
}
```

## Errores

- HTTP 401: API Key ausente, inválida o revocada. Revisa la credencial.
- HTTP 403: Cuenta, verificación o permiso insuficiente. Revisa tu acceso.
- HTTP 404: Sin resultados o ruta inexistente. Comprueba los datos y el endpoint.
- HTTP 422: Parámetros inválidos. Corrige el cuerpo antes de reintentar.
- HTTP 429: Límite por minuto o cuota del periodo. Revisa el código de error y tu consumo.
- HTTP 502 / 504: Error o demora de la fuente. Reintenta con espera y un máximo de intentos.
- HTTP 503: Servicio no disponible o pendiente de configuración. Consulta el estado.

[OpenAPI completo](https://datosperu.net/openapi.json) · [Versión HTML](https://datosperu.net/docs/vehiculo/revision-tecnica)