Règles

Centre de données et URL de base

Lors de l'utilisation de l'API REST, assurez-vous que le centre de données sélectionné correspond à l'URL de base appropriée.

POST/v1/mail/<module>

Format de requête API

https://email.api.engagelab.cc/v1/<module>/<action>

Module : nom du module fonctionnel, par exemple module mail, module addresslist.

Action : action de chaque module, par exemple send, add.

Code de retour de l'API

L'API retourne des données au format JSON. Exemple ci-dessous :

              
              # la requête a réussi
{
 
  "result": {}
}
# Échec de l'authentification
{
  "code": 30000,
  "message": "Authentication failed",
}

# Acquisition des données réussie
{
    
   "total": 28,
   "count": 28,
   "result": [
            {
                "label_id": 598802,
                "label_name": "xjm226",
                "create_time": "2022-11-10T15:47:05+0800",
                "update_time": "2022-11-10T15:47:05+0800"
            }
        ]
    
}

            

• httpStatus : 200
• result : Informations sur les données

Code de statut HTTP

Description du format d'adresse e-mail

Format de l'adresse e-mail : local_part@domain_part, composé de local_part, @ et domain_part. L'adresse e-mail valide doit respecter les règles suivantes :

• local_part@domain_part doit comporter au minimum 6 caractères et au maximum 128 caractères ;
• La longueur maximale de local_part est de 96 caractères et ne peut pas contenir le caractère @ ;
• domain_part ne peut contenir que a-zA-Z0-9 -. Il ne peut pas commencer ni se terminer par -. La longueur totale ne dépasse pas 255 caractères, et chaque segment ne dépasse pas 63 caractères. Le domaine de premier niveau ne peut contenir que 2 à 20 lettres anglaises majuscules ou minuscules ;

Dictionnaire des fuseaux horaires

Dictionnaire des fuseaux horaires du calendrier

Dictionnaire des paliers

Conditions de filtrage

Structure de la condition de filtrage

              
              {
    "condition": {
        "relation": "or",
        "items": [
            {
                "field_name": "createTime",
                "op": ">=",
                "value": "2021-10-11"
            },
            {
                "field_name": "Name",
                "op": "contain",
                "value": "left"
            }
        ]
    }
}

# Condition de filtrage : createTime >= '2021-10-11' ou Name contient 'left'

            

Explication des conditions de filtrage