Skip to main content
ستقدم هذه الوثيقة توضيحًا لواجهة برمجة تطبيقات URL القصير، والتي يمكن أن تحول URL الطويل إلى URL قصير.

عملية التقديم

لاستخدام واجهة برمجة تطبيقات URL القصير، يجب أولاً الذهاب إلى وحدة التحكم في Ace Data Cloud للحصول على رمز API الخاص بك، احتفظ به للاستخدام لاحقًا. إذا لم تكن قد قمت بتسجيل الدخول أو التسجيل بعد، فسيتم تحويلك تلقائيًا إلى صفحة تسجيل الدخول لدعوتك للتسجيل وتسجيل الدخول، وبعد الانتهاء، سيتم إرجاعك تلقائيًا إلى الصفحة الحالية. يمكن استخدام رمز API واحد لاستدعاء جميع خدمات المنصة، دون الحاجة لتقديم طلب منفصل لكل خدمة. عند التقديم لأول مرة، ستحصل على رصيد مجاني لتجربته مجانًا؛ وعند نفاد الرصيد، يمكنك إعادة شحن الرصيد العام في وحدة التحكم.
📘 الوثائق الكاملة: واجهة برمجة تطبيقات URL القصير →

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

أولاً، يجب أن نفهم طريقة الاستخدام الأساسية، وهي إدخال URL الطويل الذي نحتاج إلى تحويله، وسنحصل على النتيجة المعالجة، حيث نحتاج أولاً إلى تمرير حقل content ببساطة. بعد ذلك، يمكننا ملء المحتوى المقابل في الواجهة، كما هو موضح في الصورة:

يمكننا أن نرى هنا أننا قمنا بتعيين رؤوس الطلب، بما في ذلك:
  • accept: نوع الاستجابة التي نريد تلقيها، هنا نكتب application/json، أي بتنسيق JSON.
  • authorization: مفتاح استدعاء واجهة برمجة التطبيقات، يمكن اختياره مباشرة بعد التقديم.
كما تم تعيين جسم الطلب، بما في ذلك:
  • content: محتوى URL الذي نريد تقصيره.
بعد الاختيار، يمكننا أن نلاحظ أن الجانب الأيمن قد أنشأ أيضًا الكود المقابل، كما هو موضح في الصورة:

يمكنك الضغط على زر “Try” لإجراء الاختبار، كما هو موضح في الصورة أعلاه، وهنا حصلنا على النتيجة التالية:
تتضمن النتيجة العائدة عدة حقول، كما هو موضح أدناه:
  • success: حالة نجاح المهمة هنا.
  • data: تحتوي على URL المحول هنا.
يمكننا أن نرى أن URL الطويل الأصلي https://platform.acedata.cloud/documents/shorturl قد تم تحويله بنجاح إلى URL القصير https://surl.id/1uHCs01xa5. إذا كنت ترغب في إنشاء الكود المقابل، يمكنك نسخه مباشرة، على سبيل المثال، كود CURL كما يلي:
كود الاتصال بلغة Python كما يلي:

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

عند استدعاء واجهة برمجة التطبيقات، إذا واجهت خطأ، ستقوم واجهة برمجة التطبيقات بإرجاع رمز الخطأ والمعلومات المناسبة. على سبيل المثال:
  • 400 token_mismatched: طلب غير صحيح، ربما بسبب معلمات مفقودة أو غير صالحة.
  • 400 api_not_implemented: طلب غير صحيح، ربما بسبب معلمات مفقودة أو غير صالحة.
  • 401 invalid_token: غير مصرح، رمز تفويض غير صالح أو مفقود.
  • 429 too_many_requests: عدد كبير جدًا من الطلبات، لقد تجاوزت الحد الأقصى لمعدل الطلبات.
  • 500 api_error: خطأ داخلي في الخادم، حدث خطأ ما على الخادم.

مثال على استجابة الخطأ

الخاتمة

من خلال هذه الوثيقة، أصبحت الآن على دراية بكيفية استخدام واجهة برمجة تطبيقات URL القصير لتحويل URL الطويل إلى URL قصير. نأمل أن تساعدك هذه الوثيقة في الاتصال واستخدام هذه الواجهة بشكل أفضل. إذا كان لديك أي استفسارات، فلا تتردد في الاتصال بفريق الدعم الفني لدينا.