# AlefBot Developer Hub
> Public API documentation for AlefBot transcription integrations.

## Canonical machine contracts
- [OpenAPI JSON](https://alef-bot.top/api/v1/openapi.json)
- [OpenAPI YAML](https://alef-bot.top/api/v1/openapi.yaml)
- [Postman collection](https://alef-bot.top/api/v1/postman-collection.json)
- [Arazzo transcription workflow](https://alef-bot.top/api/v1/workflows/transcribe.arazzo.yaml)

## Guides
- [Bien démarrer](https://alef-bot.top/fr/developers/guides/get-started.md): Vérifiez la connexion en mode Test avant d’intégrer l’API au produit
- [Authentification et clés API](https://alef-bot.top/fr/developers/guides/authentication.md): Créez, stockez, limitez et remplacez vos clés API en sécurité
- [Workflow de transcription](https://alef-bot.top/fr/developers/guides/transcription-workflow.md): Créez un processus fiable de téléversement, création, suivi et téléchargement du résultat
- [Webhooks](https://alef-bot.top/fr/developers/guides/webhooks.md): Recevez les événements de fin en sécurité et testez la livraison avant la production
- [Erreurs et reprises](https://alef-bot.top/fr/developers/guides/errors-and-retries.md): Interprétez la structure d’erreur stable et réessayez uniquement quand cela est sûr
- [Journal des modifications](https://alef-bot.top/fr/developers/changelog.md): Modifications du contrat et de la documentation qui affectent les intégrations API

Prefer OpenAPI for exact request and response fields. Use the guides for workflow, safety, and retry behavior.