// DEVELOPER API

API проверки текстапо ключу и обычному JSON.

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

Получить API-ключ Эндпоинты

знаков в запросе: ...
запросов сразу: ...
запросов в сек.: ...
в месяц: ...

1curl -s https://authortext.com/api/analyze \2  -H "Authorization: Bearer atk_YOUR_KEY" \3  -H "Content-Type: application/json" \4  -d '{"text": "It is important to note that various factors play a crucial role."}'

200 OK/ application/json/ Ответ сокращён: показаны не все поля

{  "probability": 36.048,  "confidence": "LOW",  "band": { "index": 2, "key": "mixed" },  "evidence": [    { "type": "phrase", "line": 1, "why": "high",      "excerpt": ">>>It is important to note<<< that various ..." }  ],  "stats": { "words": 12, "sentences": 1 }}

01/Эндпоинты

Ключ работает для этих запросов. Запросы кабинета и оплаты по ключу не проходят.

POST /api/analyze Оценка, метрики, места в тексте с цитатами, водяные знакитело: {"text": "..."} 1 запрос
POST /api/clean Очистка: удаление скрытых символов и типографики; слишком длинный текст обрезается до лимита тарифа (truncated, limit)тело: {"text": "..."} 1 запрос
POST /api/highlight Разметка найденных мест для подсветкитело: {"text": "..."} 1 запрос
POST /api/fetch-url Загрузка страницы по адресу и анализ её текстатело: {"url": "..."} 5 запросов
POST /api/extract-file Текст из файла: PDF, DOCX, ODT, RTF, EPUB, FB2, HTML, TXTтело: файл 5 запросов
GET /api/me Тариф ключа и его пределы не расходует запросы

02/Что важно знать

Без хранения

Текст живёт только в памяти: на диск он не пишется и в журналы не попадает.

Ключ и тариф

Ключ создаётся в кабинете и показывается один раз: сервер хранит только его отпечаток. Новый ключ заменяет старый.

Один формат ошибок

Ошибка всегда приходит в виде {"error": {"code", "message"}}, без трассировок.

Текст, ссылка, файл

Можно отправить текст, адрес страницы или целый документ.

03/API по ключу: тарифы «Про» и «Макс»

Цены и лимиты берутся с сервера, поэтому не расходятся с реальными.

Pro

-в месяц

- знаков за запрос- запросов сразу- запросов в секунду

Выбрать подписку

Ключ API входит в тарифы «Про» и «Макс».
Все виды анализа и разбор по фрагментам
Заголовок Authorization: Bearer для анализа, очистки, разметки, загрузки по ссылке и из файла
Ключ работает, пока идёт оплаченный период

04/Ошибки и ограничения

Код 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 KEY

Ключ создаётся в кабинете

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

Открыть кабинет