Ajout d’un identificateur unique d’intégration

Pour configurer une intégration avec Dotcom-Monitor, vous devez avoir accès à un compte Dotcom-Monitor actif et créer un identifiant Web API Unique à utiliser dans la demande d’authentification :

  1. Connectez-vous au compte Dotcom-Monitor.
  2. Dans Dotcom-Monitor, créez un UID d’intégration sous Configurer les > intégrations Ajouter une API Web > d’intégration > .
  3. Liste blanche des adresses IP comme décrit dans l’article Comment mettre en liste blanche les adresses IP pour l’accès aux API Web de notre wiki.
  4. Facultatif: Si le compte principal contient des départements et que vous souhaitez accéder à l’API d’unservice spécifique et envoyer des demandes à celui-là, dans la fenêtre Ajouter une intégration, sélectionnez Autoriser l’accès aux données du service.
  5. Cliquez sur Créer une intégration et copiez l’identificateur unique de l’API Web à partir de la liste UID d’intégration dans le Presse-papiers(API Web (avec accès aux données du service) dans le cas de l’accès au service).

authentification

URL de la demande

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

Lorsque vous vous connectez à votre compte via l’appel «/login», une nouvelle session client commence. Les sessions expirent automatiquement après une durée d’inactivité prédéterminée. La valeur par défaut est de 1 minute. Si vous faites un appel API, la mise à zéro de la mise à zéro de la mise à zéro de la mise à zéro de la mise à l’heure de la période d’inactivité.
Lorsque votre session expire, le code d’erreur HTTP d’exception «401 – Non autorisé» est retourné. Si cela se produit, vous devez vous connecter à nouveau.

Après autorisation, le client est identifié par cookie, alors assurez-vous que les cookies sont activés.

Contenu POST

Utilisez l’identificateur unique de l’API Web comme valeur du paramètre UID (Configure > Integrations > Add Integration Web > API).

{
"UID":"1423e214d153d123123"
}

Accès à l’ID de service

Pour accéder aux données du département via l’API, vous devez créer une intégration d’API Web (avec accès aux données du département). Utilisez l’identifiant unique correspondant comme paramètre UID en conjonction avec la paire « Action » : 1 nom/valeur dans la demande d’authentification.

Utilisez l’exemple de contenu Post suivant :

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

Le système répondra avec la liste des ID de départements disponibles. Voir l’exemple JSON ci-dessous.

{
    "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
                }
            ]
        }
    ]
}

Copiez l’ID du service auquel vous souhaitez vous connecter et utilisez-le conjointement avec l’UID pour créer une demande d’authentification auprès du service.

Utilisez l’exemple Post fourni ci-dessous.

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

Où « UID »: »XXXXX…. XXX  » est votre API Web (avec accès aux données du département) UID et « Id » : « XXXX » est votre ID de département.

Réponse au succès

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