{
    "info": {
        "name": "API Formation de Heyalink",
        "description": "Collection tirée de la spécification OpenAPI 1.13.0. Mettez votre clé d’essai (hl_formation_test_…) dans la variable « cle ». Powered by ● Oriq IA.",
        "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
    },
    "auth": {
        "type": "bearer",
        "bearer": [
            {
                "key": "token",
                "value": "{{cle}}",
                "type": "string"
            }
        ]
    },
    "variable": [
        {
            "key": "base",
            "value": "https://heyalink.com/api/formation/v1"
        },
        {
            "key": "cle",
            "value": "hl_formation_test_VOTRECLE"
        }
    ],
    "item": [
        {
            "name": "Formations",
            "item": [
                {
                    "name": "Lister vos formations",
                    "request": {
                        "method": "GET",
                        "header": [],
                        "url": {
                            "raw": "{{base}}/formations",
                            "host": [
                                "{{base}}"
                            ],
                            "path": [
                                "formations"
                            ]
                        }
                    }
                },
                {
                    "name": "Lire une annonce et son état",
                    "request": {
                        "method": "GET",
                        "header": [],
                        "url": {
                            "raw": "{{base}}/formations/CACES-R482-B1",
                            "host": [
                                "{{base}}"
                            ],
                            "path": [
                                "formations",
                                "CACES-R482-B1"
                            ]
                        }
                    }
                },
                {
                    "name": "Publier ou modifier (idempotent)",
                    "request": {
                        "method": "PUT",
                        "header": [
                            {
                                "key": "Content-Type",
                                "value": "application/json"
                            }
                        ],
                        "url": {
                            "raw": "{{base}}/formations/CACES-R482-B1",
                            "host": [
                                "{{base}}"
                            ],
                            "path": [
                                "formations",
                                "CACES-R482-B1"
                            ]
                        },
                        "body": {
                            "mode": "raw",
                            "raw": "{\n    \"titre\": \"CACES R482 catégorie B1\",\n    \"presentation\": \"Conduite en sécurité des pelles hydrauliques de moins de 6 tonnes.\",\n    \"lien\": \"https://www.votre-organisme.fr/formations/caces-r482-b1\",\n    \"organisme\": \"Centre de formation de la construction\",\n    \"mode\": \"presentiel\",\n    \"lieu\": \"Blagnac\",\n    \"code_postal\": \"31700\",\n    \"duree_heures\": 21,\n    \"debut\": \"2026-11-16\",\n    \"pour_qui\": \"Conducteurs d’engins débutants\",\n    \"niveau_d_entree\": \"Sans niveau requis\",\n    \"prerequis\": \"Avoir 18 ans\",\n    \"objectifs\": \"Conduire une pelle de moins de 6 tonnes en sécurité\",\n    \"infos_pratiques\": \"1 200 € HT, finançable par votre OPCO\",\n    \"metier\": \"Conducteur d’engins de chantier\",\n    \"metier_code\": \"conducteur-d-engins-de-chantier\",\n    \"famille_code\": \"terrassement-demolition\",\n    \"code_rome\": \"F1302\",\n    \"financements\": [\n        \"cpf\",\n        \"opco\"\n    ],\n    \"type_certification\": \"habilitation\",\n    \"code_rs\": \"RS5080\",\n    \"niveau_entree\": \"aucun\",\n    \"certification\": \"CACES® R482 catégorie B1\",\n    \"attestation\": false,\n    \"prix\": 1440\n}"
                        }
                    }
                },
                {
                    "name": "Supprimer (un PUT la ramène)",
                    "request": {
                        "method": "DELETE",
                        "header": [],
                        "url": {
                            "raw": "{{base}}/formations/CACES-R482-B1",
                            "host": [
                                "{{base}}"
                            ],
                            "path": [
                                "formations",
                                "CACES-R482-B1"
                            ]
                        }
                    }
                },
                {
                    "name": "Archiver",
                    "request": {
                        "method": "POST",
                        "header": [],
                        "url": {
                            "raw": "{{base}}/formations/CACES-R482-B1/archivage",
                            "host": [
                                "{{base}}"
                            ],
                            "path": [
                                "formations",
                                "CACES-R482-B1",
                                "archivage"
                            ]
                        }
                    }
                },
                {
                    "name": "Marquer pourvue",
                    "request": {
                        "method": "POST",
                        "header": [],
                        "url": {
                            "raw": "{{base}}/formations/CACES-R482-B1/pourvue",
                            "host": [
                                "{{base}}"
                            ],
                            "path": [
                                "formations",
                                "CACES-R482-B1",
                                "pourvue"
                            ]
                        }
                    }
                },
                {
                    "name": "Fermer (l’annonce ne reçoit plus de réponses)",
                    "request": {
                        "method": "POST",
                        "header": [],
                        "url": {
                            "raw": "{{base}}/formations/CACES-R482-B1/fermer",
                            "host": [
                                "{{base}}"
                            ],
                            "path": [
                                "formations",
                                "CACES-R482-B1",
                                "fermer"
                            ]
                        }
                    }
                },
                {
                    "name": "Rouvrir une annonce fermée",
                    "request": {
                        "method": "POST",
                        "header": [],
                        "url": {
                            "raw": "{{base}}/formations/CACES-R482-B1/rouvrir",
                            "host": [
                                "{{base}}"
                            ],
                            "path": [
                                "formations",
                                "CACES-R482-B1",
                                "rouvrir"
                            ]
                        }
                    }
                },
                {
                    "name": "La fiche telle qu’un membre la voit",
                    "request": {
                        "method": "GET",
                        "header": [],
                        "url": {
                            "raw": "{{base}}/formations/CACES-R482-B1/apercu",
                            "host": [
                                "{{base}}"
                            ],
                            "path": [
                                "formations",
                                "CACES-R482-B1",
                                "apercu"
                            ]
                        }
                    }
                },
                {
                    "name": "Joindre des photos et des PDF",
                    "request": {
                        "method": "POST",
                        "header": [],
                        "url": {
                            "raw": "{{base}}/formations/CACES-R482-B1/pieces",
                            "host": [
                                "{{base}}"
                            ],
                            "path": [
                                "formations",
                                "CACES-R482-B1",
                                "pieces"
                            ]
                        }
                    }
                },
                {
                    "name": "Ranger les photos",
                    "request": {
                        "method": "PUT",
                        "header": [
                            {
                                "key": "Content-Type",
                                "value": "application/json"
                            }
                        ],
                        "url": {
                            "raw": "{{base}}/formations/CACES-R482-B1/pieces/ordre",
                            "host": [
                                "{{base}}"
                            ],
                            "path": [
                                "formations",
                                "CACES-R482-B1",
                                "pieces",
                                "ordre"
                            ]
                        },
                        "body": {
                            "mode": "raw",
                            "raw": "{\n    \"titre\": \"CACES R482 catégorie B1\",\n    \"presentation\": \"Conduite en sécurité des pelles hydrauliques de moins de 6 tonnes.\",\n    \"lien\": \"https://www.votre-organisme.fr/formations/caces-r482-b1\",\n    \"organisme\": \"Centre de formation de la construction\",\n    \"mode\": \"presentiel\",\n    \"lieu\": \"Blagnac\",\n    \"code_postal\": \"31700\",\n    \"duree_heures\": 21,\n    \"debut\": \"2026-11-16\",\n    \"pour_qui\": \"Conducteurs d’engins débutants\",\n    \"niveau_d_entree\": \"Sans niveau requis\",\n    \"prerequis\": \"Avoir 18 ans\",\n    \"objectifs\": \"Conduire une pelle de moins de 6 tonnes en sécurité\",\n    \"infos_pratiques\": \"1 200 € HT, finançable par votre OPCO\",\n    \"metier\": \"Conducteur d’engins de chantier\",\n    \"metier_code\": \"conducteur-d-engins-de-chantier\",\n    \"famille_code\": \"terrassement-demolition\",\n    \"code_rome\": \"F1302\",\n    \"financements\": [\n        \"cpf\",\n        \"opco\"\n    ],\n    \"type_certification\": \"habilitation\",\n    \"code_rs\": \"RS5080\",\n    \"niveau_entree\": \"aucun\",\n    \"certification\": \"CACES® R482 catégorie B1\",\n    \"attestation\": false,\n    \"prix\": 1440\n}"
                        }
                    }
                },
                {
                    "name": "Retirer une photo ou un PDF",
                    "request": {
                        "method": "DELETE",
                        "header": [],
                        "url": {
                            "raw": "{{base}}/formations/CACES-R482-B1/pieces/{piece}",
                            "host": [
                                "{{base}}"
                            ],
                            "path": [
                                "formations",
                                "CACES-R482-B1",
                                "pieces",
                                "{piece}"
                            ]
                        }
                    }
                },
                {
                    "name": "Envoyer jusqu’à 100 annonces et retraits",
                    "request": {
                        "method": "POST",
                        "header": [
                            {
                                "key": "Content-Type",
                                "value": "application/json"
                            }
                        ],
                        "url": {
                            "raw": "{{base}}/formations/lot",
                            "host": [
                                "{{base}}"
                            ],
                            "path": [
                                "formations",
                                "lot"
                            ]
                        },
                        "body": {
                            "mode": "raw",
                            "raw": "{\n    \"formations\": [\n        {\n            \"reference\": \"CACES-R482-B1\",\n            \"titre\": \"CACES R482 catégorie B1\",\n            \"presentation\": \"Conduite en sécurité des pelles hydrauliques de moins de 6 tonnes.\",\n            \"lien\": \"https://www.votre-organisme.fr/formations/caces-r482-b1\",\n            \"organisme\": \"Centre de formation de la construction\",\n            \"mode\": \"presentiel\",\n            \"lieu\": \"Blagnac\",\n            \"code_postal\": \"31700\",\n            \"duree_heures\": 21,\n            \"debut\": \"2026-11-16\",\n            \"pour_qui\": \"Conducteurs d’engins débutants\",\n            \"niveau_d_entree\": \"Sans niveau requis\",\n            \"prerequis\": \"Avoir 18 ans\",\n            \"objectifs\": \"Conduire une pelle de moins de 6 tonnes en sécurité\",\n            \"infos_pratiques\": \"1 200 € HT, finançable par votre OPCO\",\n            \"metier\": \"Conducteur d’engins de chantier\",\n            \"metier_code\": \"conducteur-d-engins-de-chantier\",\n            \"famille_code\": \"terrassement-demolition\",\n            \"code_rome\": \"F1302\",\n            \"financements\": [\n                \"cpf\",\n                \"opco\"\n            ],\n            \"type_certification\": \"habilitation\",\n            \"code_rs\": \"RS5080\",\n            \"niveau_entree\": \"aucun\",\n            \"certification\": \"CACES® R482 catégorie B1\",\n            \"attestation\": false,\n            \"prix\": 1440\n        },\n        {\n            \"reference\": \"SST-2026-01\",\n            \"titre\": \"Sauveteur secouriste du travail (SST)\",\n            \"presentation\": \"Conduite en sécurité des pelles hydrauliques de moins de 6 tonnes.\",\n            \"lien\": \"https://www.votre-organisme.fr/formations/sst\",\n            \"organisme\": \"Centre de formation de la construction\",\n            \"mode\": \"presentiel\",\n            \"lieu\": \"Blagnac\",\n            \"code_postal\": \"31700\",\n            \"duree_heures\": 14,\n            \"debut\": \"2026-12-03\",\n            \"pour_qui\": \"Conducteurs d’engins débutants\",\n            \"niveau_d_entree\": \"Sans niveau requis\",\n            \"prerequis\": \"Avoir 18 ans\",\n            \"objectifs\": \"Conduire une pelle de moins de 6 tonnes en sécurité\",\n            \"infos_pratiques\": \"1 200 € HT, finançable par votre OPCO\",\n            \"metier\": \"Conducteur d’engins de chantier\",\n            \"metier_code\": \"conducteur-d-engins-de-chantier\",\n            \"famille_code\": \"terrassement-demolition\",\n            \"code_rome\": \"F1302\",\n            \"financements\": [\n                \"cpf\",\n                \"opco\"\n            ],\n            \"type_certification\": \"habilitation\",\n            \"code_rs\": \"RS5080\",\n            \"niveau_entree\": \"aucun\",\n            \"certification\": \"CACES® R482 catégorie B1\",\n            \"attestation\": false,\n            \"prix\": 1440\n        }\n    ]\n}"
                        }
                    }
                },
                {
                    "name": "Synchronisation complète : ce qui manque est archivé",
                    "request": {
                        "method": "POST",
                        "header": [
                            {
                                "key": "Content-Type",
                                "value": "application/json"
                            }
                        ],
                        "url": {
                            "raw": "{{base}}/formations/synchronisation",
                            "host": [
                                "{{base}}"
                            ],
                            "path": [
                                "formations",
                                "synchronisation"
                            ]
                        },
                        "body": {
                            "mode": "raw",
                            "raw": "{\n    \"references\": [\n        \"CACES-R482-B1\"\n    ]\n}"
                        }
                    }
                },
                {
                    "name": "Envoyer un catalogue LHEO tel quel",
                    "request": {
                        "method": "POST",
                        "header": [
                            {
                                "key": "Content-Type",
                                "value": "application/xml"
                            }
                        ],
                        "url": {
                            "raw": "{{base}}/formations/lheo",
                            "host": [
                                "{{base}}"
                            ],
                            "path": [
                                "formations",
                                "lheo"
                            ]
                        },
                        "body": {
                            "mode": "raw",
                            "raw": "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<!-- Catalogue d'exemple au format LHEO, à envoyer tel quel : POST /formations/lheo (API Heyalink). -->\n<lheo xmlns=\"http://lheo.gouv.fr/2.3\">\n  <offres>\n    <formation numero=\"CACES-R482-B1\">\n      <intitule-formation>CACES R482 catégorie B1</intitule-formation>\n      <objectif-formation>Conduire une pelle de moins de 6 tonnes en sécurité</objectif-formation>\n      <contenu-formation>Conduite en sécurité des pelles hydrauliques de moins de 6 tonnes.</contenu-formation>\n      <url-formation><urlweb>https://www.votre-organisme.fr/formations/caces-r482-b1</urlweb></url-formation>\n      <organisme-formation-responsable><raison-sociale>Centre de formation de la construction</raison-sociale></organisme-formation-responsable>\n      <action>\n        <modalites-enseignement>0</modalites-enseignement>\n        <conditions-specifiques>Avoir 18 ans</conditions-specifiques>\n        <lieu-de-formation><coordonnees><adresse><codepostal>31700</codepostal><ville>Blagnac</ville></adresse></coordonnees></lieu-de-formation>\n        <nombre-heures-total>21</nombre-heures-total>\n        <session><periode><debut>20261116</debut><fin>20261118</fin></periode></session>\n      </action>\n    </formation>\n    <formation numero=\"SST-2026-01\">\n      <intitule-formation>Sauveteur secouriste du travail (SST)</intitule-formation>\n      <contenu-formation>Formation initiale de sauveteur secouriste du travail, deux jours.</contenu-formation>\n      <url-formation><urlweb>https://www.votre-organisme.fr/formations/sst</urlweb></url-formation>\n      <action>\n        <modalites-enseignement>0</modalites-enseignement>\n        <lieu-de-formation><coordonnees><adresse><codepostal>31000</codepostal><ville>Toulouse</ville></adresse></coordonnees></lieu-de-formation>\n        <nombre-heures-total>14</nombre-heures-total>\n        <session><periode><debut>20261203</debut><fin>20261204</fin></periode></session>\n      </action>\n    </formation>\n  </offres>\n</lheo>\n"
                        }
                    }
                }
            ]
        },
        {
            "name": "Compte",
            "item": [
                {
                    "name": "Vérifier la clé : sa page, son API, ses droits",
                    "request": {
                        "method": "GET",
                        "header": [],
                        "url": {
                            "raw": "{{base}}/moi",
                            "host": [
                                "{{base}}"
                            ],
                            "path": [
                                "moi"
                            ]
                        }
                    }
                },
                {
                    "name": "Les 100 derniers appels et lectures (le journal de test pour une clé d’essai)",
                    "request": {
                        "method": "GET",
                        "header": [],
                        "url": {
                            "raw": "{{base}}/journal",
                            "host": [
                                "{{base}}"
                            ],
                            "path": [
                                "journal"
                            ]
                        }
                    }
                },
                {
                    "name": "Serveur MCP (Model Context Protocol, JSON-RPC 2.0) pour les agents d’IA",
                    "request": {
                        "method": "POST",
                        "header": [
                            {
                                "key": "Content-Type",
                                "value": "application/json"
                            }
                        ],
                        "url": {
                            "raw": "{{base}}/mcp",
                            "host": [
                                "{{base}}"
                            ],
                            "path": [
                                "mcp"
                            ]
                        },
                        "body": {
                            "mode": "raw",
                            "raw": "{\n    \"jsonrpc\": \"2.0\",\n    \"id\": 1,\n    \"method\": \"tools/list\"\n}"
                        }
                    }
                },
                {
                    "name": "Les domaines de votre page et leur preuve",
                    "request": {
                        "method": "GET",
                        "header": [],
                        "url": {
                            "raw": "{{base}}/domaines",
                            "host": [
                                "{{base}}"
                            ],
                            "path": [
                                "domaines"
                            ]
                        }
                    }
                },
                {
                    "name": "Ajouter un domaine à prouver : le jeton à poser sur votre site",
                    "request": {
                        "method": "POST",
                        "header": [],
                        "url": {
                            "raw": "{{base}}/domaines",
                            "host": [
                                "{{base}}"
                            ],
                            "path": [
                                "domaines"
                            ]
                        }
                    }
                },
                {
                    "name": "Chercher la preuve sur votre site (balise meta ou /.well-known/heyalink.txt)",
                    "request": {
                        "method": "POST",
                        "header": [],
                        "url": {
                            "raw": "{{base}}/domaines/{domaine}/verification",
                            "host": [
                                "{{base}}"
                            ],
                            "path": [
                                "domaines",
                                "{domaine}",
                                "verification"
                            ]
                        }
                    }
                },
                {
                    "name": "Retirer un domaine",
                    "request": {
                        "method": "DELETE",
                        "header": [],
                        "url": {
                            "raw": "{{base}}/domaines/{domaine}",
                            "host": [
                                "{{base}}"
                            ],
                            "path": [
                                "domaines",
                                "{domaine}"
                            ]
                        }
                    }
                },
                {
                    "name": "OAuth 2.0, client credentials : un jeton d’une heure",
                    "request": {
                        "method": "POST",
                        "header": [
                            {
                                "key": "Content-Type",
                                "value": "application/x-www-form-urlencoded"
                            }
                        ],
                        "url": {
                            "raw": "{{base}}/oauth/token",
                            "host": [
                                "{{base}}"
                            ],
                            "path": [
                                "oauth",
                                "token"
                            ]
                        },
                        "body": {
                            "mode": "raw",
                            "raw": "grant_type=client_credentials&client_id=hlc_VOTREIDENTIFIANT&client_secret=hl_formation_test_VOTRECLE"
                        }
                    }
                },
                {
                    "name": "Cette spécification",
                    "request": {
                        "method": "GET",
                        "header": [],
                        "url": {
                            "raw": "{{base}}/openapi.json",
                            "host": [
                                "{{base}}"
                            ],
                            "path": [
                                "openapi.json"
                            ]
                        }
                    }
                },
                {
                    "name": "L’état de l’API (public)",
                    "request": {
                        "method": "GET",
                        "header": [],
                        "url": {
                            "raw": "{{base}}/sante",
                            "host": [
                                "{{base}}"
                            ],
                            "path": [
                                "sante"
                            ]
                        }
                    }
                }
            ]
        },
        {
            "name": "Services",
            "item": [
                {
                    "name": "Les services de la page : brouillons, en ligne, fermés",
                    "request": {
                        "method": "GET",
                        "header": [],
                        "url": {
                            "raw": "{{base}}/services",
                            "host": [
                                "{{base}}"
                            ],
                            "path": [
                                "services"
                            ]
                        }
                    }
                },
                {
                    "name": "Créer un service en brouillon (type et title facultatifs : ils remplissent la tête)",
                    "request": {
                        "method": "POST",
                        "header": [],
                        "url": {
                            "raw": "{{base}}/services",
                            "host": [
                                "{{base}}"
                            ],
                            "path": [
                                "services"
                            ]
                        }
                    }
                },
                {
                    "name": "Un service : son état, ses blocs, ce qui manque avant de publier",
                    "request": {
                        "method": "GET",
                        "header": [],
                        "url": {
                            "raw": "{{base}}/services/{id}",
                            "host": [
                                "{{base}}"
                            ],
                            "path": [
                                "services",
                                "{id}"
                            ]
                        }
                    }
                },
                {
                    "name": "Supprimer le service (définitif ; webhook annonce.supprimee)",
                    "request": {
                        "method": "DELETE",
                        "header": [],
                        "url": {
                            "raw": "{{base}}/services/{id}",
                            "host": [
                                "{{base}}"
                            ],
                            "path": [
                                "services",
                                "{id}"
                            ]
                        }
                    }
                },
                {
                    "name": "Enregistrer un bloc : seuls ses champs changent",
                    "request": {
                        "method": "PATCH",
                        "header": [],
                        "url": {
                            "raw": "{{base}}/services/{id}/blocs/{bloc}",
                            "host": [
                                "{{base}}"
                            ],
                            "path": [
                                "services",
                                "{id}",
                                "blocs",
                                "{bloc}"
                            ]
                        }
                    }
                },
                {
                    "name": "Enregistrer un bloc en multipart (photos, PDF) : comme PATCH",
                    "request": {
                        "method": "POST",
                        "header": [],
                        "url": {
                            "raw": "{{base}}/services/{id}/blocs/{bloc}",
                            "host": [
                                "{{base}}"
                            ],
                            "path": [
                                "services",
                                "{id}",
                                "blocs",
                                "{bloc}"
                            ]
                        }
                    }
                },
                {
                    "name": "Voir comme un membre : ce que la fiche montre",
                    "request": {
                        "method": "GET",
                        "header": [],
                        "url": {
                            "raw": "{{base}}/services/{id}/apercu",
                            "host": [
                                "{{base}}"
                            ],
                            "path": [
                                "services",
                                "{id}",
                                "apercu"
                            ]
                        }
                    }
                },
                {
                    "name": "Publier le service (tous les blocs obligatoires remplis, dans la limite de la formule)",
                    "request": {
                        "method": "POST",
                        "header": [],
                        "url": {
                            "raw": "{{base}}/services/{id}/publication",
                            "host": [
                                "{{base}}"
                            ],
                            "path": [
                                "services",
                                "{id}",
                                "publication"
                            ]
                        }
                    }
                },
                {
                    "name": "Fermer le service : il sort des listes et du plafond (webhook annonce.fermee)",
                    "request": {
                        "method": "POST",
                        "header": [],
                        "url": {
                            "raw": "{{base}}/services/{id}/fermeture",
                            "host": [
                                "{{base}}"
                            ],
                            "path": [
                                "services",
                                "{id}",
                                "fermeture"
                            ]
                        }
                    }
                },
                {
                    "name": "Rouvrir le service, dans la limite de la formule (webhook annonce.rouverte)",
                    "request": {
                        "method": "POST",
                        "header": [],
                        "url": {
                            "raw": "{{base}}/services/{id}/reouverture",
                            "host": [
                                "{{base}}"
                            ],
                            "path": [
                                "services",
                                "{id}",
                                "reouverture"
                            ]
                        }
                    }
                }
            ]
        }
    ]
}