الانتقال إلى المحتوى الرئيسي

​
مقدمة

Short URL هي خدمة أدوات تقدمها Ace Data Cloud لإنشاء روابط قصيرة. من خلال API موحد من Ace Data Cloud، يمكنك استخدام Python لدمج خدمة Short URL بسرعة，实现 تقصير الروابط، تخصيص أسماء النطاقات، وغيرها من الوظائف.

​
المتطلبات الأساسية

  • امتلاك حساب في Ace Data Cloud والحصول على API Token
  • بيئة Python 3.7 أو أعلى
  • تثبيت مكتبة requests: pip install requests

​
الاستخدام الأساسي

نقطة النهاية الرئيسية لاستدعاء API الخاصة بـ Short URL هي: 
POST https://api.acedata.cloud/shorturl
مثال كامل على كود Python: 
import requests

url = "https://api.acedata.cloud/shorturl"
headers = {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json"
}
data = {
    "content": "https://platform.acedata.cloud"
}

response = requests.post(url, headers=headers, json=data)
result = response.json()
print(result)
يرجى استبدال YOUR_API_TOKEN بالتوكن الفعلي الذي حصلت عليه من منصة Ace Data Cloud.

​
معالجة الاستجابة

بعد الاستدعاء الناجح، يعيد API بيانات بصيغة JSON. يُنصح بفحص رمز حالة HTTP: 
if response.status_code == 200:
    result = response.json()
    print("تم الاستدعاء بنجاح:", result)
else:
    print(f"فشل الاستدعاء، رمز الحالة: {response.status_code}")
    print(response.text)

​
الاستخدام المتقدم

بالنسبة لـ API التي تدعم المهام غير المتزامنة، يمكن الحصول على النتائج عبر URL رد الاتصال: 
data['callback_url'] = 'https://your-server.com/callback'
response = requests.post(url, headers=headers, json=data)
# سيتم دفع النتائج إلى خادمك عبر URL رد الاتصال

​
معالجة الأخطاء

أكواد الأخطاء الشائعة:
رمز الحالةالوصف
401فشل التوثيق، يرجى التحقق من API Token
403رصيد غير كافٍ أو لا تملك صلاحية الوصول
429تجاوز معدل الطلبات المسموح به
500خطأ داخلي في الخادم

​
الخطوة التالية