Saltar al contenido principal

API pública de integración

La API pública de integración permite conectar sistemas externos con Deitu365 sin usar el portal admin. Está pensada para clientes Enterprise y escenarios MSP donde un ERP, CRM vertical, base corporativa o automatización propia necesita crear contactos, consultar importaciones o lanzar una sincronización.

No sustituye al portal admin. Es una superficie independiente y versionada bajo /public/v1 para integraciones autorizadas por el cliente.

Planes​

  • Trial, Basic y Pro: no disponible.
  • Enterprise: disponible por organización.
  • MSP/Enterprise: disponible por organización cliente.

Autenticación​

Las llamadas usan claves API por organización:

Authorization: Bearer deitu_live_xxxxxxxxxxxxxxxxx

Las claves se crean desde el portal admin en la sección API. El secreto solo se muestra una vez. Deitu365 guarda únicamente el hash de la clave.

Scopes​

  • contacts.read: consultar contactos.
  • contacts.write: crear, actualizar o retirar contactos.
  • imports.read: consultar resultados de importación.
  • sync.run: lanzar sincronización manual.

Endpoints v1​

GET /public/v1/status
GET /public/v1/contacts
POST /public/v1/contacts:upsert
DELETE /public/v1/contacts/{id}
GET /public/v1/imports/{id}
POST /public/v1/sync/run

Ejemplo de importación​

curl https://api.deitu365.com/public/v1/contacts:upsert \
  -H "Authorization: Bearer deitu_live_xxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "duplicateMode": "Update",
    "rows": [
      {
        "rowNumber": 1,
        "displayName": "Ana García",
        "email": "ana@example.com",
        "mobilePhone": "+34 600 000 000"
      }
    ]
  }'

Límites iniciales​

  • 60 requests por minuto y clave.
  • 1000 filas por request.
  • 10.000 filas importadas al día por organización.

La importación reutiliza la validación, deduplicación e histórico de importaciones del directorio. Después de importar contactos, puedes lanzar /public/v1/sync/run si el intervalo del plan lo permite.

Diferencia con el conector API genérica​

El conector API genérica JSON permite que Deitu365 lea contactos desde una API externa configurada en el portal.

La API pública de integración permite que un sistema externo llame a Deitu365 para crear o actualizar contactos.