Una vez que reciba la clave del Portal de Gundi o de nuestro Equipo de Soporte, inclúyala en sus solicitudes como encabezado con el formato apikey: YOUR_API_KEY. La API verificará la clave en cada solicitud para confirmar sus derechos de acceso e identificar la conexión correspondiente. Las solicitudes que no incluyan una clave, o que incluyan una clave no válida o caducada, serán denegadas con un error. Asegúrese de mantener su clave API segura y no la comparta públicamente, ya que proporciona acceso a datos y operaciones potencialmente sensibles.

apikey: 

{{SU_CLAVE_API}}

Publicación de eventos

Utilice el punto de conexión de eventos para compartir información sobre eventos. Los eventos se pueden usar para informes, alertas, incidentes o cualquier evento que requiera conocimiento o acción.

La siguiente tabla describe las propiedades esenciales dentro de una carga útil de evento.

El siguiente ejemplo demuestra el uso del punto final /events/.

curl --location 'https://sensors.api.gundiservice.org/v2/events/' \
--header 'Content-Type: application/json' \
--header 'apikey: 

{{CLAVE_API}}

Si la operación se realiza correctamente, nuestra API v2 le proporcionará un ID de objeto, que podrá utilizar posteriormente para diversas actualizaciones y casos de uso. Asegúrese de anotar este {{OBJECT_ID}} si prevé necesitar la funcionalidad adicional.

200 OK
{ 
  "object_id": {{OBJECT_ID}}, 
  "created_at": {{CREATED_AT}} 
}

Actualización de eventos

Para actualizar un evento enviado previamente a la API de Gundi, utilice el método PATCH e incluya solo las propiedades que desee modificar.

El siguiente ejemplo ilustra la actualización de la ubicación, el estado y una propiedad adicional de un evento. Reemplace el marcador {{OBJECT_ID}} con el ID único obtenido de la respuesta de creación del evento. Para obtener más información sobre cómo obtener este ID, consulte la sección anterior.

curl --location --request PATCH 'https://sensors.api.gundiservice.org/v2/events/

{{CLAVE_API}}

Publicar una imagen

Es posible adjuntar imágenes de cámaras trampa a eventos mediante el punto final de archivos adjuntos.

Este ejemplo ilustra el proceso de actualización de un evento con una imagen mediante la API de Gundi. Preste atención al marcador {{OBJECT_ID}} en el endpoint, que debe sustituirse por el valor obtenido del resultado de la operación de creación del evento (consulte "Publicación de eventos").

curl --location 'https://sensors.api.gundiservice.org/v2/events/

{{CLAVE_API}}

Si la operación se realiza correctamente, nuestra API le proporcionará un ID de objeto, que podrá utilizar posteriormente para diversas actualizaciones y casos de uso. Asegúrese de anotar este ID de objeto si prevé necesitar la funcionalidad adicional.

200 OK
{
   "object_id": {{OBJECT_ID}},
   "created_at": {{CREATED_AT}}
}

Publicación de observaciones

Los datos de movimiento se pueden publicar mediante el punto de observación. Las observaciones se pueden usar para rastrear la fauna silvestre, los guardabosques y los recursos.

La siguiente tabla describe las propiedades esenciales dentro de una carga útil de posición.

El siguiente ejemplo demuestra el uso del punto final /observations/.

curl --location 'https://sensors.api.gundiservice.org/v2/observations/' \
--header 'Content-Type: application/json' \
--header 'apikey: 

{{CLAVE_API}}