Repérer les limites entre documents
Une ligne contenant trois tirets commence un nouveau document YAML. Trois points peuvent marquer la fin explicite d’un document. Ces marqueurs ne deviennent pas des propriétés JSON.
Chaque document est analysé séparément, dans l’ordre où il apparaît dans le fichier source.
Pourquoi le résultat est un tableau
Ne renvoyer que le premier document ferait perdre les suivants. Fusionner les documents dans un objet pourrait écraser des clés répétées. Un tableau garde les valeurs distinctes et leur ordre.
Par exemple, deux documents contenant chacun un champ service deviennent deux objets dans un tableau JSON. Vérifiez que l’API de destination attend bien un tableau plutôt qu’un objet unique ou du JSON délimité par des retours à la ligne.