Cómo autenticarte con la API externa de SmartPyme

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"

import requests

headers = {
    "Authorization": "Bearer YOUR_API_KEY"
}

response = requests.get(
    "https://api.smartpyme.site/api/external/v1/sales",
    headers=headers
)
print(response.json())

const response = await fetch(
  "https://api.smartpyme.site/api/external/v1/sales",
  {
    headers: {
      "Authorization": "Bearer YOUR_API_KEY"
    }
  }
);
const data = await response.json();
console.log(data);

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.

Visión general

Endpoints

Cómo autenticarte con la API externa de SmartPyme

Cómo obtener tu API Key

Cómo usar tu API Key

Respuestas de error

​Cómo obtener tu API Key

​Cómo usar tu API Key

​Respuestas de error

Cómo obtener tu API Key

Cómo usar tu API Key

Respuestas de error