Usage et contraintes

« Publication de données API » détermine quel tableau du flux un consommateur externe reçoit. Ajoutez-le depuis « API : recevoir et publier des données » et sélectionnez une connexion REST API avec la direction « Publier les données du flux ». Connectez le résultat voulu à son entrée : sortie d’une transformation, branche sélectionnée d’un routeur ou données écrites par une destination.

Le bloc termine sa branche, n’a pas de sorties et ne modifie pas les valeurs du tableau. Un flux peut contenir un seul bloc de publication. Un point de publication appartient à un seul flux publié ; créez un flux distinct pour un autre point. Les points occupés ne sont pas disponibles comme nouvelles connexions libres.

Connexion et mode de diffusion

La connexion définit l’adresse, la version API, le format JSON/JSON Lines/CSV/XML, l’accès public et la limite par page. Les propriétés du bloc affichent l’adresse complète et le lien de référence technique. Le bloc définit lui-même le comportement de réponse et les paramètres.

« Résultats enregistrés de la dernière exécution » diffuse un tableau existant de la dernière exécution Production terminée. GET n’exécute pas le flux ; une planification ou un autre déclencheur maintient l’actualité des données. « Exécuter le flux à chaque requête » exécute Production et attend de 1 à 120 secondes. Un réglage de réutilisation de 0 à 3 600 secondes permet de lire un résultat terminé pour une requête identique. Zéro désactive la réutilisation des résultats terminés.

Filtres et paramètres d’exécution

Ajoutez jusqu’à 20 paramètres API selon les besoins. Pour chacun, définissez le nom, la description, l’usage, le champ cible ou paramètre d’exécution, le type et le caractère obligatoire. Les noms commencent par une lettre latine et contiennent au maximum 40 lettres latines, chiffres ou traits de soulignement ; offset, limit et run sont réservés.

Un filtre sélectionne les résultats selon un texte, un nombre ou une date. Les valeurs autorisées limitent la sélection ; les sélections multiples répètent le nom du paramètre dans l’URL. Une plage inclusive utilise les suffixes _from et _to. Tous les filtres s’appliquent à l’ensemble des données avant pagination. Un paramètre d’exécution est disponible uniquement en mode à la demande et alimente le paramètre correspondant du flux.

Publication, accès et vérification

Enregistrez et publiez le flux. Pour des résultats enregistrés, terminez une première exécution ; sans elle, aucun jeu de données n’existe à lire. Accordez « Lecture » au client API ; pour l’exécution à la demande, vérifiez le droit d’exécution du propriétaire sur le flux. L’accès public est activé séparément dans la connexion : les données peuvent alors être lues sans clé, ne publiez donc qu’un jeu de données approuvé pour cet usage.

Vérifiez un GET de contrôle, le nombre de lignes filtrées et la page suivante. Si l’exécution continue, la réponse 202 inclut next ; demandez cette adresse après Retry-After en conservant run.id. Les paramètres inconnus sont rejetés. Pour 404, vérifiez qu’un résultat terminé existe ; pour 409, vérifiez l’état de publication ou l’actualité des données. Des exemples détaillés figurent dans la configuration de la publication API.