Transmission de données via Gundi
L'API de Gundi est conçue pour permettre aux fournisseurs de données de transmettre des données destinées à diverses plates-formes prises en charge (par exemple, EarthRanger , SMART, Movebank et wpsWatch).
Authentification
Cette API utilise l'authentification par clé API. Pour vous authentifier, vous devez obtenir une clé API à partir de la connexion créée via le portail Gundi.
Clé API
Une fois que vous avez obtenu la clé du portail Gundi ou de notre équipe d'assistance, incluez-la dans vos requêtes sous forme d'en-tête au format apikey: YOUR_API_KEY. L'API vérifiera la clé à chaque requête afin de confirmer vos droits d'accès et d'identifier la connexion concernée. Les requêtes sans clé, invalides ou expirées seront refusées avec une réponse d'erreur appropriée. Veillez à conserver votre clé API en lieu sûr et à ne pas la partager publiquement, car elle donne accès à des données et opérations potentiellement sensibles.
apikey:
{{VOTRE_CLÉ_API}}
Événements
Les événements peuvent être utilisés pour des rapports, des alertes, des incidents ou tout événement nécessitant une sensibilisation ou une action.
https://sensors.api.gundiservice.org/v2/events/
Publication d'événements
Utilisez le point de terminaison des événements pour partager des informations sur les événements. Les événements peuvent être utilisés pour les rapports, les alertes, les incidents ou tout événement nécessitant une attention ou une action.
Le tableau suivant décrit les propriétés essentielles d’une charge utile d’événement.
Attribut | Description | Requis |
---|---|---|
source |
Identifie un appareil unique associé à l'événement. | Non |
title |
Une chaîne de caractères conviviale comme titre de l'événement. Apparaît dans le flux d'événements et la vue cartographique d' EarthRanger . | Oui |
event_type |
Représente le type d'événement EarthRanger approprié ou la catégorie SMART correspondant au rapport. | Oui |
recorded_at |
Un horodatage incluant un fuseau horaire, recommandé au format ISO (par exemple, 2023-07-27T09:34-03:00 ou 2023-07-27T09:34Z). | Oui |
location |
Un dictionnaire avec les coordonnées lon (longitude) et lat (latitude) pour indiquer le lieu de l'événement. Les valeurs lon et lat sont exprimées en degrés décimaux selon le système WGS-84. | Oui |
event_details |
Un dictionnaire de propriétés d'événement correspondant au schéma du « type d'événement » associé (dans EarthRanger ) ou de la catégorie (dans SMART Connect). | Non |
L'exemple suivant illustre l'utilisation du point de terminaison /events/.
curl --location 'https://sensors.api.gundiservice.org/v2/events/' \
--header 'Content-Type: application/json' \
--header 'apikey:
{{API_KEY}}
Si l'opération réussit, notre API v2 vous fournira un identifiant d'objet, utilisable ultérieurement pour diverses mises à jour et cas d'utilisation. N'oubliez pas de noter cet {{OBJECT_ID}}
si vous prévoyez d'avoir besoin de cette fonctionnalité supplémentaire.
200 OK
{
"object_id": {{OBJECT_ID}},
"created_at": {{CREATED_AT}}
}
Mise à jour des événements
Pour mettre à jour un événement précédemment envoyé à l'API de Gundi, utilisez la méthode PATCH et incluez uniquement les propriétés que vous souhaitez modifier.
L'exemple suivant illustre la mise à jour de l'emplacement, du statut et d'une propriété supplémentaire d'un événement. Remplacez l'espace réservé {{OBJECT_ID}}
par l'ID unique obtenu à partir de la réponse de création de l'événement. Pour plus d'informations sur l'obtention de cet ID, reportez-vous à la section précédente.
curl --location --request PATCH 'https://sensors.api.gundiservice.org/v2/events/
{{API_KEY}}
Publier une image
Les images de pièges photographiques peuvent être jointes aux événements à l'aide du point de terminaison des pièces jointes.
Cet exemple illustre le processus de mise à jour d'un événement avec une image via l'API Gundi. Attention à l'espace réservé {{OBJECT_ID}}
dans le point de terminaison, qui doit être remplacé par la valeur obtenue à partir du résultat de la création de l'événement (voir « Publication d'événements »).
curl --location 'https://sensors.api.gundiservice.org/v2/events/
{{API_KEY}}
Si l'opération réussit, notre API vous fournira un identifiant d'objet, utilisable ultérieurement pour diverses mises à jour et cas d'utilisation. Notez cet identifiant si vous prévoyez d'utiliser cette fonctionnalité supplémentaire.
200 OK
{
"object_id": {{OBJECT_ID}},
"created_at": {{CREATED_AT}}
}
Observations
Les observations peuvent être utilisées pour suivre la faune, les gardes forestiers et les biens.
https://sensors.api.gundiservice.org/v2/observations/
Publication d'observations
Les données de mouvement peuvent être publiées via le point de terminaison d'observation. Ces observations permettent de suivre la faune, les gardes forestiers et les biens.
Le tableau suivant décrit les propriétés essentielles d’une charge utile de position.
Attribut | Description | Requis |
---|---|---|
source |
Un identifiant unique pour l'appareil signalant sa position. | Oui |
source_name |
Nom convivial pour l'appareil. S'il est omis, l'identifiant source sera utilisé par défaut. | Non |
subject_type |
Décrit l'entité suivie (par exemple, « ranger », « éléphant », « hélicoptère »). Dans EarthRanger , cela correspond au sous-type du sujet. | Non |
recorded_at |
Horodatage de l'enregistrement de la position, incluant le fuseau horaire. Utilisez le format ISO (par exemple, 2022-01-10T16:43:32Z) pour plus de cohérence. | Oui |
location |
Un dictionnaire contenant les coordonnées des points de suivi : lon (longitude) et lat (latitude) en degrés décimaux (WGS-84). | Oui |
additional |
Un dictionnaire pour les paires clé-valeur personnalisées spécifiques à l'appareil suivi, permettant le stockage de métadonnées supplémentaires au-delà des champs standard. | Non |
L'exemple suivant illustre l'utilisation du point de terminaison /observations/.
curl --location 'https://sensors.api.gundiservice.org/v2/observations/' \
--header 'Content-Type: application/json' \
--header 'apikey:
{{API_KEY}}