Votre premier appel à l’API
Avec un jeton d’accès personnel, trouvez votre espace de travail, listez vos schémas et téléchargez une vue en SVG. Quatre requêtes.
Vous allez demander à l’API à qui appartient votre jeton, lister les schémas de votre espace de travail, en choisir un et télécharger l’une de ses vues en fichier SVG. Chaque requête est un appel HTTPS avec votre jeton dans un en-tête ; utilisez l’outil HTTP de votre choix. Les exemples portent sur le schéma Claims Platform d’Alex Morgan.
Obtenir un jeton (gratuit, sans IA)
Il vous faut un jeton d’accès personnel avec la portée cartouche.read. Il n’existe pas encore d’écran pour en créer un : écrivez à support@iyedy.com en indiquant à quoi il sert. Voir Créer et gérer des jetons d’API.
Gardez-le dans une variable d’environnement de votre terminal ou dans le coffre à secrets de votre outil, jamais dans un fichier que vous versionnez. Dans les requêtes ci-dessous, crt_pat_… représente votre jeton.
crt_pat_.Demander qui vous êtes (gratuit, sans IA)
GET /v1/token HTTP/1.1
Host: app.iyedy.com
Authorization: Bearer crt_pat_…
La réponse décrit le jeton : son nom, au nom de qui il agit, ses portées, son expiration, l’organisation dans tenantId, et les espaces de travail qu’il atteint dans workspaces, chacun avec id, name et role. Votre espace personnel s’appelle My diagrams dans l’API.
tenantId et l’id de l’espace de travail à lire.Lister vos schémas (gratuit, sans IA)
Placez les deux identifiants de l’étape 2 dans le chemin :
GET /v1/t/{tenantId}/w/{workspaceId}/diagrams HTTP/1.1
Host: app.iyedy.com
Authorization: Bearer crt_pat_…
La réponse liste les schémas que vous pouvez lire dans docs. Chacun a son identifiant dans did (d_ suivi de 10 caractères), son name et sa version.
did.Télécharger une vue (gratuit, sans IA)
Listez les vues du schéma :
GET /v1/t/{tenantId}/w/{workspaceId}/diagrams/{did}/views HTTP/1.1
Host: app.iyedy.com
Authorization: Bearer crt_pat_…
Chaque vue a un uid, un handle, un name et un type. Prenez la vue des conteneurs et demandez-la en SVG, avec son uid ou son handle :
GET /v1/t/{tenantId}/w/{workspaceId}/diagrams/{did}/views/{view}?format=svg HTTP/1.1
Host: app.iyedy.com
Authorization: Bearer crt_pat_…
Le SVG revient comme un fichier à enregistrer, par exemple containers.svg. Les autres formats sont mermaid, plantuml, drawio, et json pour la mise en page de la vue.
containers.svg s’ouvre dans votre navigateur et montre la vue des conteneurs de Claims Platform.Et ensuite
- Lancez les contrôles sur le schéma dans un pipeline, ou suivez ce qui dépend d’un élément : Vue d’ensemble de l’API.
- Ne donnez à chaque tâche que les portées dont elle a besoin : Portées.
- Gérez
429et les autres erreurs : Limites de débit et erreurs.
Ce tutoriel vous a-t-il aidé ?Réponse anonyme, comptée seulement si vous avez accepté la mesure.
Qu’est-ce qui n’a pas marché ?
N’écrivez pas de données personnelles.