Dokumentacja API candy-content.com

API działa pod adresem: https://candy-content.com/api/check-uniqueness/

Typ zapytań: POST
Zapytania są w formacie JSON
Odpowiedzi są w formacie JSON

Obecnie działa tylko jedna metoda API - sprawdzanie unikalności tekstu. Wszystkie inne działania takie jak sprawdzanie salda, doładowanie konta, i inne narzędzia są dostępne tylko przez bota Telegram - http://t.me/JuniorSeoBot/

Aby korzystać z API, potrzebny będzie api_key. Można go uzyskać przez bota w sekcji „Moje konto” -> API -> „Mój klucz API”:

W przypadku jakichkolwiek pytań technicznych i wsparcia, skontaktuj się z administratorem http://t.me/sergei4e/

Metody API

1. /check-uniqueness/

Parametry zapytania

Pola obowiązkowe:
api_key - twój klucz API,
text - tekst do sprawdzenia lub URL strony z http.

Pola opcjonalne:
precision - określa jakość i pełność sprawdzenia.
Domyślnie ma wartość „better”, koszt takiego sprawdzenia to 1 🍭 za każde 5000 znaków.
Można ustawić „best”, wtedy jakość sprawdzenia może wzrosnąć, koszt będzie 2 🍭 za każde 5000 znaków.
ignore_domain - domena ignorowana podczas sprawdzania.

Zapytanie:

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 = """
W 1831 roku, po przeprowadzce z Wilna do Petersburga, właściciel ziemski P. Engelhardt zabrał ze sobą Szewczenkę[42],
a aby w przyszłości zyskać na artystycznych dziełach swojego "domowego artysty",
podpisał kontrakt i wysłał go na cztery lata do nauki u malarza W. Szira, u którego Taras mieszkał do 1838 roku[43].
W warsztacie Szira, Szewczenko otaczali inni utalentowani młodzi ludzie,
jak on sam, z niższych warstw społecznych - chłopi pańszczyźniani lub wyzwoleni oraz mieszczanie, którzy pragnęli lepiej opanować sztukę malarską i zostać artystami.[44]
Szira traktował swoich uczniów surowo; w swojej autobiografii i opowiadaniu "Artysta", Szewczenko pisał
o nim jako o "chciwym, surowym, despotycznym człowieku". Zazwyczaj Szira podpisywał kontrakty
na osiem lat: pięć z nich przeznaczonych było na naukę, a przez kolejne trzy lata uczeń
miał "odpłacić mistrzowi za naukę" pracując dla niego.
"""

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())

Odpowiedź:

api_examples % python check_uniqueness.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%'
    }
}

Komunikaty błędów

Tekst wysłany do sprawdzenia jest za krótki

{ "response": "Too small text" }

Użytkownik nie jest autoryzowany (prawdopodobnie nieprawidłowy api_key)

{ "response": 401 }

Nieprawidłowy JSON w zapytaniu do API

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