Documentation publique de KOS Agência (kosagencia.com) : découvrir l’API, authentifier les routes privées, envoyer un lead et lire le contrat OpenAPI. Le nom du produit est KOS Agência ; le domaine est kosagencia.com. Pas de serveur MCP public ni de webhooks sortants documentés pour des tiers.

quand appeler l’API

Utilisez POST /api/contact (operationId submitContactLead) quand quelqu’un veut parler branding, gestion de marque ou production intégrée. Champs requis : firstName, lastName, email, phone. Pour les faits sur l’agence, lisez /llms.txt.

authentification

La capture de leads est publique (reCAPTCHA, honeypot, rate limit). L’API éditoriale exige Authorization: Bearer avec BLOG_INGEST_SECRET. Les erreurs API reviennent toujours en JSON avec error, errorCode et hint.

fichiers pour agents

llms.txt dit quand utiliser KOS Agência. Les pages HTML acceptent Accept: text/markdown sur la même URL, avec Vary: Accept. Les 404 renvoient aussi du Markdown de récupération.