Autenticación obligatoria
Todo endpoint privado requiere token Bearer. Las llaves API no se exponen en formularios públicos.
API
API básica para autenticación y captura de datos por grupo.
Esta página muestra una especificación inicial para integrar formularios, aplicaciones internas o sitios web con una API sencilla de Costa Rica Pymes.
Autenticación
Obtener token de acceso
La API básica utiliza autenticación por token. La aplicación cliente envía una llave API y recibe un token temporal para consumir los endpoints permitidos.
POST /api/v1/auth/token
Host: crpymes.com
Content-Type: application/json
{
"api_key": "crp_live_xxxxxxxxx",
"client_id": "mi-pyme"
}200 OK
{
"access_token": "eyJhbGciOi...",
"token_type": "Bearer",
"expires_in": 3600
}Captura de datos
Guardar datos por grupo
Cada registro se envía a un grupo. El grupo puede representar una sucursal, formulario, campaña, departamento o sistema interno.
POST /api/v1/groups/{group_id}/data
Host: crpymes.com
Authorization: Bearer {access_token}
Content-Type: application/json
{
"source": "landing-page",
"record_type": "lead",
"payload": {
"name": "Cliente de prueba",
"email": "cliente@empresa.com",
"message": "Necesito hosting y correo empresarial"
}
}201 Created
{
"id": "rec_1024",
"group_id": "comercio-local",
"status": "stored",
"created_at": "2026-06-28T18:30:00-06:00"
}Reglas básicas
Una API simple, segura y mantenible
Datos por grupo
La información se organiza por grupo para separar campañas, formularios, sucursales o procesos.
Respuesta clara
Cada solicitud devuelve estado, identificador del registro y fecha de creación para facilitar seguimiento.