candy-content.com API dokumentācija

API darbojas adresē: https://candy-content.com/api/check-uniqueness/

Pieprasījumu veids: POST
Pieprasījumi tiek izsūtīti JSON formātā
Atbildes tiek sniegtas JSON formātā

Pašlaik darbojas tikai viena API metode - teksta unikalitātes pārbaude. Visas citas darbības, piemēram, bilances pārbaude, konta papildināšana, un citi rīki ir pieejami tikai caur Telegram botu - http://t.me/JuniorSeoBot/

Lai izmantotu API, jums būs nepieciešams api_key. To var iegūt caur botu sadaļā “Mans konts” -> API -> “Mans API atslēga”:

Jautājumu un atbalsta gadījumā sazinieties ar administratoru http://t.me/sergei4e/

API Metodes

1. /check-uniqueness/

Pieprasījuma Parametri

Obligātie lauki:
api_key - jūsu API atslēga,
text - teksts pārbaudei vai URL lapa ar http.

Izvēles lauki:
precision - nosaka pārbaudes kvalitāti un pilnīgumu.
Noklusējuma vērtība ir “better”, šādas pārbaudes izmaksas ir 1 🍭 par katriem 5000 rakstzīmēm.
Var iestatīt “best”, tad pārbaudes kvalitāte var palielināties, izmaksas būs 2 🍭 par katriem 5000 rakstzīmēm.
ignore_domain - domēns, kas tiek ignorēts pārbaudes laikā.

Pieprasījums:

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 = """
Pārvācoties 1831. gadā no Viļņas uz Sanktpēterburgu, muižnieks P. Engelhardts paņēma līdzi Ševčenko[42],
un, lai gūtu peļņu no sava "mājas mākslinieka" darbiem,
parakstīja līgumu un nosūtīja viņu uz četriem gadiem mācīties pie gleznotāja V. Širjajeva,
pie kura Tarass dzīvoja līdz 1838. gadam[43]. Širjajeva darbnīcā Ševčenko bija apkārtējis ar citiem talantīgiem jauniešiem,
kā viņš pats, no zemākām sociālajām slāņiem - dzimtļaudis vai atbrīvotie, kuri tiecās labāk apgūt glezniecības mākslu un kļūt par māksliniekiem.[44]
Širjajevs izturējās pret saviem mācekļiem stingri; savā autobiogrāfijā un stāstā "Mākslinieks" Ševčenko rakstīja
par viņu kā "mantkārīgu, rupju, skarbu un despotisku cilvēku". Parasti Širjajevs parakstīja līgumus
uz astoņiem gadiem: piecus no tiem bija paredzēti mācībām, un nākamajos trīs gados māceklis
bija "atdarīt meistaram par mācībām", strādājot viņa labā.
"""

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

Atbilde:

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%'
    }
}

Kļūdu ziņojumi

Teksts, kas nosūtīts pārbaudei, ir pārāk īss

{ "response": "Too small text" }

Lietotājs nav autorizēts (iespējams, norādīts nepareizs api_key)

{ "response": 401 }

Nederīgs JSON pieprasījumā API

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