Les exemples de requêtes présentés dans cette rubrique utilisent la syntaxe Curl pour afficher toutes les informations requises dans une requête, notamment les en-têtes de requête, les méthodes, les points de terminaison et les données, ainsi que les paramètres obligatoires et facultatifs. En outre, pour chaque requête, les mêmes informations d’en-tête sont affichées dans un bloc distinct à utiliser lors de la connexion à l’API Data360 Govern via un client d’API.
1. Identifier l’UID du type de relation
- Accédez à la page .
- Recherchez la relation dans le panneau Types de relations et cliquez sur l’icône d’informations pour afficher la valeur UID « Type d’intersection ».
Dans cet exemple, la relation est « Rapports Fait référence à Investissements » et la valeur UID est 918d2b69-0275-48e0-8012-481b63c8f7d6.
2. Identifier le sujet et l’objet de la relation
Lorsque vous créez une relation via l’API, vous devez inclure l’UID du sujet et l’UID de l’objet dans votre requête.
- Accédez à la page de détails de l’asset Rapport que vous souhaitez définir comme sujet de la relation et copiez la valeur UID.
- Accédez à la page de détails de l’asset Investissement que vous souhaitez définir comme objet de la relation et copiez la valeur UID.
Par exemple :
- Sujet (asset Rapport « Rapport sur les investissements ») -
8dab72ca-5679-4144-8395-b1850ff39278 - Objet (asset Investissements « Investisseur 3 ») -
52ea5336-3377-46e8-837a-03f4ab9a5142
3. Publier une nouvelle relation
Utilisez le point de terminaison POST POST /api/v2/relationships/{intersectTypeUid} pour ajouter une nouvelle relation entre les assets spécifiés.
Exemple de requête
La valeur intersectTypeUID est la valeur UID du type de relation que vous avez obtenue à l’étape un.
curl -X POST --header 'Content-Type: application/json' --header 'Accept: application/json' -d '[ \ { \ "SubjectAssetUid": "8dab72ca-5679-4144-8395-b1850ff39278", \ "ObjectAssetUid": "52ea5336-3377-46e8-837a-03f4ab9a5142", \ "Fields": {} \ } \ ]' 'https://example.data3sixty.com/api/v2/relationships/918d2b69-0275-48e0-8012-481b63c8f7d6?triggerWorkflow=true'L’exemple suivant montre les informations d’en-tête pour la même requête à utiliser lors de la connexion à l’API Data360 Govern via un client d’API :
POST https://example.data3sixty.com/api/v2/dataquality/relationships/918d2b69-0275-48e0-8012-481b63c8f7d6?triggerWorkflow=true HTTP/1.1 Authorization: <API Key>;<API Secret> Content-Type: application/json Accept: application/jsonCorps de la requête :
[ { "SubjectAssetUid": "8dab72ca-5679-4144-8395-b1850ff39278", "ObjectAssetUid": "52ea5336-3377-46e8-837a-03f4ab9a5142", "Fields": {} } ]https://example.data3sixty.com/api/v2/dataquality/relationships/918d2b69-0275-48e0-8012-481b63c8f7d6?triggerWorkflow=trueCela signifie que l’ajout d’un nouveau lien déclenchera un workflow s’il existe des workflows conçus pour ajouter ou modifier un lien, et si toutes les autres conditions du workflow sont remplies.Exemple de réponse
[ { "ItemNumber": 1, "IntersectID": 6537, "Success": true, "IsNew": true, "uid": "63b5f8bf-a31a-4afe-ba58-2201fa38f5e4" } ]La relation récemment ajoutée s’affiche dans l’onglet Relations lors de la consultation de la page de détails du sujet ou de l’objet de la relation.