Documentation de l'API de candy-content.com

L'API est disponible à l'adresse: https://candy-content.com/api/check-uniqueness/

Type de requête: POST
La requête se fait au format JSON
La réponse est au format JSON

Actuellement, seule une méthode d'API est disponible: la vérification de l'unicité du texte. Toutes les autres actions, telles que la vérification du solde, le rechargement du compte, et tous les autres outils ne fonctionnent que via le bot Telegram - http://t.me/JuniorSeoBot/

Pour utiliser l'API, vous aurez besoin d'une api_key. Vous pouvez l'obtenir via le bot dans la section “Mon compte” -> API -> “Ma clé API”:

Pour toute question technique et assistance, contactez l'administrateur http://t.me/sergei4e/

Méthodes de l'API

1. /check-uniqueness/

Paramètres de la requête

Champs obligatoires:
api_key – votre clé API,
text – texte à vérifier ou URL de la page avec http.

Champs facultatifs:
precision – responsable de la qualité et de l'exhaustivité de la vérification.
Par défaut, la valeur est “better” et le coût de cette vérification est de 1 🍭 pour chaque 5000 caractères.
Il peut être réglé sur “best”, alors la qualité de la vérification peut augmenter, le coût sera de 2 🍭 pour chaque 5000 caractères.
ignore_domain - le domaine ignoré lors de la vérification.

Requête:

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 = """
Après avoir déménagé en 1831 de Vilnius à Saint-Pétersbourg, le propriétaire terrien P. Engelhardt a emmené Shevchenko[42],
et pour tirer profit plus tard des œuvres d'art de son propre "artiste de chambre",
il a signé un contrat et l'a envoyé pour quatre ans à l'artiste peintre V. Shiryaev,
chez qui Taras a vécu jusqu'en 1838[43]. Dans l'atelier de Shiryaev, Shevchenko était entouré de jeunes gens talentueux,
comme lui, issus des classes inférieures – des serfs ou des affranchis et des citoyens,
qui aspiraient à mieux maîtriser l'art de la peinture, à devenir des artistes.[44]
Shiryaev traitait ses élèves avec rigueur, dans son autobiographie et dans le récit "L'artiste" Shevchenko écrivait
de lui comme "une personne avare, grossière, sévère et despotique". Habituellement, Shiryaev signait des contrats
pour huit ans : cinq d'entre eux étaient consacrés à l'apprentissage, et pendant les trois années suivantes, l'élève devait
"compenser le maître pour l'apprentissage", en travaillant pour lui.
"""

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

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

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

Réponse:

api_examples % python check_uniquness.py

Temps de travail: 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%'
}
}

Messages d'erreur

Le texte envoyé pour vérification est trop court

{ "response": "Texte trop court" }

Utilisateur non autorisé (probablement la clé api est incorrecte)

{ "response": 401 }

JSON non valide dans la requête à l'API

{ "response": "Erreur de décodage JSON caractère de contrôle non valide à: ligne 3 colonne 172 (caractère 226)" }