candy-content.com API dokumentatsioon

API töötab aadressil: https://candy-content.com/api/check-uniqueness/

Päringutüüp: POST
Päring esitatakse vormingus JSON
Vastus saadakse vormingus JSON

Praegu töötab ainult üks API meetod – teksti unikaalsuse kontroll. Kõik muud toimingud, nagu saldo kontroll, konto täiendamine, kõik teised tööriistad töötavad ainult Telegrami boti kaudu - http://t.me/JuniorSeoBot/

API-ga töötamiseks vajate api_key. Seda saab boti kaudu jaotises “Minu konto” -> API -> “Minu API võti”:

Mistahes tehniliste küsimuste ja toe puhul võtke ühendust administraatoriga http://t.me/sergei4e/

API meetodid

1. /check-uniqueness/

Päringu parameetrid

Kohustuslikud väljad:
api_key – teie API võti,
text – tekst kontrollimiseks või lehe URL koos http-ga.

Valikulised väljad:
precision – vastutab kontrolli kvaliteedi ja täielikkuse eest.
Vaikimisi on väärtus “better”, sellise kontrolli hind on 1 🍭 iga 5000 tähemärgi eest.
Võib seada väärtuse “best”, siis kontrolli kvaliteet võib paraneda, hind on 2 🍭 iga 5000 tähemärgi eest.
ignore_domain - domeen, mida kontrollimise ajal eiratakse.

Päring:

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 = """
Kolides 1831. aastal Vilniusest Peterburi, võttis mõisnik P. Engelgardt Ševtšenko endaga kaasa[42],
ja et hiljem saada kasu isikliku „toapoeet-maali“ teostest,
sõlmis ta lepingu ja andis ta neljaks aastaks maalikunstnik V. Širjajevi juurde õppima,
kus Taaras elas kuni 1838. aastani[43]. Širjajevi töökojas ümbritsesid Ševtšenkot samasugused,
nagu tema, andekad noored inimesed – madalate sotsiaalsete kihtide esindajad – pärisorjad või vabastatud
pärisorjusest ja linlased, kes soovisid paremini omandada maalikunsti, saada kunstnikeks.[44]
Širjajev käitus oma õpilastega karmilt, oma autobiograafias ja jutustuses „Kunstnik“ kirjutas Ševtšenko
temast kui „ahne, karm, jäme ja despootlik isik“. Tavaliselt sõlmis Širjajev lepingud
kaheksaks aastaks: neist viis olid määratud õppimiseks ja ülejäänud kolm aastat pidi õpilane
„tasu eest õppimise eest“ töötama tema heaks.
"""

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

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

print(f"Tööaeg: {round(t2-t1, 2)} sek")
pprint(response.json())

Vastus:

api_examples % python check_uniquness.py

Tööaeg: 38.19 sek

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

Veateated

Kontrollimiseks saadetud tekst on liiga lühike

{ "response": "Liiga lühike tekst" }

Kasutaja ei ole autoriseeritud (tõenäoliselt on api_key vale)

{ "response": 401 }

API päringus on vigane JSON

{ "response": "JSONDecodeError vigane kontrollsümbol: 3. rida, 172. veerg (226. märk)" }