La API pública de Mind One permite integrar la plataforma con sistemas externos de forma programática. Está autenticada mediante API Keys (Bearer token) y sigue el estándar REST.

URL base 

https://api.getmindapp.io/api/v1/public

Autenticación

Todas las llamadas requieren una API Key en la cabecera Authorization:

Authorization: Bearer mk_xxxxxxxxxxxxxxxxxxxxxxxx

Las API Keys se generan desde Configuración Cuenta → API Keys en la plataforma. El prefijo mk_ identifica las claves de Mind One.

Formato de respuesta

Todas las respuestas siguen el mismo patrón:

{
  "data": [ ... ],
  "meta": {
    "total": 100,
    "page": 1,
    "pageSize": 20,
    "totalPages": 5
  }
}

Para respuestas de un único recurso, data contiene el objeto directamente en lugar de un array.

Paginación

Los endpoints que devuelven listas soportan paginación mediante query params:

ParámetroTipoDescripción
pagenumberNúmero de página (base 1). Por defecto: 1.
limitnumberÍtems por página. Máximo: 200. Por defecto: 20.

El objeto meta de la respuesta incluye:

CampoTipoDescripción
totalnumberTotal de ítems en el resultado
pagenumberPágina actual
pageSizenumberÍtems devueltos en esta página
totalPagesnumberTotal de páginas disponibles

Ejemplo:

GET /workspaces?page=2&limit=50

Códigos de estado HTTP

CódigoSignificado
200OK — Solicitud correcta
201Created — Recurso creado
204No Content — Eliminación correcta
400Bad Request — Datos de entrada inválidos
401Unauthorized — API Key ausente o inválida
403Forbidden — Sin permisos o cuenta suspendida
404Not Found — Recurso no encontrado
409Conflict — Conflicto (p. ej. clave duplicada)
429Too Many Requests — Rate limit alcanzado
500Internal Server Error — Error interno del servidor

Rate limiting

La API aplica límites de peticiones por API Key. Al superar el límite recibirás un 429 Too Many Requests.

Se recomienda implementar backoff exponencial en tus integraciones: espera un tiempo creciente entre reintentos en lugar de reintentar inmediatamente.

Ejemplos rápidos

Crear un workspace:

curl -X POST https://getmindapp.io/api/v1/public/workspaces \
  -H "Authorization: Bearer mk_tu_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Clientes",
    "description": "Datos maestros de clientes"
  }'

Listar workspaces:

curl "https://getmindapp.io/api/v1/public/workspaces?page=1&limit=20" \
  -H "Authorization: Bearer mk_tu_api_key"

Listar registros de un datagrid:

curl "https://getmindapp.io/api/v1/public/datagrids/{datagridId}/records?page=1&limit=50" \
  -H "Authorization: Bearer mk_tu_api_key"

Relacionado

  • Conexiones — Sincronización automática con data warehouses vía Autosync.
  • Usuarios y Roles — Solo el rol Admin puede generar API Keys.