وثائق واجهة برمجة التطبيقات لـ candy-content.com

واجهة برمجة التطبيقات متاحة على: https://candy-content.com/api/check-uniqueness/

نوع الطلب: POST
يتم إرسال الطلب بصيغة JSON
يتم توفير الرد بصيغة JSON

حاليًا، يتوفر فقط طريقة واحدة لواجهة برمجة التطبيقات: التحقق من أصالة النص. جميع الإجراءات الأخرى، مثل التحقق من الرصيد، وإعادة شحن الحساب، وجميع الأدوات الأخرى تعمل فقط عبر بوت تليجرام - http://t.me/JuniorSeoBot/

لاستخدام واجهة برمجة التطبيقات، ستحتاج إلى api_key. يمكنك الحصول عليه عبر البوت في القسم "حسابي" -> API -> "مفتاح واجهة برمجة التطبيقات الخاص بي":

لجميع الأسئلة التقنية والدعم، اتصل بالمشرف http://t.me/sergei4e/

طرق واجهة برمجة التطبيقات

1. /check-uniqueness/

معايير الطلب

الحقول المطلوبة:
api_key – مفتاح واجهة برمجة التطبيقات الخاص بك,
text – النص للتحقق أو URL للصفحة مع http.

الحقل الاختياري:
precision – المسؤول عن جودة وشمولية التحقق.
افتراضيًا، القيمة هي "better" وتكلفة هذا التحقق هي 1 🍭 لكل 5000 حرف.
يمكن ضبطه على "best"، في هذه الحالة قد تزداد جودة التحقق، التكلفة ستكون 2 🍭 لكل 5000 حرف.

طلب:

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 = """
بعد الانتقال من فيلنيوس إلى سانت بطرسبرغ في عام 1831 ، أخذ مالك الأرض ب. إنجلهاخت شيفتشينكو[42]
وللاستفادة لاحقًا من الأعمال الفنية الخاصة بـ "فنان الغرفة" الخاص به ،
وقع عقدًا وأرسله لمدة أربع سنوات إلى الرسام في. شيريايف ،
حيث عاش تاراس حتى عام 1838 [43]. في ورشة عمل شيريايف ، كان شيفتشينكو محاطًا بشباب موهوبين ،
مثله ، قادمين من الطبقات الدنيا - الأقنان أو المحررين والمواطنين ،
الذين كانوا يتطلعون إلى إتقان الرسم بشكل أفضل ويصبحون فنانين.[44]
كان شيريايف يعامل طلابه بصرامة ، في سيرته الذاتية وقصة "الفنان" كتب شيفتشينكو
عنه كشخص "جشع ، وقح ، صارم واستبدادي". عادة ما كان شيريايف يوقع عقودًا
لمدة ثماني سنوات: خُصص خمسة منها للتدريب ، وخلال السنوات الثلاث التالية ، كان على الطالب
"تعويض المعلم عن التدريب" ، والعمل من أجله.
"""

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

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

print(f"وقت العمل: {round(t2-t1, 2)} ثانية")
pprint(response.json())

الرد:

api_examples % python check_uniquness.py

وقت العمل: 38.19 ثانية

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

رسائل الخطأ

النص المرسل قصير جداً للتحقق

{ "response": "النص قصير جداً" }

المستخدم غير مخول (من المحتمل أن تكون api_key غير صحيحة)

{ "response": 401 }

JSON غير صالح في الطلب إلى API

{ "response": "JSONDecodeError حرف تحكم غير صالح على: السطر 3 العمود 172 (الحرف 226)" }