# טעותים און איבערפרווון

פארשטייט דעם סטאבילן טעות סטרוקטור און פרוווט ווידער נאר ווען עס איז זיכער

Canonical: https://alef-bot.top/yi/developers/guides/errors-and-retries

Updated: 2026-07-13

## טעות סטרוקטור

יעדער פובליקער API טעות אנטהאלט error.code, error.message, error.request_id און error.details.resolution_url. פארלאזט זיך אויף code און נישט אויף message

> **סטאבילע פתרון לינקען.** עפנט resolution_url פאר א געצילטן פתרון. אומבאקאנטע קאדן פירן צוריק צו דער אנווייזונג

## פאליסי פאר איבערפרווון

- פרוווט נישט ווידער ערווארטעטע 401, 403 אדער 422 טעותים אן טוישן דעם פארלאנג
- פרוווט 429 ווידער נאר נאך Retry-After אדער X-RateLimit-Reset מיט א קליינער צופעליקער אפשטעל
- נוצט באגרעניצטע עקספאנענציעלע אפשטעל ביי נעץ דורכפאלן און צייטווייליגע 5xx טעותים
- נאך אן אומזיכערן ענטפער פון POST /uploads אדער POST /transcriptions נוצט ווידער דעם אריגינעלן Idempotency-Key

## Machine-readable sources

- [OpenAPI JSON](https://alef-bot.top/api/v1/openapi.json)

- [OpenAPI YAML](https://alef-bot.top/api/v1/openapi.yaml)

- [Arazzo workflow](https://alef-bot.top/api/v1/workflows/transcribe.arazzo.yaml)