Si vous avez une application laquelle emploie le Newsman API et vous chargez / actualisez les abonnés de la base de donnes, nous pouvons vous notifier dans le moment où l’import c’est fini. Pour activer cette chose, vous devez avoir définie Webhook URL dans les configurations de la liste.
Pour l’adresse spécifiée dans les Configurations (webhook url) vous recevrez un request POST lequel contient un ou plusieurs Newsman Events.
Un event est composé par:
- Â type – le type de l’event (dans ce cas: import)
-  timestamp – (la date où l’event a eu place)
- Â data – array avec les donnes de type custom du chaque event
Pour l’event d’import, on envoie les donnes suivantes:
- Â import_id – l’ID de l’import
- Â status – du texte (finished/error)
L’appel fait par nous est un POST et contient un seul paramètre, newsman_events lequel contient un STRING codé comme JSON. Le string codé comme JSON est un array d’événements (un ou plusieurs Newsman événements).
Exemple de code PHP pour faire DEBUG aux événements:
<?php print_r($_POST); /* Array ( [newsman_events] => [{"type":"import","timestamp":1372428476,"data":{"import_id":"51cd98951fbbbf972d000001","status":"finished"}}] ) */ $newsman_events = json_decode($_POST["newsman_events"]); print_r($newsman_events[0]); /* Array ( [type] => import [timestamp] => 1372428476 [data] => Array ( [import_id] => 51cd98951fbbbf972d000001 [status] => finished ) ) */ ) ?> |
En utilisant la valeur de l’import_id on peut vérifier, par l’intermède de l’API, le status de l’import à l’aide de la méthode import.status.