API Géozones
getNearestZone
Anchor link toAppelée en interne depuis le SDK. Récupère les paramètres de la géozone la plus proche et la distance jusqu’à celle-ci. Enregistre également la localisation de l’appareil pour les notifications push géolocalisées.
POST https://api.pushwoosh.com/json/1.3/getNearestZoneParamètres de la requête
Anchor link to| Paramètre | Type | Requis | Description |
|---|---|---|---|
| application | string | Oui | Code d’application Pushwoosh |
| hwid | string | Oui | ID matériel de l’appareil utilisé dans la requête /registerDevice. |
| lat | string | Oui | Latitude de l’appareil. |
| lng | string | Oui | Longitude de l’appareil. |
Exemple de requête
Anchor link to{ "request": { "application": "APPLICATION_CODE", "hwid": "HWID", "lat": 10.12345, "lng": 28.12345 }}Exemple PHP
Anchor link to// Voir http://gomoob.github.io/php-pushwoosh/get-nearest-zone.html
use Gomoob\Pushwoosh\Model\Request\GetNearestZoneRequest;
// Crée l'instance de la requête$request = GetNearestZoneRequest::create() ->setHwid('HWID') ->setLat(10.12345) ->setLng(28.12345);
// Appelle le service web '/getNearestZone'$response = $pushwoosh->getNearestZone($request);
if ($response->isOk()) { print 'Nom de la zone : ' . $response->getResponse()->getName(); print 'Latitude : ' . $response->getResponse()->getLat(); print 'Longitude : ' . $response->getResponse()->getLng(); print 'Portée : ' . $response->getResponse()->getRange(); print 'Distance : ' . $response->getResponse()->getDistance();} else { print 'Oups, l\'opération a échoué :-('; print 'Code de statut : ' . $response->getStatusCode(); print 'Message de statut : ' . $response->getStatusMessage();}addGeoZone
Anchor link toAjoute une Géozone à une application spécifique.
POST https://api.pushwoosh.com/json/1.3/addGeoZoneParamètres de la requête
Anchor link to| Paramètre | Type | Requis | Description |
|---|---|---|---|
| auth | string | Oui | Jeton d’accès à l’API depuis le Panneau de Contrôle Pushwoosh. |
| application | string | Oui | Code d’application Pushwoosh |
| geozones | array | Oui | Paramètres de la Géozone sous forme de tableau JSON. |
| geozones.name | string | Oui | Nom de la Géozone. |
| geozones.lat | string | Oui | Latitude de la Géozone. |
| geozones.lng | string | Oui | Longitude de la Géozone. |
| geozones.cooldown | integer | Oui | Période de silence après l’envoi d’une notification (en secondes). |
| geozones.range | integer | Oui | Portée de la Géozone (en mètres, de 50 à 1000). |
| geozones.content | string ou object | Requis si presetCode est vide. | Contenu du message de la Géozone. |
| geozones.presetCode | string | Requis si content est vide. | Préréglage de push à utiliser à la place de content. |
| geozones.cluster | string | Non | Spécifiez null pour dissocier un cluster de la Géozone. |
| geozones.campaign | string | Non | Spécifiez null pour dissocier une campagne de la Géozone. Si omis, la valeur de la campagne reste inchangée. Note : A une priorité plus élevée que la campagne dans le préréglage. |
| geozones.timetable | object | Non | Définit les intervalles de l’horaire. |
Exemple de requête
Anchor link to{ "request": { "auth": "yxoPUlwqm............pIyEX4H", // Jeton d'accès à l'API depuis le Panneau de Contrôle Pushwoosh "application": "XXXXX-XXXXX", // Code d'application Pushwoosh "geozones": [{ "name": "Statue of George", // requis. Nom de la Géozone. "lat": "40.70087797", // requis. Latitude de la Géozone. "lng": "-73.931851387", // requis. Longitude de la Géozone. "cooldown": 60, // en secondes, requis. Période de silence après l'envoi d'une notification "range": 50, // en mètres, de 50 à 1000, requis. Portée de la géozone. "content": "Lorem ipsum dolor sit amet, consectetur adipiscing elit.", // ou objet "presetCode": "AAAAA-BBBBB", // optionnel. Le préréglage de push peut être utilisé à la place du contenu "cluster": "GEOZONE CLUSTER CODE", // optionnel. La période de cooldown du cluster sera appliquée "campaign": "CAMPAIGN_CODE", // optionnel. Spécifiez null pour dissocier la Campagne de la Géozone "timetable": { // optionnel "timezone": 1234, // en secondes "Mon": [ // jours disponibles : Mon, Tue, Wed, Thu, Fri, Sat, Sun. Envoi de push { "start": "04:11", "stop": "12:00" } ], "Sun": [ { // un ou deux intervalles "start": "01:11", "stop": "17:00" }, { "start": "18:01", "stop": "23:59" } ] } }] }}updateGeoZone
Anchor link toMet à jour les propriétés d’une Géozone.
POST https://api.pushwoosh.com/json/1.3/updateGeoZoneParamètres de la requête
Anchor link to| Paramètre | Type | Requis | Description |
|---|---|---|---|
| auth | string | Oui | Jeton d’accès à l’API depuis le Panneau de Contrôle Pushwoosh. |
| geoZoneId | string | Oui | ID de la Géozone provenant de la requête /addGeoZone. |
| name | string | Non | Nouveau nom de la Géozone. |
| cooldown | integer | Non | Cooldown à mettre à jour, en secondes. |
| status | integer | Non | 0 - désactivé, 1 - activé. |
| content | string | Non | Contenu pour la notification push de la Géozone. Ne peut pas être utilisé avec presetCode. |
| cluster | string | Non | Nouveau nom du cluster. Spécifiez null pour dissocier le cluster de la Géozone. |
| campaign | string | Non | Nouvel ID de campagne. Spécifiez null pour dissocier la Campagne de la Géozone. Si omis, la valeur de la Campagne ne sera pas modifiée. A une priorité plus élevée qu’une Campagne d’un préréglage. |
| lat | number | Non | Latitude de la Géozone. |
| lng | number | Non | Longitude de la Géozone. |
| range | integer | Non | Nouvelle portée en mètres. |
| timetable | object | Non | Horaire de la Géozone. Voir plus d’informations ci-dessous. |
Exemple de requête
Anchor link to{ "request": { "auth": "yxoPUlwqm............pIyEX4H", // requis, jeton d'accès à l'API depuis le Panneau de Contrôle Pushwoosh "geoZoneId": 100016750, // requis, depuis la méthode /addGeoZone "name": "new geozone name", // optionnel "cooldown": 222, // en secondes, optionnel "status": 0, // optionnel, 0 - désactivé, 1 - activé "presetCode": "BBBBB-AAAAA", // optionnel, ne peut pas être utilisé avec "content" "content": "new geozone content", // optionnel, ne peut pas être utilisé avec "presetCode" "cluster": "GEOZONE CLUSTER CODE", // optionnel. Spécifiez null pour dissocier le cluster de la Géozone "campaign": "CAMPAIGN_CODE", // optionnel. Spécifiez null pour dissocier la Campagne de la Géozone "lat": 10.56, // optionnel, latitude de la géozone "lng": 12.523, // optionnel, longitude de la géozone "range": 500, // optionnel, portée de la géozone "timetable": { // optionnel "timezone": 1234, // en secondes "Mon": [ // jours disponibles : Mon, Tue, Wed, Thu, Fri, Sat, Sun. Envoi de push { "start": "04:11", "stop": "12:00" } ], "Sun": [ { // un ou deux intervalles "start": "01:11", "stop": "17:00" }, { "start": "18:01", "stop": "23:59" } ] } }}deleteGeoZone
Anchor link toSupprime les Géozones de l’application.
POST https://api.pushwoosh.com/json/1.3/deleteGeoZoneParamètres de la requête
Anchor link to| Paramètre | Type | Requis | Description |
|---|---|---|---|
| auth | string | Oui | Jeton d’accès à l’API depuis le Panneau de Contrôle Pushwoosh. |
| application | string | Oui | Code d’application Pushwoosh |
| geozones | string | Oui | Tableau d’ID ou un ID unique d’une Géozone à supprimer. |
Exemple de requête
Anchor link to{ "request": { "auth": "yxoPUlwqm............pIyEX4H", // requis, jeton d'accès à l'API depuis le Panneau de Contrôle Pushwoosh "application": "XXXXX-XXXXX", // requis, code d'application Pushwoosh "geozones": [550, 526] // requis, IDs des géozones }}addGeoZoneCluster
Anchor link toAjoute un Cluster de Géozones à l’application.
POST https://api.pushwoosh.com/json/1.3/addGeoZoneClusterParamètres de la requête
Anchor link to| Paramètre | Type | Requis | Description |
|---|---|---|---|
| auth | string | Oui | Jeton d’accès à l’API depuis le Panneau de Contrôle Pushwoosh. |
| application | string | Oui | Code d’application Pushwoosh |
| name | string | Oui | Nom du cluster. |
| cooldown | integer | Oui | Un délai avant qu’un utilisateur unique puisse recevoir le même message du Cluster de Géozones, en secondes. |
Exemple de requête
Anchor link to{ "request": { "auth": "yxoPUlwqm............pIyEX4H", // requis, jeton d'accès à l'API depuis le Panneau de Contrôle Pushwoosh "application": "XXXXX-XXXXX", // requis, code d'application Pushwoosh "name": "Raccoon city", // requis, nom du cluster "cooldown": 3210 // requis, en secondes }}deleteGeoZoneCluster
Anchor link toSupprime un Cluster de Géozones de l’application.
POST https://api.pushwoosh.com/json/1.3/deleteGeoZoneClusterParamètres de la requête
Anchor link to| Paramètre | Type | Requis | Description |
|---|---|---|---|
| auth | string | Oui | Jeton d’accès à l’API depuis le Panneau de Contrôle Pushwoosh. |
| application | string | Oui | Code d’application Pushwoosh |
| geoZoneCluster | string | Oui | ID du cluster de Géozones à supprimer. |
Exemple de requête
Anchor link to{ "request": { "auth": "yxoPUlwqm............pIyEX4H", // requis, jeton d'accès à l'API depuis le Panneau de Contrôle Pushwoosh "application": "XXXXX-XXXXX", // requis, code d'application Pushwoosh "geoZoneCluster": "EA1CE-69405" // requis, ID du cluster obtenu depuis la requête /addGeoZoneCluster }}listGeoZones
Anchor link toRécupère une liste des Géozones pour l’application.
POST https://api.pushwoosh.com/json/1.3/listGeoZonesParamètres de la requête
Anchor link to| Paramètre | Type | Requis | Description |
|---|---|---|---|
| auth | string | Oui | Jeton d’accès à l’API depuis le Panneau de Contrôle Pushwoosh. |
| application | string | Oui | Code d’application Pushwoosh |
Exemple de requête
Anchor link to{ "request": { "auth": "yxoPUlwqm............pIyEX4H", // requis, jeton d'accès à l'API depuis le Panneau de Contrôle Pushwoosh "application": "XXXXX-XXXXX" // requis, code d'application Pushwoosh }}listGeoZoneClusters
Anchor link toRécupère une liste des clusters de Géozones pour l’application.
POST https://api.pushwoosh.com/json/1.3/listGeoZoneClustersParamètres de la requête
Anchor link to| Paramètre | Type | Requis | Description |
|---|---|---|---|
| auth | string | Oui | Jeton d’accès à l’API depuis le Panneau de Contrôle Pushwoosh. |
| application | string | Oui | Code d’application Pushwoosh |
Exemple de requête
Anchor link to{ "request": { "auth": "yxoPUlwqm............pIyEX4H", // requis, jeton d'accès à l'API depuis le Panneau de Contrôle Pushwoosh "application": "XXXXX-XXXXX" // requis, code d'application Pushwoosh }}