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. Le flux Réception HTTP dans ArcGIS Velocity 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

Les exemples suivants utilisent le flux Réception HTTP :

  • 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 le flux Réception HTTP :

  • 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

Les paramètres du flux Réception HTTP sont présentés ci-après :

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

Indique si la journalisation des requêtes et réponses HTTP au format brut envoyées par Velocity est activée.

Remarque :

Activez ce paramètre dans le cadre d’un dépannage uniquement et désactivez-le à l’issue du dépannage. Une fois le paramètre activé, démarrez le flux. Les journaux de niveau débogage sont disponibles sur la page des journaux du flux. Contactez le support technique Esri pour obtenir de l’aide dans le cadre du dépannage, le cas échéant.

Booléen

Considérations et limitations

Les flux Réception HTTP qui utilisent l’authentification ArcGIS peuvent être partagés en écriture avec d’autres utilisateurs et groupes. Lorsqu’un flux Réception HTTP est partagé en écriture, les utilisateurs et les groupes avec lesquels il est partagé peuvent y écrire des données. Ne partagez pas un flux avec activation des privilèges en écriture si vous ne souhaitez pas que d’autres utilisateurs et groupes y écrivent des données. Vous pouvez activer et désactiver les privilèges en écriture sur la page des détails du flux, dans Velocity. Pour plus d’informations, reportez-vous à la rubrique Partager des flux.