# 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
- [Get started](https://alef-bot.top/en/developers/guides/get-started.md): Verify the Test Mode connection before integrating the API into your product
- [Authentication and API keys](https://alef-bot.top/en/developers/guides/authentication.md): Create, store, restrict and rotate API keys safely
- [Transcription workflow](https://alef-bot.top/en/developers/guides/transcription-workflow.md): Build a reliable process for upload, job creation, tracking and artifact download
- [Webhooks](https://alef-bot.top/en/developers/guides/webhooks.md): Receive completion events safely and test delivery before production
- [Errors and retries](https://alef-bot.top/en/developers/guides/errors-and-retries.md): Interpret the stable error envelope and retry only when safe
- [Changelog](https://alef-bot.top/en/developers/changelog.md): Contract and documentation changes that affect API integrations

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