📚 SwissApp APIs
Documentation unifiée des APIs SwissApp. Chaque API est accessible via une clé Bearer générée sur my.swissapp.org.
APIs disponibles
Mails API
Envoi d'emails transactionnels et marketing avec gestion des standby, retries, alertes.
SMS API
Envoi de SMS via Twilio/MessageBird, multi-providers, gestion des longueurs et des prefix internationaux.
Maps API
Géocodage, places, directions, geolocation cell/wifi via Google Maps avec cache D1.
Agents IA API
Agents IA SwissApp (OpenAI/Anthropic/Google) avec routing, cache, et facturation crédits.
Docs API
Documentation centralisée de toutes les APIs SwissApp avec formats HTML, Markdown, OpenAPI 3.1 et llms.txt.
Pour les agents IA / LLM
Endpoints dédiés au consommation par agents (ChatGPT, Claude, Cursor…) :
| Endpoint | Description |
|---|---|
GET /api/docs | Liste JSON de toutes les APIs disponibles |
GET /api/docs/:service/markdown | Documentation complète au format Markdown brut |
GET /api/docs/:service/openapi.json | Spec OpenAPI 3.1 du service |
GET /api/docs/:service/llms.txt | Version condensée pour LLM |
GET /api/docs/llms-full.txt | Toutes les APIs concaténées (ingestion massive) |
GET /api/docs/search?q=... | Recherche full-text |
Quick start (curl)
# Lister les APIs
curl -H "Authorization: Bearer docs_xxx" \
https://api.docs.swissapp.net/api/docs
# Récupérer la doc Mails au format markdown
curl -H "Authorization: Bearer docs_xxx" \
https://api.docs.swissapp.net/api/docs/mails/markdown
# Spec OpenAPI 3.1 du service SMS
curl -H "Authorization: Bearer docs_xxx" \
https://api.docs.swissapp.net/api/docs/sms/openapi.json