Track details

Lorsque le destinataire ouvre ou clique sur votre e-mail, son adresse sera ajoutée à la liste des ouvertures et des clics, dans laquelle vous pouvez rechercher l'adresse souhaitée.

Adresse d'appel

Centre de données	URL
Singapour	https://email.api.engagelab.cc
Turquie	https://emailapi-tr.engagelab.com

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/track_details

Requête

URL

https://email.api.engagelab.cc/v1/track_details

              
              https://email.api.engagelab.cc/v1/track_details

Afficher ce bloc de code dans la fenêtre flottante

Méthode de requête HTTP

GET

GET

Afficher ce bloc de code dans la fenêtre flottante

En-tête

En-tête	Type	Obligatoire	Description
Authorization	string	true	Basic base64(api_user:api_key)

Description des paramètres de requête

paramètre	type	obligatoire ou non	description
time_zone	string	*	fuseau horaire, exemple : +8, par défaut +8
start_date	string	*	format de la date de début : `yyyy-MM-dd`
end_date	string	*	format de la date de fin : `yyyy-MM-dd`
email	string	*	en savoir plus sur l'adresse dans la liste
track_type	string	non	`1` signifie ouvertures, `2` signifie clics, aucun paramètre inclus signifie recherche des deux
api_users	string	non	obtenir les statistiques de l'API_USER spécifié ; plusieurs API_USER sont séparés par des points-virgules, ex. api_users=a;b;c
label_ids	string	non	obtenir les statistiques du label spécifié ; plusieurs labels sont séparés par des points-virgules, par exemple, label_ids=a;b;c
offset	int	non	position de départ, [0-], par défaut 0
limit	int	non	quantité, [0-100], par défaut 100

Exemple de requête :

curl -X GET -H 'Content-Type: application/json; charset=utf-8' -H 'Authorization:Basic YXBpX3VzZXI6YXBpX2tleQ==' 'https://email.api.engagelab.cc/v1/track-details?offset=0&limit=3'

              
              curl -X GET -H 'Content-Type: application/json; charset=utf-8' 
     -H 'Authorization:Basic YXBpX3VzZXI6YXBpX2tleQ==' 
     'https://email.api.engagelab.cc/v1/track-details?offset=0&limit=3'

Afficher ce bloc de code dans la fenêtre flottante

Description de la valeur retournée

paramètre	description
email	adresse e-mail
label_id	label_id de l'e-mail
track_type	ouvertures ou clics
url	url cliquée
api_user	nom de l'API_USER
curr_time	heure de l'ouverture ou du clic
ip	ip de l'ouverture ou du clic
country	pays de l'ip
province	province de l'ip
city	ville de l'ip
browser	navigateur de l'ouverture ou du clic
device	appareil de l'ouverture ou du clic

Exemple de valeur retournée :

{ "result": [ { "email": "opfwefs@gmail.com", "track_type": 1, "api_user": "sendcloud_op**s", "url": "", "curr_time": "2021-06-09 09:49:30", "email_id": "162320******_143833_116562_2325.sc-10_9_13_213-inbound0$ops@send.im", "ip": "47.190.78.5", "country": "United States", "province": "Texas", "city": "Southlake", "browser": "google", "device": "" } ], "count": 1, "total": 2 }

              
                 { 
   "result": [
        {
            "email": "opfwefs@gmail.com",
            "track_type": 1,
            "api_user": "sendcloud_op**s",
            "url": "",
            "curr_time": "2021-06-09 09:49:30",
            "email_id": "162320******_143833_116562_2325.sc-10_9_13_213-inbound0$ops@send.im",
            "ip": "47.190.78.5",
            "country": "United States",
            "province": "Texas",
            "city": "Southlake",
            "browser": "google",
            "device": ""
        }
    ],
    "count": 1,
    "total": 2
  }

Afficher ce bloc de code dans la fenêtre flottante

API de détails de suivi

Adresse d'appel

Requête