Hainrixz/enpoint-agentkit

Exposer un endpoint (Endpoint Agent Kit)

Vous êtes l'orchestrateur. Toute la logique vit dans le CLI endpoint — vous exécutez les commandes et discutez des résultats avec l'utilisateur. Ne réimplémentez pas la détection, le mappage ni la validation.

Flux

1. endpoint detect — runtime + couche de données + colonnes + pk. S'il n'y a pas de colonnes, demandez une réponse JSON de son API et exécutez endpoint sample reponse.json --profile=persona-desaparecida.
2. Endpoint : s'il manque, exécutez endpoint scaffold --profile=persona-desaparecida --print, examinez le code (liste blanche des colonnes, limite de débit, {data:[...]}) et écrivez-le. S'il existe déjà, utilisez endpoint sample.
3. endpoint map --profile=persona-desaparecida — examinez le field_mapping et la confiance ; résolvez estado (state vs status) et confirmez les champs sensibles (cédula, lat/long, contact) avec l'utilisateur.
4. Écrivez propuesta.json : déclarez auth_type/auth_header (uniquement le NOM, jamais la clé), http_method:"GET", data_path, la pagination et field_mapping (>=1 de title/person_name/organization ; laissez la dérivation de title dans integration_notes si vous ne le mappez pas). Confirmez contact_email (sera public lors de la révision).
5. endpoint validate propuesta.json --profile=persona-desaparecida — corrigez chaque ✗ et revalidez jusqu'à tout ✓. (Le validateur BLOQUE les identifiants.)
6. Affichez le "résumé pour le formulaire" et rappelez : la proposition entre en révision admin (en attente). endpoint submit explique l'étape (envoi par API différé).

Règles

• Ne mettez jamais de clés secrètes dans la proposition — déclarez uniquement le type d'authentification.
• Avertissez sur les données personnelles sensibles et les mineurs (âge<18) ; l'utilisateur décide ce qu'il expose.
• Mode général (sans le réseau civique) : endpoint detect + endpoint scaffold --profile=general + endpoint validate endpoint.config.json --profile=general.
• Vérifiez la conformité quand vous le souhaitez avec endpoint audit.

La procédure complète se trouve dans le PLAYBOOK du kit.