API v1_up_limits

Вопросы к техподдержке: support.lf@statusnick.com

Это дубликат API v1 с увеличенными порогами ограничений.

Базовая концепция

Запросы

Только POST-запросы в формате JSON принимаются скриптом. Вы можете передать application/json данные, исключая загрузки файлов.

Недопускаются пустые значения, включая false. Если почему-то вам нужно указать false, то впишите 0. Ничего особенного не случится, если вы отправите пустое значение, просто система удалит такой параметр из запроса.

Частота запросов

Ограничение частоты запросов убрано, в сравнении с версией v1.

Виды обрабатываемого контента

Данная версия API работает только со сплошным текстом, то есть очищает полностью все теги, знаки препинания, цифры. То есть нужно понимать, что текст вида <html>запретное слово</html> не будет по версии API v1_up_limits содержать запрещенного слова.

Основной узел

Основным узлом обращения всех внешних запросов к API является /api/.

Логика API

Основное действие определяется адресом запроса. Например, /api/source/edit_status определит, что именно нужно сделать, а параметры, переданные в JSON, например, [query_details]=>[source_tags]=>[telegram, discord, personal] - как именно нужно сделать.

Источник (source)

Основной сущностью сервиса LF является источник (source) - что-то вроде хранилища информации о том, с чем работает скрипт.

Например, можно создать источник с названием "Telegram_bot" и через него проверять контент относящийся именно к вашему Телеграм-боту. При этом такой источник будет собирать некоторую статистику, например, расходы на проверку контента по Телеграм-боту, хранить персональные настройки для этого источника, например, статус активен или нет.

Ответы от API

Ответы от сервиса возвращаются в JSON-формате в следующей структуре:

  • [result] - Верхний ключ ответа
    • [successes] - Содержит все успешные проверки обращения к скрипту
      • [API] - Идентификатор области ответа
        • [M-002] - Идентификатор номера ответа
          • [description] - Описание ответа
          • [details] - Прочая информация об ответе
    • [errors] - Содержит все неудачные проверки обращения к скрипту
      • [API] - Идентификатор области ответа
        • [M-002] - Идентификатор номера ответа
          • [description] - Описание ответа
          • [details] - Прочая информация об ответе
    • [final] - Содержит итоговый результат работы, если позволяют выявленные ошибки обращения. В большинстве случаев, если этот ключ отсуствует, это означает что запрос прошел неуспешно. Детали нужно смотреть в таблице ответов по каждому узлу.
    • [time] - Содержит время unixtime, когда ответ был сгенерирован.

Описание всех успехов (successes) и ошибок (errors), по данной версии API, будут собраны на отдельной странице.

Некоторые ошибки в ответе малозначимые и разрешают обращение к скрипту и обработку запроса. Например, если вы не указали [api_version], LF-сервис покажет ошибку, вставит сам последнюю актуальную версию, но продолжит выполнение запроса.

Версия API

Настоятельно рекомендуем указывать предпочитаемую версию API во всех запросах, потому что при отсутствии версии, LF подставляет последнюю актуальную. Иначе, может случится так, что ваш собственный скрипт отправляет запрос, будучи настроенным на v1_up_limits, а LF подставляет версию v1.3 или v2, где совсем другая обработка, другие ответы, другая логика узлов.

В запросе к узлам можно указывать версию API следующим образом (цифры и латинские буквы):

[api_version] => 'string'

Главный токен

Главный токен используется для идентификации пользователя во всех запросах без исключения. Его можно изменить только вручную с личного кабинета.

В запросе в значении допускаются только цифры "0-9", латинские буквы "a-z" и "A-Z", знак подчеркивания "_". Пример: [main_token] => 'PD1k0qeo123j4rJ'.

Описание API

Название данной версии API: v1_up_limits - так нужно прописывать при обращении к скрипту.

source

Узел через который вы можете управлять определенным источником. Используя его, вы можете менять источник (название, статус и т.д.), создавать источник, удалять источник и проводить прочие манипуляции. Пример обращения: /api/source/create

С момента создания плагина, от 16.10.22, для WordPress создание источников стало доступно вручную, из личного кабинета.

create

Конечный узел, через который создается источник. Лимит источников для данной версии API - 20.

Пример:

[
   'api_version' => 'v1_up_limits',
   'main_token' => 'token_code',
   'query_details' => 
   [
      'source_name' => 'name'
   ]
]
url = https://lf.statusnick.com/api/source/create
ПараметрТипRequirementsОписание
[source_name]stringОбязательно. Цифры, латинские буквы и подчеркивание.Имя источника для визуальной идентификации в личном кабинете LF-сервиса. На своей стороне вы можете генерировать автоматически, например, в PHP: "Discord_" . date('d-m-Y').
Таблица запроса
ПараметрТипОписание
[source]arrayМассив полезных данных.
[source][source_name]stringИмя источника. Должно быть уникальным среди всех источников аккаунта. Как вариант можно вписывать сюда префикс из названия и внешний ID, например, discord_987654321123456789.
[source][source_token]stringУникальный токен источника.
[source][source_created]stringДата создания источника.
[source][source_status]stringСтатус источника по умолчанию.
[source][source_balance]integerБаланс источника после создания. По умолчанию - 0.
[source][source_balance_solo]stringПараметр для определения самостоятельности баланса. Источник может иметь свой собственный баланс, отдельный от баланса аккаунта. По умолчанию no/false.
[source][source_count]stringОбщее количество источников для контроля их количества с учетом ограничения.
Таблица ответа

get

Этот пункт позволит вам получить информацию о конкретном источнике.

Пример:

[
   'api_version' => 'v1_up_limits',
   'main_token' => 'user_token_code',
   'query_details' => 
   [
      'source_token' => 'source_token_code'
   ]
]
url = https://lf.statusnick.com/api/source/get
ПараметрТипRequirementsОписание
[source_token]stringОбязательно. Цифры, латинские буквы и подчеркивание.Уникальный токен источника.
Таблица запроса
ПараметрТипОписание
[count]stringКоличество найденных источников.
[source]arrayМассив полезных данных.
[source][create_date]stringДата создания источника YYYY-MM-DD HH:MM:SS.
[source][source_name]stringИмя источника.
[source][source_token]stringУникальный токен источника.
[source][source_status]stringСтатус источника. Может быть active или pause.
[source][source_tags]arrayМассив меток.
[source][source_tags][n]stringСтрока с названием одной метки.
[source][source_balance]integer/floatБаланс отдельного источника.
[source][source_balance_solo]stringПараметр для определения самостоятельности баланса. Источник может иметь свой собственный баланс, отдельный от баланса аккаунта. По умолчанию false.
Таблица ответа

delete

Конечная точка для удаления одного источника. Имейте в виду: это действие не запрашивает подтверждения. Не забудьте перенести средства с такого источника на промо-баланс.

Пример:

[
   'api_version' => 'v1_up_limits',
   'main_token' => 'user_token_code',
   'query_details' => 
   [
      'source_token' => 'source_token_code'
   ]
]
url = https://lf.statusnick.com/api/source/delete
ПараметрТипRequirementsОписание
[source_token]stringОбязательно. Цифры, латинские буквы и подчеркивание.Уникальный токен источника.
Таблица запроса
ПараметрТипОписание
[source]arrayМассив полезных данных.
[source][source_name]stringИмя источника.
[source][source_count]stringОбщее количество источников после удаления.
Таблица ответа

edit_status

Конечная точка для изменения статуса источника. Доступные варианты: active/pause. Может быть полезно, если у источника самостоятельный баланс или просто хотите поставить работу источника на паузу, чтобы избежать автоматической обработки и лишних трат, например, когда был утерян токен источника.

Пример:

[
   'api_version' => 'v1_up_limits',
   'main_token' => 'user_token_code',
   'query_details' => 
   [
      'source_token' => 'source_token_code'
      'source_status' => 'active'
   ]
]
url = https://lf.statusnick.com/api/source/edit_status
ПараметрТипRequirementsОписание
[source_token]stringОбязательно. Цифры, латинские буквы и подчеркивание.Уникальный токен источника.
[source_status]stringОбязательно. Принимается только active или pause.Параметр, который задает новый статус для источника.
Таблица запроса
ПараметрТипОписание
[source]arrayМассив полезных данных.
[source][source_token]stringУникальный токен источника.
[source][source_status]arrayМассив с данными о статусах до и после изменения.
[source][source_status][before]stringСтатус источника до изменения.
[source][source_status][after]stringСтатус источника после изменения.
Таблица ответа

edit_tags

Эта конечная точка позволяет вам устанавливать и/или удалять теги. Точно знаем, что в будущем пригодится чтобы сгруппировать или указать запрос, отсортировать в личном кабинете. Пока что не используется, но будет.

В случае, когда [source_tag][add][][tag] равен [source_tag][remove][][tag] такой тег из списка удаления будет удален.

Когда вы используете clear, параметр remove бесполезен.

Количество тегов для каждого источника ограничено 5.

Пример:

[
   'api_version' => 'v1_up_limits',
   'main_token' => 'user_token_code',
   'query_details' => 
   [
      'source_token' => 'source_token_code'
      'source_tags' => 
      [
         'add' => 
         [
            'telegram',
            'public',
            'stuffs'
         ],
         'remove' =>
         [
            'alice'
         ],
         'clear' => true
      ]
   ]
]
url = https://lf.statusnick.com/api/source/edit_tags
ПараметрТипRequirementsОписание
[source_token]stringОбязательно. Цифры, латинские буквы и подчеркивание.Уникальный токен источника.
[source_tags]arrayРекомендуется как минимум один вложенный массив с добавляемыми или удаляемыми метками или с параметром clear.Массив массивов или массив строк и логических значений. Содержит массивы для добавления, удаления или очистки тегов.
[source_tags][add]arrayОпционально.Содержит список меток для добавления.

Обратите внимание, что при совпадении названий тегов в списке удаляемых и в списке добавляемых, список добавляемых имеет приоритет.
[source_tags][add][n][tag]stringОпционально. String. Цифры, латинские буквы и подчеркивание.Имя добавляемой метки.
[source_tags][remove]arrayОпционально.Содержит список меток для удаления.

Обратите внимание, что при совпадении названий тегов в списке удаляемых и в списке добавляемых, список добавляемых имеет приоритет.
[source_tags][remove][n][tag]stringОпционально. String. Цифры, латинские буквы и подчеркивание.Имя удаляемой метки.
[source_tags][clear]booleanОпционально. По умолчанию false/0Очищает все теги, связанные с источником. Если этот параметр будет равен 1, будут удалены все теги. Если параметр будет равен 0, массового удаления не произойдет.

Обратите внимание, что параметр clear=1, переданный вместе с набором тегов для добавления, срабатывает первым. То есть можно сначала полностью очистить теги, а потом добавятся указанные теги.
Таблица запроса
ПараметрТипОписание
[source]arrayМассив полезных данных.
[source][source_token]stringУникальный токен источника.
[source][source_tags]arrayМассив массивов с добавленными или удаленными метками.
[source][source_tags][added]array/stringВ ситуации, когда нет добавленных меток или этот параметр пуст, возвращается строка, в ином случае возвращается массив добавленных меток.
[source][source_tags][removed]array/stringВ ситуации, когда нет удаленных меток или этот параметр пуст, возвращается строка, в ином случае возвращается массив добавленных меток.
[source][source_tags][clear]stringЕсли этот параметр возвращается со значением true, значит очистка всех меток прошла успешно.
[source][source_tags][count]integerОбщее количество меток после добавления, удаления, очистки.
[source][source_tags][list]arrayМассив строк с полным списком меток, связанных с источником, после удаления/добавления/очистки.
Таблица ответа

sources

Обращение к этому узлу генерирует ответ, связанный с несколькими (а не только с одним) проверяемыми источниками. Например, /api/sources/get - возвращает список источников с основными характеристиками, а /api/sources/delete - удалит все источники.

Не следует сильно полагаться на этот узел, потому что он сделан как временное решение и может быть отключен в какой-то период, например, по достижении некоторой степени нагрузки. Лучше сохраняйте данные о созданных источниках на своей стороне. Скажем, лучше запоминать на своей стороне токен источника, чтобы потом по нему получать данные об источнике через узел source.

get

Конечный узел для получения информации по вашим источникам в LF-сервисе.

Пример:

[
   'api_version' => 'v1_up_limits',
   'main_token' => 'user_token_code',
   'query_details' => []
]
url = https://lf.statusnick.com/api/sources/get
ПараметрТипRequirementsОписание
---Не имеет специальных параметров.
Таблица запроса
ПараметрТипОписание
[count]stringКоличество найденных источников.
[sources]arrayМассив полезных данных по нескольким источникам.
[sources][n]arrayМассив данных о конкретном источнике.
[sources][n][create_date]stringДата создания источника YYYY-MM-DD HH:MM:SS.
[sources][n][source_name]stringИмя источника.
[sources][n][source_token]stringУникальный токен источника.
[sources][n][source_status]stringСтатус источника. Может быть active или pause.
[sources][n][source_tags]arrayМассив из меток источника. В будущих версиях API метки помогут с идентификацией, группировкой, массовой обработкой.
[sources][n][source_tags][n]stringСтрока с названием метки.
[sources][n][source_balance]integer/floatБаланс отдельного источника.
[sources][n][source_balance_solo]stringПараметр показывает, имеет ли источник независимый баланс. Если имеет, то источник тратит средства только со своего собственного баланса, а не с баланса аккаунта.
Таблица ответа

delete

Конечный узел, который позволяет удалить все источники навсегда. Совсем навсегда, без дополнительного подтверждения. Не забудьте перенести средства с источников на промо-баланс.

Пример:

[
   'api_version' => 'v1_up_limits',
   'main_token' => 'user_token_code',
]
url = https://lf.statusnick.com/api/sources/delete
ПараметрТипRequirementsОписание
---Не имеет специальных параметров.
Таблица запроса
ПараметрТипОписание
[sources]arrayМассив полезных данных по нескольким источникам.
[sources][n]stringСтроки с названиями удаленных источников.
Таблица ответа

balance

Узел, который позволяет работать с балансом, средствами, например, перемещать средства.

Существует общий баланс счета, а также балансы отдельных источников. Отдельный баланс необходим, если вам нужно ограничить работу определенного источника определенной суммой, в то время как другие источники будут использовать общий баланс пользователя и не перестанут работать до тех пор, пока общий баланс пользователя не перестанет быть положительным.

По умолчанию каждый созданный источник имеет общий баланс с пользователем. Это контролируется параметром source_balance_solo.

На данный момент существует два типа пользовательского баланса и один тип баланса источника: user_balance_promo, user_balance_payed, source_balance.

Будьте осторожны: все средства, возвращенные из источника, поступают на промо-баланс пользователя.

get

Этот конечный узел позволяет получить полное состояние баланса, включая баланс всех источников суммарно и балансы пользовательские.

Пример:

[
   'api_version' => 'v1_up_limits',
   'main_token' => 'user_token_code',
]
url = https://lf.statusnick.com/api/balance/get
ПараметрТипRequirementsОписание
---Не имеет специальных параметров.
Таблица запроса
ПараметрТипОписание
[balance]arrayНабор различных данных о балансе
[balance][total]integer/floatСуммарный баланс со всех источников и балансов аккаунта.
[balance][sources]integer/floatСуммарный баланс всех источников.
[balance][user]arrayСодержит массив с данными о промо-балансе и оплаченном балансе.
[balance][user][user_balance_payed]integer/floatИнформация о текущем оплаченном балансе.
[balance][user][user_balance_promo]integer/floatИнформация о текущем промо-балансе.
Таблица ответа

move

Этот конечный узел позволяет перемещать средства между конкретным источником и балансом пользователя. Пригодится, когда источник должен иметь отдельный расход средств.

Это единственный способ пополнить баланс источника.

При перемещении средств внутри аккаунта, сумма после запятой (копейки) обнуляется и на доноре и на реципиенте.

Пример:

[
   'api_version' => 'v1_up_limits',
   'main_token' => 'user_token_code',
   'query_details' => 
   [
      'source_token' => 'source_token_code'
      'direction' => 'source'
      'amount' => 10
   ]
]
url = https://lf.statusnick.com/api/balance/move
ПараметрТипRequirementsОписание
[source_token]stringОбязательно. Цифры, латинские буквы и подчеркивание.Уникальный токен источника.
[direction]stringПо умолчанию source, другое значение user.Направление перевода - куда направить баланс. Любые непредусмотренные значения равны параметру по умолчанию. Перевод в сторону пользователя возможен только на промо-баланс.
[amount]integerОбязательно. Максимально 10000 (десять тысяч), минимально 10.Количество средств для перевода.
Таблица запроса
ПараметрТипОписание
[source]arrayМассив полезных данных.
[source][source_token]stringУникальный токен источника.
[source][source_balance]arrayСодержит два параметра, характеризующих состояние баланса источника до и после перевода средств.
[source][source_balance][before]stringСостояние баланса до перевода средств.
[source][source_balance][after]stringСостояние баланса после перевода средств.
[user]arrayНабор данных о пользовательском балансе.
[user][user_balance_payed]arrayСодержит два параметра, характеризующих состояние оплаченного баланса пользователя до и после перевода средств.
[user][user_balance_payed][before]stringСостояние баланса пользователя на оплаченном балансе до перевода средств.
[user][user_balance_payed][after]stringСостояние баланса пользователя на оплаченном балансе после перевода средств.
[user][user_balance_promo]arrayСодержит два параметра, характеризующих состояние промо-баланса пользователя до и после перевода средств.
[user][user_balance_promo][before]stringСостояние баланса пользователя на промо-балансе до перевода средств.
[user][user_balance_promo][after]stringСостояние баланса пользователя на промо-балансе после перевода средств.
Таблица ответа

edit_solo

Этим запросом вы можете повлиять на то, будет ли финансироваться источник из общего баланса пользователя или будет ограничен лишь тем балансом, который на источник переведен.

Пример:

[
   'api_version' => 'v1_up_limits',
   'main_token' => 'user_token_code',
   'query_details' => 
      [
         'source_token' => 'source_token_code'
         'source_balance_solo' => 'yes'
      ]
]
url = https://lf.statusnick.com/api/balance/edit_solo
ПараметрТипRequirementsОписание
[source_token]stringОбязательно. Цифры, латинские буквы и подчеркивание.Уникальный токен источника.
[source_balance_solo]stringМожет быть только 'yes' или 'no'Параметр для определения самостоятельности баланса.
Таблица запроса
ПараметрТипОписание
[source]arrayМассив полезных данных.
[source][source_name]stringИмя источника.
[source][source_token]stringУникальный токен источника.
[source][source_balance]stringСодержит данные о балансе выбранного источника
[source][source_balance_solo]stringПараметр для определения самостоятельности баланса. Источник может иметь свой собственный баланс, отдельный от баланса аккаунта. По умолчанию false.
Таблица ответа

text

В этом узле происходит проверка и предпроверка (оценка длины и стоимости) вашего текста.

Существует два основных метода: precheck - чтобы на своей стороне перед проверкой (и оплатой) ваш скрипт мог посчитать какая длина проверяемого текста по мнению нашего API, и какая конечная стоимость будет за проверку переданного текста перед непосредственно проверкой методом check.

precheck

Таким запросом вы можете узнать, какая длина переданного текста распознается на нашей стороне и стоимость за проверку текста. Если скрипт на вашей стороне согласится с результатами предпроверки, то можно запросить уже непосредственно саму проверку текста методом check.

Рекомендуем использовать precheck перед отправкой на проверку. Например, вы можете установить на стороне вашего скрипта, чтобы отклонение стоимости проверки было не более 5% (или другого значения на ваше усмотрение), и если наш precheck посчитает сумму больше, чем ожидает ваш скрипт, то вы предотвратите неожиданные траты.

Длину проверяемого текста оба узла считают одним методом.

Пример:

[
   'api_version' => 'v1_up_limits',
   'main_token' => 'user_token_code',
   'query_details' => 
      [
         'source_token' => 'source_token_code'
         'text' => 'some_text'
      ]
]
url = https://lf.statusnick.com/api/text/precheck
Описание
Все параметры аналогичны запросу на узел check с той разницей, что здесь возвращается только стоимость проверки
Таблица запроса
ПараметрТипОписание
[source]arrayМассив полезных данных.
[source][source_name]stringИмя источника.
[source][source_token]stringУникальный токен источника.
[source][source_balance_solo]stringПараметр для определения самостоятельности баланса. Источник может иметь свой собственный баланс, отдельный от баланса аккаунта. По умолчанию false.
[text]arrayМассив с параметрами, относящимися к предварительной проверке текста.
[text][encoding]stringКакой тип строки определило наше API.
[text][length]stringКакую длину в символах определило наше API.
[text][check_cost]stringВ какую стоимость оценило наше API проверку входящего текста.
[balance]arrayМассив с данными о балансе источника ИЛИ о балансе пользователя. Что будет отображено зависит от того, включен ли отдельный расход у источника или расход со счета пользователя - через параметр source_balance_solo.
[balance][source_balance]arrayСодержит два значения: баланс до проверки и расчетный баланс после проверки.
[balance][source_balance][before]stringБаланс источника до проверки.
[balance][source_balance][after]stringБаланс источника после проверки.
[balance][user_balance_total]arrayСодержит два значения: баланс до проверки и расчетный баланс после проверки.
[balance][user_balance_total][before]stringБаланс пользователя до проверки.
[balance][user_balance_total][after]stringБаланс пользователя после проверки.
Таблица ответа

check

Этот конечный узел принимает текст на проверку, проверяет и выдает результат проверки.

Пример:

[
   'api_version' => 'v1_up_limits',
   'main_token' => 'user_token_code',
   'query_details' => 
      [
         'source_token' => 'source_token_code'
         'text' => 'some_text'
         'dictionaries' =>
            [
               'rus' => 
                  [
                     'heavy',
                     'terrorism',
                  ]
               'eng' => 
                  [
                     'heavy',
                  ]
            ],
         'deep_check' => 'yes',
         'translit_check': 'yes',
         'stylized_check': 'yes'
      ]
]
url = https://lf.statusnick.com/api/text/check
ПараметрТипRequirementsОписание
[source_token]stringОбязательно. Цифры, латинские буквы и подчеркивание.Токен того или иного источника.
[dictionaries]arrayОпционально. Максимум 5 языков и максимум 5 вариантов словарей по каждому языку.Массив с требующимися словарями. Если не указывать, по умолчанию подключается словарь русских тяжелых матов.
[dictionaries][rus]arrayОбязательно. Варианты в API v1_up_limits: rus, eng.Массив, содержащий указание на типы словарей.
[dictionaries][rus][heavy]stringОбязательно. Варианты в API v1_up_limits:

rus: heavy, expletive, terrorism, weapon, sex, economic, politic.
eng: heavy.
Тип словаря конкретного языка.

23.04.22 - словари секс-слов объединены со словарем для защиты детства, но название словаря для версии API v1_up_limits остается sex. В будущих версиях будет изменено.
[deep_check]stringОпционально. Принимает один параметр 'yes'.Позволяет сделать двойную проверку: после обычной морфемной проверки, будет проведена общая. Двойная проверка может заподозрить обычные слова.
[translit_check]stringОпционально. Принимает один параметр 'yes'.Если нужно включить проверки на частичный транслит. Обратите внимание, что речь о частичном транслите.
[stylized_check]stringОпционально. Принимает один параметр 'yes'.Если нужно включить учет стилизованного текста, например, 𝕷𝖆𝖓𝖌𝖚𝖆𝖌𝖊 𝓕𝓲𝓵𝓽𝓮𝓻
[text]stringОбязательно. UTF-8. Ограничение (в этой версии API) 1М символов за один запрос.Ваши текстовые данные для проверки.

Можете разбить на два запроса, если лимит превышается. Обратите внимание, что на вашей стороне разбивать иногда нужно чаще, потому что некоторые символы, преобразуясь, увеличивают длину входящего текста, например, € -> EUR.

В данной версии API вырезаются все теги. Теги вырезаются до подсчета количества знаков.

Обратите внимание, если будут вырезаны все теги вместе с текстом, то система сочтет, что параметр пустой и вернет соответствующую ошибку.
Таблица запроса
ПараметрТипОписание
[source]arrayМассив полезных данных.
[source][source_name]stringИмя источника.
[source][source_token]stringУникальный токен источника.
[source][source_balance_solo]stringПараметр для определения самостоятельности баланса. Источник может иметь свой собственный баланс, отдельный от баланса аккаунта. По умолчанию false.
[source][source_expenses]stringОтображает суммарные расходы по источнику.
[user]arrayМассив данных об аккаунте.
[user][user_expenses]stringРасходы по аккаунту.
[text]arrayМассив с параметрами, относящимися к предварительной проверке текста.
[text][encoding]stringКакой тип строки определило наше API.
[text][length]stringКакую длину в символах определило наше API.
[text][check_cost]stringСколько списано за проверку входящего текста.
[balance]arrayМассив с данными о балансе источника ИЛИ о балансе пользователя. Что будет отображено зависит от того, включен ли отдельный расход у источника или расход со счета пользователя - через параметр source_balance_solo.
[balance][source_balance]arrayСодержит два значения: баланс до проверки и расчетный баланс после проверки.
[balance][source_balance][before]stringБаланс источника до проверки.
[balance][source_balance][after]stringБаланс источника после проверки.
[balance][user_balance_total]arrayСодержит два значения: баланс до проверки и расчетный баланс после проверки.
[balance][user_balance_total][before]stringБаланс пользователя до проверки.
[balance][user_balance_total][after]stringБаланс пользователя после проверки.
[check][check_result][n]arrayМассив данных о результатах проверки.
[check][check_result][n][suspected_word]stringНайденное запрещенное слово.
[check][check_result][n][approximate_position]stringПримерная позиция слова в тексте. В данной версии API мы указываем приблизительную позицию в тексте, поскольку эта версия API вырезает HTML-теги, знаки препинания и т.д.

Обратите внимание, что этот параметр иногда может не приходить - зависит от ситуации обнаружения слова.
[check][check_result][n][approximate_length]stringДлина запрещенного слова.
[check][check_result][n][translit_found]stringЕсли присутствует в выдаче, значит в этом слове найдено использование букв из разных языков.

Разработчик здесь не акцентирует внимание на той или иной степени запрещенности слова с частичной транслитерацией, подразумевая, что частичная транслитерация - признак вуалирования чего-бы то ни было, даже не входящего в установленные словари LF-сервиса.
[check][check_result][n][substitution_found]stringЕсли присутствует в выдаче, значит в этом слове найдено использование символов заменяющих буквы.

Разработчик здесь не акцентирует внимание на той или иной степени запрещенности слова, подразумевая, что факт замены - признак вуалирования чего-бы то ни было, даже не входящего в установленные словари LF-сервиса.
Таблица ответа

Стоимость

Расчеты приведены в российских рублях.

Данная версия лучше подходит для проверки больших объемов текста, более 20К символов, а также для более быстрого снятия висящей задачи. Позднее этот API будет доступен только в рамках персонально выделенных ресурсов с посуточным списанием.

C 06.10.23 основная стоимость каждой проверки:

  • 0.000007 руб. (0.0007 коп.) - за один знак при обычной проверке
  • 0.004 руб. (0.4 коп.) - стоимость за запрос.

Дополнительные параметры в каждой проверке с 06.10.23:

  • 0.000017 руб. (0.0017 коп.) - за один знак при глубокой проверке deep_check
  • 0.01 руб. (1 коп.) - за один словарь (не знак) при подключении более 2-х словарей, за каждый последующий.
  • 0.000005 руб. (0.0005 коп.) - при включении метода translit_check, добавляется за симв.

С 07.08.24 добавлено:

  • 0.000003 руб - за один знак при включении поиска стилизованного текста stylized_check

Другими словами, при управлении через API, для вас открыта свобода настройки, каким словарями пользоваться, какие методы проверки подключать, каким образом расходовать средства. При использовании наших приложений (ботов, плагинов и т.д.) стоимость установлена набором заранее включенных методов и словарей. Смотрите описание приложений в кабинете.

Пример расчета

Вариант 1: проверим роман "Война и мир".

Этот роман удобно брать для расчета, потому что все его читали и представляют объем произведения.

Входные данные:

  1. Текст: "Война и мир" - 3 млн. знаков * 0.000007 = 21 руб.
  2. Если включили 'deep_check', то: 3 млн. знаков * 0.000017 = 51 руб.
  3. Количество обращений к API если разделить роман на 3 части * 0.004 = 0.012 руб.

Другими словами, при ограничении в API v1_up_limits на количество символов в размере 1М, можно разделить проверку романа "Война и мир" на 3 обращения к API. Тогда при глубокой проверке, общая стоимость составит: 21 + 51 + 0.012 = 72.012 рублей.

Вариант 2: сообщения из чата

Этот расчет чуть сложнее предыдущего, но даст больше понимания владельцам чатов, сайтов, смс-служб и т.д..

Возьмем по максимуму обороты в условном чате. Будем считать, что длинные сообщения (более 200 знаков) пишут редко, в основном все короткие, вроде «Как дела» или какой-то анекдот в 4-5 строчек.

При таком подходе все равно будем считать по искусственно завышенным показателям. Сразу вычисляем с параметром "глубокая проверка".

Входные данные:

  1. Каждую секунду в чате появляется сообщение — в сутки выйдет 86400 сообщений.
    1. 70% сообщений — 200 знаков = 86400 * 0.7 * 0.000024 * 200 = 290,304 руб.
    2. 30% сообщений — 1000 знаков = 86400 * 0.3 * 0.000024 * 1000 = 622,08 руб.
  2. Суммарная стоимость всех обращений к сервису = 86400 * 0.004 = 345,6 руб.

Итого: 1 257,984 рублей.

По наблюдениям, только 2-5% пользователей чата пишут сообщения, остальные пребывают в пассивном состоянии. Это значит, что для достижения подобных трат в день, необходимо, чтобы в вашем чате было — возьмем 10% активных — минимум 864 000 пользователей