Messages
Post /statistics/messages
Paramètres :
Nom | Description | Type | Obligatoire |
---|---|---|---|
page | Numéro de la page | Int | Non |
pageSize | Nombre d'éléments à retourner | Int | Non |
dateBegin | Date de début au format yyyy-MM-ddThh:mm:ssZ | Int | Non |
dateEnd | Date de fin au format yyyy-MM-ddThh:mm:ssZ | Int | Non |
froms | Email(s) de l'expéditeur | Array | Non |
apiKeys | Tableau de clés Api | Array | Non |
tags | Tableau de tags | Array | Non |
Réponse :
Nom | Description | Type | |||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
id | Id du message | String | |||||||||||||||
apiKey | Clé APi utilisée pour envoyer l'email | String | |||||||||||||||
createdDate | Date en timestamp | Int | |||||||||||||||
lastStateDate | Date du dernier status en timestamp | Int | |||||||||||||||
msg |
|
Object | |||||||||||||||
tags |
|
Array | |||||||||||||||
lastState | Dernier status de l'email | Int | |||||||||||||||
meta |
|
Object | |||||||||||||||
reason | reason | null | |||||||||||||||
open | ouvertures | INT | |||||||||||||||
click | clic | INT | |||||||||||||||
openDetails |
|
Array | |||||||||||||||
ClickDetails |
|
Array |
Langage de programmation :
Exemple de requête :
{ "dateBegin":"2019-06-10T12:50:04", "dateEnd":"2019-06-12T12:50:04", "tags":["welcome"] }
Exemple de réponse :
{ "messages": [ { "id": "5d00f65e99321602e57d89ae", "apiKey": "YOUR_API_KEY", "createdDate": "2019-06-12T12:55:54.306+0000", "lastStateDate": "2019-06-12T12:55:55.829+0000", "msg": { "from": "tipimail@tipimail.com", "email": "recipient@tipimail.com", "subject": "email subject", "size": 7070 }, "tags": [ "documentation", "support" ], "lastState": "delivered", "meta": {}, "reason": null, "open": 0, "click": 0, "openDetails": [], "clickDetails": [] }, { "id": "5d00f4fc9932583ad076d962", "apiKey": "YOUR_API_KEY", "createdDate": "2019-06-12T12:50:02.345+0000", "lastStateDate": "2019-06-12T12:50:04.111+0000", "msg": { "from": "checker@tipimail.com", "email": "recipient@tipimail.com", "subject": "email subject", "size": 435 }, "tags": null, "lastState": "delivered", "meta": null, "reason": null, "open": 0, "click": 0, "openDetails": [], "clickDetails": [] } ], "total": 2 }
Exemple de code :
curl -X POST -d '{"dateBegin":"2019-06-12T12:50:04","tags":["welcome","password"]}' -H "Content-Type: application/json" -H "X-Tipimail-ApiUser:YOUR_SMTP_USERNAME" -H "X-Tipimail-ApiKey:YOUR_SMTP_KEY" https://api.tipimail.com/v1/statistics/messages
require 'vendor/autoload.php'; $tipimail = new Tipimail\Tipimail('YOUR_SMTP_USERNAME', 'YOUR_API_KEY'); try { $page = null; $pageSize = null; $dateBegin = null; $dateEnd = null; $froms = null; $apiKeys = null; $tags = null; $result = $tipimail->getStatisticsService()->getMessages($page, $pageSize, $dateBegin, $dateEnd, $froms, $tags, $apiKeys); var_dump($result); } catch(Tipimail\Exceptions\TipimailException $e) { echo 'Exception received :', $e->getMessage(), "\n"; }
... public class Example { public static void main(String[] args) { Tipimail tipimail = new Tipimail("YOUR_SMTP_USERNAME", "YOUR_API_KEY"); try { nteger page = null; Integer pageSize = null; Integer dateBegin = null; Integer dateEnd = null; ArrayList<String> froms = null; ArrayList<String> tags = null; ArrayList<String> apiKeys = null; StatisticsMessages messages; messages = tipimail.getStatisticsService().getMessages(page, pageSize, dateBegin, dateEnd, froms, tags, apiKeys); } catch (TipimailException e) { } } }