{
    "info": {
        "name": "API Emploi de Heyalink",
        "description": "Collection tirée de la spécification OpenAPI 1.13.0. Mettez votre clé d’essai (hl_emploi_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/emploi/v1"
        },
        {
            "key": "cle",
            "value": "hl_emploi_test_VOTRECLE"
        }
    ],
    "item": [
        {
            "name": "Offres d’emploi",
            "item": [
                {
                    "name": "Lister vos offres d’emploi",
                    "request": {
                        "method": "GET",
                        "header": [],
                        "url": {
                            "raw": "{{base}}/offres",
                            "host": [
                                "{{base}}"
                            ],
                            "path": [
                                "offres"
                            ]
                        }
                    }
                },
                {
                    "name": "Lire une annonce et son état",
                    "request": {
                        "method": "GET",
                        "header": [],
                        "url": {
                            "raw": "{{base}}/offres/CC-2026-014",
                            "host": [
                                "{{base}}"
                            ],
                            "path": [
                                "offres",
                                "CC-2026-014"
                            ]
                        }
                    }
                },
                {
                    "name": "Publier ou modifier (idempotent)",
                    "request": {
                        "method": "PUT",
                        "header": [
                            {
                                "key": "Content-Type",
                                "value": "application/json"
                            }
                        ],
                        "url": {
                            "raw": "{{base}}/offres/CC-2026-014",
                            "host": [
                                "{{base}}"
                            ],
                            "path": [
                                "offres",
                                "CC-2026-014"
                            ]
                        },
                        "body": {
                            "mode": "raw",
                            "raw": "{\n    \"titre\": \"Chef de chantier gros œuvre\",\n    \"description\": \"<p>Vous dirigez deux équipes sur des chantiers de logements collectifs.</p>\",\n    \"lieu\": \"Toulouse (31)\",\n    \"code_postal\": \"31000\",\n    \"type_contrat\": \"CDI\",\n    \"salaire\": \"38 000 € par an\",\n    \"metier\": \"Chef de chantier\",\n    \"secteur\": \"Gros œuvre\",\n    \"lien_candidature\": \"https://www.votre-site.fr/offres/CC-2026-014\",\n    \"date_expiration\": \"2026-12-31\",\n    \"metier_code\": \"chef-de-chantier-batiment\",\n    \"famille_code\": \"entreprise-generale\",\n    \"code_rome\": \"F1202\",\n    \"experience_mois\": 36,\n    \"temps_de_travail\": \"plein\",\n    \"teletravail\": \"non\",\n    \"salaire_min\": 36000,\n    \"salaire_max\": 40000,\n    \"salaire_periode\": \"an\"\n}"
                        }
                    }
                },
                {
                    "name": "Supprimer (un PUT la ramène)",
                    "request": {
                        "method": "DELETE",
                        "header": [],
                        "url": {
                            "raw": "{{base}}/offres/CC-2026-014",
                            "host": [
                                "{{base}}"
                            ],
                            "path": [
                                "offres",
                                "CC-2026-014"
                            ]
                        }
                    }
                },
                {
                    "name": "Archiver",
                    "request": {
                        "method": "POST",
                        "header": [],
                        "url": {
                            "raw": "{{base}}/offres/CC-2026-014/archivage",
                            "host": [
                                "{{base}}"
                            ],
                            "path": [
                                "offres",
                                "CC-2026-014",
                                "archivage"
                            ]
                        }
                    }
                },
                {
                    "name": "Marquer pourvue",
                    "request": {
                        "method": "POST",
                        "header": [],
                        "url": {
                            "raw": "{{base}}/offres/CC-2026-014/pourvue",
                            "host": [
                                "{{base}}"
                            ],
                            "path": [
                                "offres",
                                "CC-2026-014",
                                "pourvue"
                            ]
                        }
                    }
                },
                {
                    "name": "Fermer (l’annonce ne reçoit plus de réponses)",
                    "request": {
                        "method": "POST",
                        "header": [],
                        "url": {
                            "raw": "{{base}}/offres/CC-2026-014/fermer",
                            "host": [
                                "{{base}}"
                            ],
                            "path": [
                                "offres",
                                "CC-2026-014",
                                "fermer"
                            ]
                        }
                    }
                },
                {
                    "name": "Rouvrir une annonce fermée",
                    "request": {
                        "method": "POST",
                        "header": [],
                        "url": {
                            "raw": "{{base}}/offres/CC-2026-014/rouvrir",
                            "host": [
                                "{{base}}"
                            ],
                            "path": [
                                "offres",
                                "CC-2026-014",
                                "rouvrir"
                            ]
                        }
                    }
                },
                {
                    "name": "La fiche telle qu’un membre la voit",
                    "request": {
                        "method": "GET",
                        "header": [],
                        "url": {
                            "raw": "{{base}}/offres/CC-2026-014/apercu",
                            "host": [
                                "{{base}}"
                            ],
                            "path": [
                                "offres",
                                "CC-2026-014",
                                "apercu"
                            ]
                        }
                    }
                },
                {
                    "name": "Joindre des photos et des PDF",
                    "request": {
                        "method": "POST",
                        "header": [],
                        "url": {
                            "raw": "{{base}}/offres/CC-2026-014/pieces",
                            "host": [
                                "{{base}}"
                            ],
                            "path": [
                                "offres",
                                "CC-2026-014",
                                "pieces"
                            ]
                        }
                    }
                },
                {
                    "name": "Ranger les photos",
                    "request": {
                        "method": "PUT",
                        "header": [
                            {
                                "key": "Content-Type",
                                "value": "application/json"
                            }
                        ],
                        "url": {
                            "raw": "{{base}}/offres/CC-2026-014/pieces/ordre",
                            "host": [
                                "{{base}}"
                            ],
                            "path": [
                                "offres",
                                "CC-2026-014",
                                "pieces",
                                "ordre"
                            ]
                        },
                        "body": {
                            "mode": "raw",
                            "raw": "{\n    \"titre\": \"Chef de chantier gros œuvre\",\n    \"description\": \"<p>Vous dirigez deux équipes sur des chantiers de logements collectifs.</p>\",\n    \"lieu\": \"Toulouse (31)\",\n    \"code_postal\": \"31000\",\n    \"type_contrat\": \"CDI\",\n    \"salaire\": \"38 000 € par an\",\n    \"metier\": \"Chef de chantier\",\n    \"secteur\": \"Gros œuvre\",\n    \"lien_candidature\": \"https://www.votre-site.fr/offres/CC-2026-014\",\n    \"date_expiration\": \"2026-12-31\",\n    \"metier_code\": \"chef-de-chantier-batiment\",\n    \"famille_code\": \"entreprise-generale\",\n    \"code_rome\": \"F1202\",\n    \"experience_mois\": 36,\n    \"temps_de_travail\": \"plein\",\n    \"teletravail\": \"non\",\n    \"salaire_min\": 36000,\n    \"salaire_max\": 40000,\n    \"salaire_periode\": \"an\"\n}"
                        }
                    }
                },
                {
                    "name": "Retirer une photo ou un PDF",
                    "request": {
                        "method": "DELETE",
                        "header": [],
                        "url": {
                            "raw": "{{base}}/offres/CC-2026-014/pieces/{piece}",
                            "host": [
                                "{{base}}"
                            ],
                            "path": [
                                "offres",
                                "CC-2026-014",
                                "pieces",
                                "{piece}"
                            ]
                        }
                    }
                },
                {
                    "name": "Envoyer jusqu’à 100 annonces et retraits",
                    "request": {
                        "method": "POST",
                        "header": [
                            {
                                "key": "Content-Type",
                                "value": "application/json"
                            }
                        ],
                        "url": {
                            "raw": "{{base}}/offres/lot",
                            "host": [
                                "{{base}}"
                            ],
                            "path": [
                                "offres",
                                "lot"
                            ]
                        },
                        "body": {
                            "mode": "raw",
                            "raw": "{\n    \"offres\": [\n        {\n            \"reference\": \"CC-2026-014\",\n            \"titre\": \"Chef de chantier gros œuvre\",\n            \"description\": \"<p>Vous dirigez deux équipes sur des chantiers de logements collectifs.</p>\",\n            \"lieu\": \"Toulouse (31)\",\n            \"code_postal\": \"31000\",\n            \"type_contrat\": \"CDI\",\n            \"salaire\": \"38 000 € par an\",\n            \"metier\": \"Chef de chantier\",\n            \"secteur\": \"Gros œuvre\",\n            \"lien_candidature\": \"https://www.votre-site.fr/offres/CC-2026-014\",\n            \"date_expiration\": \"2026-12-31\",\n            \"metier_code\": \"chef-de-chantier-batiment\",\n            \"famille_code\": \"entreprise-generale\",\n            \"code_rome\": \"F1202\",\n            \"experience_mois\": 36,\n            \"temps_de_travail\": \"plein\",\n            \"teletravail\": \"non\",\n            \"salaire_min\": 36000,\n            \"salaire_max\": 40000,\n            \"salaire_periode\": \"an\"\n        },\n        {\n            \"reference\": \"MAC-2026-002\",\n            \"titre\": \"Maçon qualifié\",\n            \"description\": \"<p>Vous dirigez deux équipes sur des chantiers de logements collectifs.</p>\",\n            \"lieu\": \"Albi (81)\",\n            \"code_postal\": \"81000\",\n            \"type_contrat\": \"CDI\",\n            \"salaire\": \"38 000 € par an\",\n            \"metier\": \"Maçon\",\n            \"secteur\": \"Gros œuvre\",\n            \"lien_candidature\": \"https://www.votre-site.fr/offres/MAC-2026-002\",\n            \"date_expiration\": \"2026-12-31\",\n            \"metier_code\": \"chef-de-chantier-batiment\",\n            \"famille_code\": \"entreprise-generale\",\n            \"code_rome\": \"F1202\",\n            \"experience_mois\": 36,\n            \"temps_de_travail\": \"plein\",\n            \"teletravail\": \"non\",\n            \"salaire_min\": 36000,\n            \"salaire_max\": 40000,\n            \"salaire_periode\": \"an\"\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}}/offres/synchronisation",
                            "host": [
                                "{{base}}"
                            ],
                            "path": [
                                "offres",
                                "synchronisation"
                            ]
                        },
                        "body": {
                            "mode": "raw",
                            "raw": "{\n    \"references\": [\n        \"CC-2026-014\"\n    ]\n}"
                        }
                    }
                }
            ]
        },
        {
            "name": "Sous-traitance",
            "item": [
                {
                    "name": "Lister les demandes de sous-traitance de votre page",
                    "request": {
                        "method": "GET",
                        "header": [],
                        "url": {
                            "raw": "{{base}}/sous-traitance",
                            "host": [
                                "{{base}}"
                            ],
                            "path": [
                                "sous-traitance"
                            ]
                        }
                    }
                },
                {
                    "name": "Publier une demande de sous-traitance au nom de votre page",
                    "request": {
                        "method": "POST",
                        "header": [],
                        "url": {
                            "raw": "{{base}}/sous-traitance",
                            "host": [
                                "{{base}}"
                            ],
                            "path": [
                                "sous-traitance"
                            ]
                        }
                    }
                },
                {
                    "name": "Lire une demande et son état",
                    "request": {
                        "method": "GET",
                        "header": [],
                        "url": {
                            "raw": "{{base}}/sous-traitance/{demande}",
                            "host": [
                                "{{base}}"
                            ],
                            "path": [
                                "sous-traitance",
                                "{demande}"
                            ]
                        }
                    }
                },
                {
                    "name": "Modifier une demande, bloc par bloc",
                    "request": {
                        "method": "PATCH",
                        "header": [],
                        "url": {
                            "raw": "{{base}}/sous-traitance/{demande}",
                            "host": [
                                "{{base}}"
                            ],
                            "path": [
                                "sous-traitance",
                                "{demande}"
                            ]
                        }
                    }
                },
                {
                    "name": "Supprimer, définitivement",
                    "request": {
                        "method": "DELETE",
                        "header": [],
                        "url": {
                            "raw": "{{base}}/sous-traitance/{demande}",
                            "host": [
                                "{{base}}"
                            ],
                            "path": [
                                "sous-traitance",
                                "{demande}"
                            ]
                        }
                    }
                },
                {
                    "name": "Fermer (la demande ne reçoit plus de candidatures)",
                    "request": {
                        "method": "POST",
                        "header": [],
                        "url": {
                            "raw": "{{base}}/sous-traitance/{demande}/fermer",
                            "host": [
                                "{{base}}"
                            ],
                            "path": [
                                "sous-traitance",
                                "{demande}",
                                "fermer"
                            ]
                        }
                    }
                },
                {
                    "name": "Rouvrir une demande fermée",
                    "request": {
                        "method": "POST",
                        "header": [],
                        "url": {
                            "raw": "{{base}}/sous-traitance/{demande}/rouvrir",
                            "host": [
                                "{{base}}"
                            ],
                            "path": [
                                "sous-traitance",
                                "{demande}",
                                "rouvrir"
                            ]
                        }
                    }
                },
                {
                    "name": "Les candidatures reçues, en lecture",
                    "request": {
                        "method": "GET",
                        "header": [],
                        "url": {
                            "raw": "{{base}}/sous-traitance/{demande}/candidatures",
                            "host": [
                                "{{base}}"
                            ],
                            "path": [
                                "sous-traitance",
                                "{demande}",
                                "candidatures"
                            ]
                        }
                    }
                }
            ]
        },
        {
            "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_emploi_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"
                            ]
                        }
                    }
                }
            ]
        }
    ]
}