candy-content.com API dokumentacija

API veikia adresu: https://candy-content.com/api/check-uniqueness/

Užklausų tipas: POST
Užklausa pateikiama formatu JSON
Atsakymas pateikiamas formatu JSON

Dabar veikia tik vienas API metodas – teksto unikalumo tikrinimas. Visos kitos funkcijos, kaip balansų tikrinimas, sąskaitos papildymas, visi kiti įrankiai veikia tik per Telegram botą - http://t.me/JuniorSeoBot/

Norėdami dirbti su API, jums reikės api_key. Jį galima gauti per botą skyriuje “Mano paskyra” -> API -> “Mano API raktas”:

Dėl bet kokių techninių klausimų ir palaikymo kreipkitės į administratorių http://t.me/sergei4e/

API metodai

1. /check-uniqueness/

Užklausos parametrai

Privalomi laukai:
api_key – jūsų API raktas,
text – tekstas tikrinimui arba puslapio URL su http.

Neprivalomi laukai:
precision – atsako už patikrinimo kokybę ir išsamumą.
Pagal numatytąją reikšmę nustatyta “better”, tokio patikrinimo kaina yra 1 🍭 už kiekvienus 5000 simbolių.
Galite nustatyti “best”, tada patikrinimo kokybė gali pagerėti, kaina bus 2 🍭 už kiekvienus 5000 simbolių.
ignore_domain - domenas, kuris nepaisomas tikrinimo metu.

Užklausa:

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 = """
Pereikdamas 1831 m. iš Vilniaus į Peterburgą, ponas P. Engelgardtas pasiėmė su savimi Ševčenką[42],
o kad vėliau gautų pelną iš asmeninio „kambarinio dailininko“ kūrinių,
pasirašė sutartį ir atidavė jį mokytis ketveriems metams pas tapytoją V. Širjajevą,
pas kurį ir apsigyveno Tarasas iki 1838 metų[43]. Širjajevo dirbtuvėse Ševčenką supo tokie pat,
kaip ir jis, talentingi jauni žmonės – žemų socialinių sluoksnių atstovai – baudžiauninkai arba išlaisvinti
iš baudžiavos ir miestiečiai, kurie norėjo geriau įvaldyti tapybos meną, tapti dailininkais.[44]
Širjajevas su mokiniais elgėsi griežtai, savo autobiografijoje ir apsakyme „Dailininkas“ Ševčenka rašė
apie jį kaip apie „godžią, grubią, griežtą ir despotinę“ asmenybę. Paprastai Širjajevas pasirašydavo sutartis
aštuoneriems metams: penkerius iš jų skirdavo mokymuisi, o likusius trejus metus mokinys
turėjo „atidirbti už mokymą“, dirbdamas jam.
"""

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

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

print(f"Darbo laikas: {round(t2-t1, 2)} sek")
pprint(response.json())

Atsakymas:

api_examples % python check_uniquness.py

Darbo laikas: 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%'
}
}

Klaidos pranešimai

Tekstas, pateiktas patikrinimui, yra per trumpas

{ "response": "Per mažas tekstas" }

Vartotojas neautorizuotas (tikriausiai neteisingai nurodytas api_key)

{ "response": 401 }

Nevalidus JSON užklausoje į API

{ "response": "JSONDecodeError nevalidus kontrolinis simbolis: 3 eilutė, 172 stulpelis (226 simbolis)" }