Documentatie voor de API van candy-content.com

De API is beschikbaar op: https://candy-content.com/api/check-uniqueness/

Type verzoek: POST
Het verzoek wordt gedaan in JSON-formaat
Het antwoord wordt geleverd in JSON-formaat

Momenteel is er slechts één API-methode beschikbaar: het controleren van de originaliteit van de tekst. Alle andere acties, zoals het controleren van het saldo, het opladen van de account, en alle andere hulpmiddelen werken alleen via de Telegram-bot - http://t.me/JuniorSeoBot/

Om de API te gebruiken, heeft u een api_key nodig. Dit kunt u verkrijgen via de bot in de sectie “Mijn account” -> API -> “Mijn API-sleutel”:

Voor technische vragen en ondersteuning kunt u contact opnemen met de beheerder http://t.me/sergei4e/

API-methoden

1. /check-uniqueness/

Verzoekparameters

Verplichte velden:
api_key – uw API-sleutel,
text – tekst voor controle of URL van de pagina met http.

Optionele velden:
precision – verantwoordelijk voor de kwaliteit en volledigheid van de controle.
Standaard is de waarde “better”, de kosten van zo’n controle zijn 1 🍭 per 5000 tekens.
Het kan worden ingesteld op “best”, dan kan de kwaliteit van de controle verbeteren, de kosten zijn 2 🍭 per 5000 tekens.
ignore_domain - het domein dat wordt genegeerd tijdens de controle.

Verzoek:

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 = """
Na in 1831 van Vilnius naar Sint-Petersburg te zijn verhuisd, nam landheer P. Engelhardt Shevchenko[42] mee,
en om later winst te maken op de kunstwerken van zijn eigen "kamerkunstenaar",
ondertekende hij een contract en stuurde hem voor vier jaar naar schilder V. Shiryaev,
bij wie Taras tot 1838 woonde[43]. In de werkplaats van Shiryaev werd Shevchenko omringd door getalenteerde jonge mensen,
zoals hij, afkomstig uit de lagere klassen – lijfeigenen of vrijgelatenen en burgers,
die ernaar streefden beter het schilderen onder de knie te krijgen en kunstenaars te worden.[44]
Shiryaev behandelde zijn leerlingen streng, in zijn autobiografie en het verhaal "De kunstenaar" schreef Shevchenko
over hem als "een gierige, grove, strenge en despotische persoon". Meestal sloot Shiryaev contracten
voor acht jaar: vijf daarvan waren bestemd voor opleiding, en gedurende de volgende drie jaar moest de leerling
"de meester compenseren voor de opleiding", werkend voor hem.
"""

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

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

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

Antwoord:

api_examples % python check_uniquness.py

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

Foutmeldingen

De verzonden tekst is te kort

{ "response": "Tekst te kort" }

Gebruiker niet geautoriseerd (vermoedelijk is de api_key onjuist)

{ "response": 401 }

Ongeldige JSON in het verzoek naar de API

{ "response": "JSONDecodeError ongeldige besturingsteken op: regel 3 kolom 172 (teken 226)" }