Integración Confluence

Las integraciones de Confluence importan páginas y espacios para usarlos como artefactos. Debes habilitar Confluence a nivel de instancia primero—consulta la guía del operador: Configuración de Confluence. Si la integración requiere OAuth, usa los endpoints de OpenID y OAuth.

Solicitud básica y respuesta

Obtén la configuración con GET /api/v1/app/integration/confluence/{integrationId}/config.

curl "https://{BASE_URL}/api/v1/app/integration/confluence/{integrationID}/config" \
  -H "Authorization: Bearer {API_TOKEN}"
  -H "x-org: {org_slug}"

Ejemplo de respuesta

{
  "space_key": "SUP",
  "base_url": "https://confluence.auroralabs.com"
}

Iniciar sincronización

curl -X POST "https://{BASE_URL}/api/v1/app/integration/confluence/{integrationID}/ingest" \
  -H "Authorization: Bearer {API_TOKEN}" \
  -H "x-org: {org_slug}" \
  -H "Content-Type: application/json" \

Ejemplo de respuesta

{
  "type": "sync_started",
  "current_artifact_count": 42,
  "integration_item_count": 120
}

Endpoints ConfluenceLocal

Usa estos endpoints cuando tu despliegue utilice el proveedor confluencelocal con credenciales basic-auth.

Crear una integración ConfluenceLocal

curl -X POST "https://{BASE_URL}/api/v1/app/integration/confluencelocallegacy" \
  -H "Authorization: Bearer {API_TOKEN}" \
  -H "x-org: {org_slug}" \
  -H "Content-Type: application/json" \
  -d '{
    "username": "{user}",
    "password": "{password}"
  }'

Actualizar una integración ConfluenceLocal

Parametros del endpoint

Tipo	Nombre	Obligatorio	Notas
Path	`integrationID`	Si	Identificador de la integración.
Body	`username`	Si	Usuario de ConfluenceLocal.
Body	`password`	Si	Contraseña de ConfluenceLocal.

curl -X POST "https://{BASE_URL}/api/v1/app/integration/confluencelocallegacy/{integrationID}" \
  -H "Authorization: Bearer {API_TOKEN}" \
  -H "x-org: {org_slug}" \
  -H "Content-Type: application/json" \
  -d '{
    "username": "{user}",
    "password": "{password}"
  }'

Obtener la configuración ConfluenceLocal

curl "https://{BASE_URL}/api/v1/app/integration/confluencelocallegacy/{integrationID}/config" \
  -H "Authorization: Bearer {API_TOKEN}"
  -H "x-org: {org_slug}"

Iniciar ingest de ConfluenceLocal

curl -X POST "https://{BASE_URL}/api/v1/app/integration/confluencelocallegacy/{integrationID}/ingest" \
  -H "Authorization: Bearer {API_TOKEN}" \
  -H "x-org: {org_slug}" \
  -H "Content-Type: application/json" \

Ejemplo de respuesta de integración

{
  "id": "int_6d9a2b4c5e7f",
  "user_id": "user_4b7c2a1d9e5f3c8b",
  "org_id": "org_2f3a9d1c7b5e4a8f",
  "type": "ConfluenceLocalLegacy",
  "provider_data": {
    "username": "confluence_service"
  },
  "created_at": "2026-03-01T11:00:00Z",
  "updated_at": "2026-03-01T11:00:00Z"
}

Errores comunes

Usar endpoints de Confluence con OAuth sobre IDs de integración confluencelocal.
Omitir campos JSON (username, password) en crear/actualizar.
Lanzar la ingestión antes de guardar la configuración de la integración.

Errores y casos límite

403: integración no habilitada o sin permisos.
404: integración no encontrada.

Primeros pasos

Construye con Zylon

Coding Agents

Integración Confluence

Solicitud básica y respuesta

Iniciar sincronización

Endpoints ConfluenceLocal

Crear una integración ConfluenceLocal

Actualizar una integración ConfluenceLocal

Obtener la configuración ConfluenceLocal

Iniciar ingest de ConfluenceLocal

Errores comunes

Errores y casos límite

​Solicitud básica y respuesta

​Iniciar sincronización

​Endpoints ConfluenceLocal

​Crear una integración ConfluenceLocal

​Actualizar una integración ConfluenceLocal

​Obtener la configuración ConfluenceLocal

​Iniciar ingest de ConfluenceLocal

​Errores comunes

​Errores y casos límite

Solicitud básica y respuesta

Iniciar sincronización

Endpoints ConfluenceLocal

Crear una integración ConfluenceLocal

Actualizar una integración ConfluenceLocal

Obtener la configuración ConfluenceLocal

Iniciar ingest de ConfluenceLocal

Errores comunes

Errores y casos límite