Réception HTTP

Plutôt qu’un système IoT demandant des données externes, un processus courant consiste à diffuser des données à partir des périphériques de l’infrastructure IoT d’une organisation. Pour cela, il est possible d’utiliser des requêtes HTTP POST adressées à un serveur Web. ArcGIS Velocity, dans le cas présent. Le flux Réception HTTP crée une extrémité HTTP intégrée qui peut être utilisée pour envoyer via un programme des données à partir de périphériques et d’applications IoT à Velocity au moyen de requêtes HTTP POST.

Exemples

Voici des scénarios d’exemple pour lesquels les requêtes HTTP POST sont pratiques :

  • Les périphériques d’une organisation sont configurés pour diffuser des données vers une extrémité HTTP Velocity spécifiée par l’intermédiaire de requêtes POST.
  • Un analyste SIG écrit un script Python qui traite des entités et diffuse des données vers une extrémité HTTP Velocity spécifiée via une requête POST à chaque exécution du script.

Remarques sur l’utilisation

Tenez compte des points suivants lorsque vous utilisez des requêtes HTTP POST :

  • Envoyez les requêtes HTTP POST sous forme de texte simple.
  • Le flux Réception HTTP est configuré par l’utilisateur, y compris la structure et des champs clés. Une fois ce flux créé, l’URL est disponible sur la page de détails du flux, dans la section HTTP Endpoint Path (Chemin d’extrémité HTTP). Il s’agit de l’URL vers laquelle les données peuvent être diffusées à l’aide d’une requête HTTP POST.
  • Définissez le paramètre Authentication type (Type d’authenfication) sur ArcGIS pour utiliser l’authenfication OAuth 2.0. Chaque message entrant doit comporter un jeton valide pour le propriétaire du flux. Les messages sans jeton valide sont rejetés.
  • Après avoir configuré les paramètres de connexion du flux, consultez la rubrique Configurer les données en entrée pour savoir comment définir la structure et les champs clés.

Paramètres

La table suivante répertorie les paramètres de connexion du flux :

ParamètreExplicationType de données

Chemin d’extrémité HTTP

URL complète à utiliser pour envoyer les messages.

L’URL est générée et alimentée par Velocity une fois que le flux a démarré.

Chaîne

Type d’authentification

Indique le type d’authentification des messages entrants. Les options sont None (Aucun) et ArcGIS. Si None (Aucun) est spécifié, aucune authentification n’est effectuée. Si vous sélectionnez ArcGIS, chaque message entrant doit comporter un jeton valide pour le propriétaire du flux. Les messages sans jeton valide sont rejetés.

Le jeton doit figurer dans les en-têtes de requête sous la forme Authorization: Bearer <your token>.

Chaîne

Journalisation supplémentaire

Si besoin, activez la journalisation des requêtes et réponses HTTP au format brut émises par Velocity.

Remarque :

Ce paramètre ne doit être activé qu’à des fins de dépannage et doit être désactivé une fois le dépannage terminé. Une fois activé, lancez le flux. Les journaux de niveau débogage sont disponibles sur la page Journaux du flux. Si nécessaire, contactez le support technique Esri pour obtenir de l’aide dans le cadre du dépannage.

Booléen