Документація на API JuniorSeoBot

API працює за адресою: https://candy-content.com/api/check-uniqueness/

Тип запитів: POST
Запит оформлюєтьсяу форматі JSON
Відповідь приходить у форматі JSON

Зараз працює тільки один метод API - перевірка унікальності тексту. Всю решту дій типу перевірка балансу, поповнення рахунку, всі інші інструменти працюють лише через телеграм бота - http://t.me/JuniorSeoBot/

Для роботи з API вам знадобиться api_key. Його можна отримати через бота в розділі “Мій аккаунт” -> API -> “Мій API ключ”:

По будь яким технічним питанням та підтримці звертайтесь до адміністратора http://t.me/sergei4e/

Методи API

1. /check-uniqueness/

Параметри запиту

Обов’язкові поля:
api_key - ваш АПІ ключ,
text - текст для перевірки або URL строрінки з http.

Не обов’язкове поле:
precision - відповідає за якість та повноту перевірки.
За замовчуванням має значення “better” ціна такої перевірки 1 🍭 за кожні 5000 символів.
Можна поставити “best”, тоді якість перевірки може підвищитись, ціна буде 2 🍭 за кожні 5000 символів.

Запит:

import time
import json
import requests
from pprint import pprint

api_url = "https://candy-content.com/api/check-uniqueness/"
api_key = "your_api_key"

text = """
Переїхавши 1831 року з Вільна до Петербурга, поміщик П. Енгельгардт узяв із собою Шевченка[42],
а щоб згодом мати зиск на художніх творах власного «покоєвого художника»,
підписав контракт й віддав його в науку на чотири роки до живописця В. Ширяєва,
у якого й замешкав Тарас до 1838 року[43]. В артілі Ширяєва Шевченка оточували такі ж,
як і він, здібні молоді люди - вихідці з низьких верств народу -- кріпаки або відпущені
з кріпацтва й міщани, які прагнули краще опанувати мистецтво живопису, стати художниками.[44]
Ширяєв поводився з учнями суворо, у своїй автобіографії та повісті «Художник» Шевченко писав
про нього як «людину жадібну, грубу, сувору й деспотичну». Зазвичай Ширяєв укладав контракти
на вісім років: п'ять з них відводилися на навчання, а протягом наступних трьох років учень
повинен був «заслужити майстрові за навчання», працюючи на нього.
"""

data = {
"api_key": api_key,
"text": text
}

t1 = time.time()
response = requests.post(api_url, data=data)
t2 = time.time()

print(f"Working time: {round(t2-t1, 2)} sec")
pprint(response.json())

Відповідь:

api_examples % python check_uniquness.py

Working time: 38.19 sec

{
    'response': {
       'current_balance': 31,
        'matches_sites': {
           'https://naurok.com.ua/prezentaciya-do-biografi-t-shevchenka-308682.html': '30%',
            'https://nmetau.edu.ua/ua/mlibrary/i14/p-3/e4123': '33%',
            'https://prezi.com/p/98fxlx3_kxbr/presentation/': '67%',
            'https://uk.tgstat.com/channel/nA9e4itD2c42NjUy/2198': '44%',
            'https://www.kamenyar.com.ua/kamenyarivski-zustrichi/vydatni-ukraintsi/taras-shevchenko.html': '75%',
            'https://www.mindomo.com/mindmap/mind-map-a3f16e9b4303923c7faa86f7a244fa84': '33%',
            'https://www.wikidata.uk-ua.nina.az/%D0%A2._%D0%A8%D0%B5%D0%B2%D1%87%D0%B5%D0%BD%D0%BA%D0%BE.html': '76%'
        },
       'old_balance': 34,
       'price': 3,
       'uniqueness_text': '0%'
    }
}

Повідомлення про помилки

Текст відправлений на перевірку занадто короткий

{ "response": "Too small text" }

Користувач не авторизований (ймовірно не правильно вказаний api_key)

{ "response": 401 }

Не валідний JSON у запиті до API

{ "response": "JSONDecodeError nvalid control character at: line 3 column 172 (char 226)" }