Adición de identificador único de integración

Para configurar una integración con Dotcom-Monitor, debe tener acceso a una cuenta activa de Dotcom-Monitor y crear un identificador único de API web para usarlo en la solicitud de autenticación:

  1. Inicie sesión en la cuenta dotcom-monitor.
  2. En Dotcom-Monitor, cree un UID de integración en Configurar > integraciones > Agregar API web de integración > .
  3. Lista blanca de direcciones IP como se describe en el artículo Cómo incluir direcciones IP en la lista blanca para el acceso a la API web de nuestro wiki.
  4. Opcional:Si la cuenta maestra contiene departamentos y desea acceder y enviar solicitudes a la API de un departamento específico, en la ventana Agregar integración, seleccione Permitir acceso a los datos del departamento.
  5. Haga clic en Crear integración y copie el identificador único de la API web de la lista UED de integración en el portapapeles(API web (con acceso a los datos del departamento) en el caso del acceso al departamento).

Autenticación

URL de solicitud

Exponer https://api.dotcom-monitor.com/config_api_v1/login

Cuando inicia sesión en su cuenta a través de la llamada “/login”, comienza una nueva sesión de cliente. Las sesiones caducan automáticamente después de una duración predeterminada de la inactividad. El valor predeterminado es 1 minuto. Si realiza una llamada a la API, el temporizador de inactividad se restablece a cero.
Cuando expira la sesión, se devuelve el código de error HTTP de excepción “401 – Unauthorized”. Si esto sucede, debe volver a iniciar sesión de nuevo.

Después de la autorización, el cliente está siendo identificado por cookie, así que asegúrese de que las cookies están habilitadas.

Post Contenido

Utilice el identificador único de la API web como valor del parámetro UID (Configure > Integrations > Add Integration Web > API).

{
"UID":"1423e214d153d123123"
}

Acceso al ID del departamento

Para acceder a los datos del Departamento a través de la API, debe crear una integración de API web (con acceso a los datos del departamento). Utilice el identificador único correspondiente como parámetro UID junto con el par ” Acción”: 1 nombre/valor en la solicitud de autenticación.

Utilice el siguiente ejemplo de contenido Post:

{ 
"UID" : "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
"Action": 1
}

El sistema responderá con la lista de ID de departamentos disponibles. Vea el ejemplo JSON a continuación.

{
    "Success": true,
    "Result": [
        {
            "Name": "my_org",
            "HasCompany": true,
            "HasDepartment": true,
            "Qantity": 2,
            "Accounts": [
                {
                    "Id": 15530,
                    "Name": "my_org",
                    "CompanyName": "my company",
                    "Email": "email@gmail.com",
                    "Owner": true,
                    "Department": false,
                    "New": false
                },
                {
                    "Id": 19357,
                    "Name": "Admin",
                    "CompanyName": "my company",
                    "Email": "email111@gmail.com",
                    "Owner": true,
                    "Department": true,
                    "New": false
                }
            ]
        }
    ]
}

Copie el ID del departamento en el que desea iniciar sesión y utilícelo junto con el UID para crear una solicitud de autenticación al departamento.

Utilice el ejemplo Post que se proporciona a continuación.

{ 
"UID" : "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
 "Id" : "XXXX"
}

Donde ” UID”:”XXXXX…. XXX ” es su API web (con acceso a los datos del departamento) UID e ” Id”: “XXXX” es su ID de departamento.

Respuesta de éxito

{
"Success":true,
"Result":"OK"
}