Obtenir les données d'un endpoint à partir de son ID et de paramètres
Cette API permet de récupérer les données d'un endpoint à partir de son ID et de paramètres.
Requête
GET /api/v2/endpointData/?endpointID={endpointID}&dateFrom={dateFrom}&dateTo={dateTo}&maxCount={maxCount} HTTP/1.1
Host: gear.cloud.studio
Authorization: Bearer {accessToken}Paramètres
| Nom | Description |
|---|---|
| accessToken | Token d'accès disposant des permissions de lecture des informations d'endpoint. Consultez cette page pour plus d'informations. Le token d'accès peut également être envoyé dans la chaîne de requête, au moyen du paramètre « accessToken ». |
| endpointID | Identifiant obligatoire indiquant l'endpoint dont les données doivent être extraites. |
| dateFrom | Date à partir de laquelle les données de l'endpoint doivent être récupérées. |
| dateTo | Date jusqu'à laquelle les données de l'endpoint doivent être récupérées. |
| maxCount | Paramètre facultatif indiquant le nombre maximal d'enregistrements à inclure dans le résultat. Les valeurs supérieures à 500 sont limitées à 500, quelle que soit la valeur envoyée dans la requête. |
| Le paramètre « endpointID » est obligatoire : sans lui, l'API renvoie une erreur. |
|---|
Réponse
La réponse contient la liste des EndpointData correspondants, comme le montre cet exemple :
[
{
"EndpointID": 113653,
"Timestamp_UTC": "2021-10-15T22:51:19",
"Value": 18.91,
"SequenceNumber": 6683839
},
{
"EndpointID": 113653,
"Timestamp_UTC": "2021-10-15T23:01:25",
"Value": 16.93,
"SequenceNumber": 6683852
},
{
"EndpointID": 113653,
"Timestamp_UTC": "2021-10-15T23:11:28",
"Value": 16.97,
"SequenceNumber": 6683864
},
{
"EndpointID": 113653,
"Timestamp_UTC": "2021-10-15T23:41:36",
"Value": 16.93,
"SequenceNumber": 6683874
}
]Dernière mise à jour le
Type de données EndpointData
Introduction Le type de données EndpointData permet d'obtenir la configuration d'un endpoint. Voici toutes les propriétés du type de données EndpointData.
Obtenir la dernière donnée de plusieurs endpoints
Comment obtenir la dernière donnée de 5 appareils au maximum en un seul appel, pour afficher plusieurs capteurs en temps réel avec moins de trafic réseau.