Autenticación

Todas las llamadas a la API se autentican con una API key. Es lo primero que necesitas para integrar.

Generar una API key

Crea tu cuenta y genera la clave en el sandbox. Las claves tienen el prefijo pk_live_, son personales y puedes revocarlas cuando quieras.

Enviar la clave

Incluye la clave en cada petición usando el header x-api-key:

curl -X POST 'https://placapi.com/api/consulta' \
  -H 'x-api-key: pk_live_TU_CLAVE' \
  -H 'content-type: application/json' \
  -d '{"placa":"ABC123","docType":"CC","docNumber":"1020304050"}'

También se acepta Authorization: Bearer pk_live_…. Sin credenciales válidas la API responde 401.

Consultar tu saldo

GET /api/me devuelve el estado de tu cuenta con la misma clave: saldo de créditos, datos de la key que llama, consumo (hoy y últimos 30 días, con desglose por API) y las tarifas pactadas si las hay. No cuesta créditos: preguntar cuánto te queda es gratis.

curl 'https://placapi.com/api/me' -H 'x-api-key: pk_live_TU_CLAVE'
{
  "cuenta":  { "email": "tu@empresa.com", "creditos": 148, "totalComprado": 500 },
  "key":     { "id": "…", "nombre": "Producción", "prefijo": "pk_live_9a2f", "ultimoUso": "2026-09-02 14:03:11" },
  "consumo": {
    "hoy": { "saldo": 148, "consultas": 12, "creditos": 12, "reembolsos": 1 },
    "mes": { "saldo": 148, "consultas": 310, "creditos": 298, "reembolsos": 12 },
    "estaKey": { "hoy": { … }, "mes": { … } },
    "porApi": [ { "slug": "consulta", "nombre": "Consulta vehicular", "calls": 210, "creditos": 205 } ]
  },
  "avisoSaldoBajo": { "umbral": 20, "activo": true, "porDefecto": false },
  "tarifas": [],
  "fetchedAt": "2026-09-02T15:04:05.000Z"
}

reembolsos son las llamadas que no se cobraron (sin datos, error o caché). tarifas solo trae los endpoints con un precio negociado; vacío significa que rige el precio de lista. Úsalo para vigilar el saldo desde tu backend y avisar antes de quedarte sin créditos.

Buenas prácticas

  • Usa la clave solo desde tu backend; nunca la expongas en el navegador ni en un repositorio público.
  • Rota la clave si sospechas que se filtró: revócala y genera una nueva.
  • Controla el consumo desde tu panel; cada consulta con datos descuenta los créditos que cuesta ese endpoint (1 en la mayoría).

Ver también errores y rate limits y la página de seguridad.

Última revisión: 2 de septiembre de 2026 · PlacApi opera desde Colombia. PlacApi no es una entidad oficial del Gobierno.

Contacto