Documentation · Modèle de données

Entités à plat et entités imbriquées

Les mêmes données existent sous deux formes. Dans le fichier à plat, chaque entité occupe sa propre ligne et renvoie aux autres par leur ID. Dans le fichier imbriqué, chaque partie inscrite contient ses inscriptions, de sorte qu’une seule ligne raconte toute l’histoire.

Les entités à plat se trouvent dans entities.ftm.json. Les entités imbriquées se trouvent dans targets.nested.json. Les deux formes sont publiées pour chaque collection; consultez Utiliser les données en vrac. Le point d’accès de fiche de l’API (/api/entity) renvoie par défaut une fiche dans sa forme propre, les autres fiches de la même partie étant énumérées sous related. Ajoutez format=ftm pour obtenir la même fiche au format FollowTheMoney, à plat ou imbriquée; consultez Depuis l’API.

L’exemple ci-dessous est le navire PELIKAN (IMO 6922169), interdit d’accès aux ports de la région du Mémorandum d’entente de Paris (fiche crown-380054154).

La forme à plat

Deux lignes : le navire, puis son inscription, qui renvoie au navire au moyen de entity.

{
  "id": "crown-380054154",
  "caption": "PELIKAN",
  "schema": "Vessel",
  "properties": {
    "name": [
      "PELIKAN"
    ],
    "topics": [
      "debarment"
    ],
    "alias": [
      "BALTIC ATLANT SHPG-LITHUANIA"
    ],
    "imoNumber": [
      "IMO6922169"
    ],
    "notes": [
      "IMO 6922169 · Flag: Comoros · From: 09/12/2009 · ISM: BALTIC ATLANT SHPG-LITHUANIA"
    ]
  },
  "referents": [],
  "datasets": [
    "paris_mou_banned"
  ],
  "first_seen": "2026-09-24T11:38:49.104591+00:00",
  "last_seen": "2026-09-24T11:38:49.104591+00:00",
  "last_change": "2026-09-24T11:38:49.104591+00:00",
  "target": true
}

{
  "id": "crown-380054154-sanction",
  "schema": "Sanction",
  "caption": "Banned from Paris MoU ports — Multiple detentions",
  "properties": {
    "entity": [
      "crown-380054154"
    ],
    "authority": [
      "Paris MoU Banned"
    ],
    "program": [
      "Banned from Paris MoU ports — Multiple detentions"
    ]
  },
  "datasets": [
    "paris_mou_banned"
  ],
  "first_seen": "2026-09-24T11:38:49.104591+00:00",
  "last_seen": "2026-09-24T11:38:49.104591+00:00",
  "last_change": "2026-09-24T11:38:49.104591+00:00"
}

Pour reconstituer le portrait complet à partir de fichiers à plat, conservez les entités dans une table de correspondance indexée par ID et suivez les références. C’est la forme la plus souple pour un chargement dans une base de données ou un graphe.

La forme imbriquée

Une ligne par partie inscrite. Ses inscriptions apparaissent dans une propriété sanctions qui contient les entités Sanction complètes :

{
  "id": "crown-380054154",
  "caption": "PELIKAN",
  "schema": "Vessel",
  "properties": {
    "name": [
      "PELIKAN"
    ],
    "topics": [
      "debarment"
    ],
    "alias": [
      "BALTIC ATLANT SHPG-LITHUANIA"
    ],
    "imoNumber": [
      "IMO6922169"
    ],
    "notes": [
      "IMO 6922169 · Flag: Comoros · From: 09/12/2009 · ISM: BALTIC ATLANT SHPG-LITHUANIA"
    ],
    "sanctions": [
      {
        "id": "crown-380054154-sanction",
        "schema": "Sanction",
        "caption": "Banned from Paris MoU ports — Multiple detentions",
        "properties": {
          "entity": [
            "crown-380054154"
          ],
          "authority": [
            "Paris MoU Banned"
          ],
          "program": [
            "Banned from Paris MoU ports — Multiple detentions"
          ]
        },
        "datasets": [
          "paris_mou_banned"
        ],
        "first_seen": "2026-09-24T11:38:49.104591+00:00",
        "last_seen": "2026-09-24T11:38:49.104591+00:00",
        "last_change": "2026-09-24T11:38:49.104591+00:00"
      }
    ]
  },
  "referents": [],
  "datasets": [
    "paris_mou_banned"
  ],
  "first_seen": "2026-09-24T11:38:49.104591+00:00",
  "last_seen": "2026-09-24T11:38:49.104591+00:00",
  "last_change": "2026-09-24T11:38:49.104591+00:00",
  "target": true
}

Les références de la partie ne sont pas développées

Dans FollowTheMoney, une partie peut renvoyer à d’autres entités, comme une adresse ou une pièce d’identité, et un fichier imbriqué placerait ces entités directement à l’intérieur. Nos parties ne renvoient encore à rien, car les adresses et les documents ne sont pas modélisés (éléments 9 et 22 de l’arriéré de données); il n’y a donc rien à développer.

Les inscriptions apparaissent comme une propriété de substitution

sanctions n’est pas une propriété que vous trouverez dans le fichier à plat. C’est l’inverse de Sanction:entity : toutes les entités Sanction qui renvoient à la partie y sont regroupées. Aujourd’hui, chaque fiche compte exactement une inscription; la liste contient donc une seule entité. Lorsque les fiches d’une même partie seront fusionnées entre registres, la liste contiendra une inscription par registre.

Entités de relation

Les liens de propriété, de famille et d’association ne sont pas encore publiés (élément 23 de l’arriéré de données); le fichier imbriqué ne contient donc aucune entité de relation.

Profondeur d’imbrication

Un seul niveau : la partie et ses inscriptions. Les entités Sanction qu’elles contiennent ne sont pas imbriquées davantage; leur propriété entity contient toujours l’ID de la partie.

Depuis l’API

Le point d’accès de fiche renvoie une fiche au format FollowTheMoney lorsque vous ajoutez format=ftm. Le paramètre nested détermine la forme :

<id> est un ID de fiche, tel qu’il est renvoyé dans le champ id des résultats de recherche et de correspondance. L’ID FollowTheMoney dans la réponse porte le préfixe crown- utilisé dans les fichiers en vrac.

curl "https://api.crownintelligence.net/api/entity?id=380818956&format=ftm&nested=true"

Exécuter cette requête

Les ID de fiche peuvent changer lorsqu’un registre est rechargé. Si l’exemple ne renvoie aucune fiche, prenez un nouvel ID dans /api/search?q=. Sans format=ftm, le point d’accès renvoie sa propre forme de fiche, décrite dans le guide API des entités.

Dernière mise à jour : 2026-10-04