Mise en route

Apprenez à récupérer vos capteurs et passerelles avec quelques requêtes.

Obtenez votre nom d'hôte de la plateforme

Ceci est le nom d'hôte que vous utilisez pour accéder à l'interface utilisateur ThingPark.

Si vous utilisez ThingPark Enterprise SaaS, cela correspond à :

• Communauté : community.thingpark.io
• Europe : thingparkenterprise.eu.actility.com
• Australie : thingparkenterprise.au.actility.com
• États-Unis : thingparkenterprise.us.actility.com

TypeScript

import axios from 'axios';

const platform_hostname = 'community.thingpark.io';

JavaScript

import axios from 'axios';

const platform_hostname = 'community.thingpark.io';

Bash

PLATFORM_HOSTNAME="community.thingpark.io"

Python

import requests

platform_hostname = 'community.thingpark.io'

Ajouter un compte de service

Voir Gestion des comptes de service dans le guide de l'utilisateur.

Notez l'ID client et le secret client du compte de service.

TypeScript

const client_id = 'sub-199983788/my-app';
const client_secret = 'JyqK3iQA6sVdMsmxe4kqPNYNaftrAgap';

JavaScript

const client_id = 'sub-199983788/my-app';
const client_secret = 'JyqK3iQA6sVdMsmxe4kqPNYNaftrAgap';

Bash

CLIENT_ID="sub-199983788/my-app"
CLIENT_SECRET="JyqK3iQA6sVdMsmxe4kqPNYNaftrAgap"

Python

client_id = 'sub-199983788/my-app'
client_secret = 'JyqK3iQA6sVdMsmxe4kqPNYNaftrAgap'

Émettre un jeton d'accès

Appelez le point de terminaison du jeton pour une autorisation par les identifiants du client.

TypeScript

const token = await axios.post(
    `https://${platform_hostname}/users-auth/protocol/openid-connect/token`,
    { client_id, client_secret, grant_type: 'client_credentials' },
    { headers: { 'content-type': 'application/x-www-form-urlencoded' } },
)

JavaScript

const token = await axios.post(
    `https://${platform_hostname}/users-auth/protocol/openid-connect/token`,
    { client_id, client_secret, grant_type: 'client_credentials' },
    { headers: { 'content-type': 'application/x-www-form-urlencoded' } },
)

Bash

ACCESS_TOKEN=$(curl \
-d "client_id=${CLIENT_ID}" \
-d "client_secret=${CLIENT_SECRET}" \
-d "grant_type=client_credentials" \
https://${PLATFORM_HOSTNAME}/users-auth/protocol/openid-connect/token | jq -r '.access_token')

Python

token = requests.post(
    f"https://{platform_hostname}/users-auth/protocol/openid-connect/token",
    data = { 'client_id': client_id, 'client_secret': client_secret, 'grant_type': 'client_credentials' },
    headers = { 'content-type': 'application/x-www-form-urlencoded' },
).json()

Récupérer les capteurs

Les capteurs sont paginés. Vous pourriez devoir demander les pages suivantes pour récupérer tous les capteurs. Voir pagination.

TypeScript

const devices = await axios.get(
    `https://${platform_hostname}/thingpark/wireless/rest/subscriptions/mine/devices`,
    { headers: { 'Authorization': `Bearer ${token.data.access_token}` } },
)

JavaScript

const devices = await axios.get(
    `https://${platform_hostname}/thingpark/wireless/rest/subscriptions/mine/devices`,
    { headers: { 'Authorization': `Bearer ${token.data.access_token}` } },
)

Bash

curl \
-H "Authorization: Bearer ${ACCESS_TOKEN}" \
-H "Accept: application/json" \
https://${PLATFORM_HOSTNAME}/thingpark/wireless/rest/subscriptions/mine/devices

Python

devices = requests.get(
    f"https://{platform_hostname}/thingpark/wireless/rest/subscriptions/mine/devices",
    headers = { 'Authorization': f"Bearer {token['access_token']}", 'Accept': 'application/json' },
).json()

Récupérer les passerelles

Les passerelles sont paginées. Vous pourriez devoir demander les pages suivantes pour récupérer toutes les passerelles. Voir pagination.

TypeScript

const base_stations = await axios.get(
    `https://${platform_hostname}/thingpark/wireless/rest/partners/mine/bss`,
    { headers: { 'Authorization': `Bearer ${token.data.access_token}` } },
)

JavaScript

const base_stations = await axios.get(
    `https://${platform_hostname}/thingpark/wireless/rest/partners/mine/bss`,
    { headers: { 'Authorization': `Bearer ${token.data.access_token}` } },
)

Bash

curl \
-H "Authorization: Bearer ${ACCESS_TOKEN}" \
-H "Accept: application/json" \
https://${PLATFORM_HOSTNAME}/thingpark/wireless/rest/partners/mine/bss

Python

base_stations = requests.get(
    f"https://{platform_hostname}/thingpark/wireless/rest/partners/mine/bss",
    headers = { 'Authorization': f"Bearer {token['access_token']}", 'Accept': 'application/json' },
).json()

Renouvellement de jeton

Pour une application de longue durée, vous pourriez devoir renouveler le jeton d'accès. Voir renouvellement de jeton.