La API externa de SmartPyme usa autenticación mediante API Key. Incluyes tu clave como token Bearer en el encabezado Authorization de cada solicitud: no se involucran tokens de sesión, cookies ni flujos OAuth. Todas las solicitudes deben autenticarse; la API no expone ningún endpoint público.
Cómo obtener tu API Key
Tu API Key se genera por empresa dentro de la aplicación web de SmartPyme. Sigue estos pasos para obtenerla:
- Inicia sesión en app.smartpyme.site.
- Haz clic en el nombre de tu empresa en la esquina superior derecha y luego ve a Configuraciones (Settings).
- Navega a la pestaña Mi cuenta → Integraciones.
- Copia la API Key que se muestra en esa página.
Cómo usar tu API Key
Incluye tu API Key como token Bearer en el encabezado Authorization de cada solicitud. No se requieren otros encabezados para la autenticación.
curl -H "Authorization: Bearer YOUR_API_KEY" \
"https://api.smartpyme.site/api/external/v1/sales"
Respuestas de error
Si tu API Key es inválida, está ausente o la empresa asociada está inactiva, la API devuelve HTTP 401 con el siguiente cuerpo:
{
"success": false,
"error": "API key inválido o empresa inactiva",
"code": 401
}
Mantén tu API Key en privado. Otorga acceso a todos los datos de ventas e inventario de tu empresa. No la incluyas en código fuente ni la expongas públicamente.
Cada API Key está vinculada a una única empresa. Si administras varias empresas, cada una tiene su propia clave.
