Desarrolladores
CertifiCar para desarrolladores
Recursos legibles por máquina de certificar.co: los dos formularios del sitio, su contrato de errores y versionado, y dónde está la documentación de la aplicación transaccional.
Especificación OpenAPI
/openapi.json documenta los dos endpoints POST de este sitio (solicitud de demo y suscripción al boletín): esquema de cada campo, códigos de error tipados y ejemplos. Ambos exigen el mismo origen que el sitio, así que no son una API pública para integraciones de terceros sin navegador — la consulta de vehículos (el producto que se paga) vive aparte, en app.certificar.co.
Contrato: versionado, errores y límite de tasa
- Versionado: la cabecera de respuesta
API-Versionidentifica el contrato. Un cambio incompatible incrementa ese número; una baja se anuncia antes con las cabecerasDeprecationySunset. - Errores: toda respuesta de error es JSON
{ ok: false, error, errors? }, nunca una página HTML. - Límite de tasa: toda respuesta incluye
RateLimit-Limit,RateLimit-RemainingyRateLimit-Reset; una respuesta 429 añadeRetry-After.
Catálogo y descubrimiento
- /.well-known/api-catalog (RFC 9727): enlaza a la especificación OpenAPI anterior.
- /llms.txt: guía para agentes, incluye cuándo usar CertifiCar y estos mismos enlaces.
Aplicación transaccional
La consulta de vehículos por placa se compra y se lee en app.certificar.co. Su documentación de integración (login, compra de consulta, reporte de vehículos) está en docs.certificar.co, fuera de este repositorio.