Conntodo Developers

Obtén tus credenciales. El equipo Conntodo te entrega la X-App-Key de tu aplicación (identidad pública, no es un secreto de autenticación), un usuario de la plataforma y un workspace sandbox con datos sintéticos para integrar sin tocar producción.

Headers obligatorios. Todas las llamadas llevan:

Autentícate en dos pasos — valida el email (devuelve los workspaces de tu app) y luego haz login sobre uno:

curl -X POST https://api.conntodo.com/api/v1/validate \
  -H "Content-Type: application/json" -H "X-App-Key: $APP_KEY" \
  -d '{"email":"integrador@tuempresa.com"}'

curl -X POST https://api.conntodo.com/api/v1/login \
  -H "Content-Type: application/json" -H "X-App-Key: $APP_KEY" \
  -H "X-Workspace-ID: 42" \
  -d '{"email":"integrador@tuempresa.com","password":"…"}'
# → data.token (Bearer, 15 días; renovable)

Entiende el contrato de respuesta. Un único envelope en éxito y error; el error_code es estable — discrimina causas por él, nunca parseando message:

// Éxito                                   // Error
{                                          {
  "status": "success",                       "status": "error",
  "code": 200,                               "code": 403,
  "data": { … },                             "error_code": "MODULE_NOT_IN_PLAN",
  "message": "…"                             "message": "…"
}                                          }

Importa la colección Postman (con el environment sandbox): 178 requests con los headers ya inyectados. Variables a fijar: baseUrl, app_key, bearerToken, workspace_id.

Solicita tu credencial al equipo Conntodo indicando el workspace y los scopes necesarios. Recibirás un client_id y un client_secret (este último se muestra una sola vez).

Obtén un token con el grant client_credentials:

curl -X POST https://api.conntodo.com/oauth/token \
  -H "Content-Type: application/json" \
  -d '{
    "grant_type": "client_credentials",
    "client_id": "TU_CLIENT_ID",
    "client_secret": "TU_CLIENT_SECRET",
    "scope": "processes.read"
  }'
# → { "access_token": "…", "token_type": "Bearer", "expires_in": … }

Consume la superficie /api/v1/m2m con el Bearer. Sin headers de workspace — el binding de la credencial manda:

curl https://api.conntodo.com/api/v1/m2m/processes \
  -H "Authorization: Bearer {access_token}"