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. 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.
  4. 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

Accès UID (préférable)

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 d’un service via l’API, utilisez l’identificateur unique de l’API Web (avec accès aux données du service) comme paramètre « UID » et envoyez une demande d’authentification à l’aide de l’exemple de contenu Post suivant :

{ 
"UID" : "4821737B71224A087641585F80BF8",
"Action": 1
}

Dans ce cas, le système répond avec la liste des numéros d’information de département disponibles.

{
    "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 près duquel vous souhaitez vous connecter et utilisez-le conjointement avec l’ID de l’API Web pour créer une demande d’authentification auprès du service. Utilisez l’exemple suivant :

{ 
"UID" : "4821737B71B22A087641585F80BF8"
 "Id" : "19357"
}

Nom d’utilisateur et mot de passe hérités (non recommandé, peut nécessiter l’identification du compte)

{
"username":"username",
"password":"password"
}

Réponse au succès

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