# API перевірки тексту за ключем і звичайним JSON.

> Як запускати перевірку тексту на ознаки ШІ зі своїх програм: ключ, ендпоїнти, приклади для curl, Python і Node.js, помилки та ліміти.

- URL: https://authortext.com/uk/developers
- Language: uk
- Site: AuthorText (https://authortext.com/)

Той самий аналіз, що й на сайті, але для ваших програм: оцінка, метрики, місця в тексті з цитатами, очищення та розмітка. Запити й відповіді - у JSON.

## Ендпоїнти

Ключ приймають ці запити; запити кабінету й оплати ключ не приймають.

| Method | Path | Body | Purpose |
| --- | --- | --- | --- |
| POST | `/api/analyze` | `{"text": "..."}` | Оцінка, метрики, місця в тексті з цитатами, водяні знаки |
| POST | `/api/clean` | `{"text": "..."}` | Очищення: видалення прихованих символів і типографіки; надто довгий текст обрізається до ліміту тарифу (truncated, limit) |
| POST | `/api/highlight` | `{"text": "..."}` | Розмітка знайдених місць для підсвічування |
| POST | `/api/fetch-url` | `{"url": "..."}` | Завантаження сторінки за адресою та аналіз її тексту |
| POST | `/api/extract-file` | `файл` | Текст із файлу: PDF, DOCX, ODT, RTF, EPUB, FB2, HTML, TXT |
| GET | `/api/me` |  | Тариф ключа та його межі |

## Що важливо знати

- **Без зберігання.** Текст обробляється в пам'яті, не пишеться на диск і не потрапляє в журнали.
- **Ключ і тариф.** Ключ створюється в кабінеті й показується один раз; сервер зберігає лише відбиток. Новий ключ замінює попередній.
- **Один формат помилок.** Помилка завжди має вигляд {"error": {"code", "message"}}, без трасувань.
- **Текст, посилання, файл.** Можна надіслати текст, адресу сторінки або документ цілком.

## API за ключем: тарифи «Про» і «Макс»

Ціни й ліміти беруться з сервера, тому не розходяться зі справжніми. Live data: https://authortext.com/api/plans.

- Ключ API входить у тарифи «Про» і «Макс».
- Усі види аналізу та розбір за фрагментами
- Заголовок Authorization: Bearer для аналізу, очищення, розмітки, завантаження за посиланням і з файлу
- Ключ діє, поки триває оплачений період

## Помилки та обмеження

| Код HTTP | code | Коли |
| --- | --- | --- |
| 400 | `invalid_json` | Тіло запиту не є коректним JSON |
| 413 | `payload_too_large` | Тіло запиту завелике |
| 415 | `unsupported_media_type` | Content-Type не application/json |
| 422 | `empty_text / invalid_text` | Поле text порожнє, відсутнє або не рядок |
| 422 | `text_too_long` | Текст довший за межу тарифу; у відповіді limit і plan |
| 429 | `rate_limited` | Занадто часто; дивіться заголовок Retry-After |

- Запити рахуються «пачкою»: спершу можна надіслати стільки запитів поспіль, скільки вказано вище, а далі - стільки на секунду. Завантаження за посиланням або з файлу коштує 5 запитів. Текст довший за 100 000 знаків коштує ще по 1 запиту за кожні 100 000.
- Якщо ключа немає, він хибний або прострочений, помилки не буде: запит обробиться як безкоштовний, з безкоштовними межами (3 000 знаків). Який у вас тариф, дізнаєтеся через GET /api/me.
- Оцінка - орієнтир, а не доказ авторства.

## Ключ створюється в кабінеті

Оформіть підписку «Про» або «Макс», відкрийте розділ «Ключ API» в кабінеті й натисніть «Створити ключ».

## Links

- [Home](https://authortext.com/uk/index.md)
- [plans](https://authortext.com/uk/plans.md)
- [help](https://authortext.com/uk/help.md)
- [developers](https://authortext.com/uk/developers.md)
- [about](https://authortext.com/uk/about.md)
- [method](https://authortext.com/uk/method.md)
- [faq](https://authortext.com/uk/faq.md)
- [privacy](https://authortext.com/uk/privacy.md)
- [terms](https://authortext.com/uk/terms.md)
- [articles](https://authortext.com/uk/articles/index.md)