إنشاء روابط ديناميكية باستخدام واجهة برمجة تطبيقات REST

يمكنك إنشاء روابط Firebase الديناميكية القصيرة باستخدام Firebase Dynamic Links REST API.Dynamic Links تقبل واجهة برمجة التطبيقات هذه إما رابطًا ديناميكيًا طويلاً أو عنصرًا يحتوي على مَعلمات رابط ديناميكي، و تعرض عنوان URL مثل المثال التالي:Dynamic LinkDynamic Link

https://example.page.link/WXYZ

لا تظهر Dynamic Links التي تم إنشاؤها باستخدام واجهة برمجة التطبيقات وحزمة تطوير البرامج (SDK) للعميل (Android/Apple) في Firebase console. تم تصميم هذه Dynamic Links للمشاركة بين المستخدمين. لأغراض التسويق، يمكنك مواصلة إنشاء روابطك مباشرةً من خلال Dynamic Links صفحة في Firebase console.

قبل البدء

  1. احصل على مفتاح واجهة برمجة التطبيقات. ستحتاج إلى مفتاح واجهة برمجة التطبيقات لمصادقة طلباتك إلى واجهة برمجة التطبيقات. للعثور على مفتاح واجهة برمجة التطبيقات:
    1. افتح صفحة الإعدادات في Firebase console. إذا طُلب منك اختيار مشروع، اختَر مشروع Firebase من القائمة.
    2. دوِّن قيمة حقل مفتاح Web API.
  2. في Firebase console، افتح قسم Dynamic Links.

  3. إذا لم تكن قد وافقت على بنود الخدمة وضبطت نطاقًا لـ Dynamic Links، يُرجى إجراء ذلك عند ظهور الطلب.

    إذا كان لديك نطاق Dynamic Links، دوِّنه. عليك تقديم نطاق Dynamic Links عند إنشاء Dynamic Links آليًا.

يمكنك استخدام Firebase Dynamic Links API لتقصير رابط ديناميكي طويل Dynamic Link. لإجراء ذلك، أرسِل طلب HTTP POST إلى نقطة النهاية shortLinks، مع تحديد الطويل Dynamic Link في المَعلمة longDynamicLink. على سبيل المثال:

POST https://firebasedynamiclinks.googleapis.com/v1/shortLinks?key=api_key
Content-Type: application/json

{
   "longDynamicLink": "https://example.page.link/?link=https://www.example.com/&apn=com.example.android&ibi=com.example.ios"
}

يمكنك الاطّلاع على مقالة إنشاء عنوان URL يدويًا لمعرفة كيفية إنشاء روابط ديناميكية طويلة Dynamic Links.

يمكنك أيضًا إنشاء رابط ديناميكي قصير من خلال تحديد مَعلمات الرابط الديناميكي مباشرةً.Dynamic LinkDynamic Link لإجراء ذلك، أرسِل طلب HTTP POST إلى shortLinks نقطة النهاية، مع تحديد Dynamic Link المَعلمات في dynamicLinkInfo المَعلمة. على سبيل المثال:

POST https://firebasedynamiclinks.googleapis.com/v1/shortLinks?key=api_key
Content-Type: application/json

{
  "dynamicLinkInfo": {
    "domainUriPrefix": "https://example.page.link",
    "link": "https://www.example.com/",
    "androidInfo": {
      "androidPackageName": "com.example.android"
    },
    "iosInfo": {
      "iosBundleId": "com.example.ios"
    }
  }
}

للاطّلاع على المواصفات الكاملة لعنصر dynamicLinkInfo، يُرجى الرجوع إلى مرجع واجهة برمجة التطبيقات.

ضبط طول رابط ديناميكي قصير Dynamic Link

يمكنك أيضًا ضبط المَعلمة suffix لتحديد كيفية إنشاء مكوِّن المسار للرابط الديناميكي القصير Dynamic Link.

تلقائيًا، أو إذا ضبطت المَعلمة على "UNGUESSABLE"، سيكون مكوِّن المسار سلسلة مكوّنة من 17 حرفًا، مثل المثال التالي:

https://example.page.link/UVWXYZuvwxyz12345

يتم إنشاء هذه السلاسل من خلال ترميز أرقام عشوائية مكوّنة من 96 بت باستخدام base62. استخدِم هذا الإعداد لمنع تخمين عناوين URL لـ Dynamic Links والزحف إليها، ما قد يؤدي إلى كشف معلومات حساسة لمستلِمين غير مقصودين.

إذا ضبطت المَعلمة على "SHORT"، سيكون مكوِّن المسار سلسلة قصيرة بقدر ما يلزم لتكون فريدة، وبطول 4 أحرف كحد أدنى.

https://example.page.link/WXYZ

استخدِم هذه الطريقة إذا لم يتم كشف معلومات حساسة في حال تخمين عنوان Dynamic Link URL قصير.

يوضّح المثال التالي كيفية ضبط المَعلمة suffix:

POST https://firebasedynamiclinks.googleapis.com/v1/shortLinks?key=api_key
Content-Type: application/json

{
   "longDynamicLink": "https://example.page.link/?link=http://www.example.com/&apn=com.example.android&ibi=com.example.ios",
   "suffix": {
     "option": "UNGUESSABLE"
   }
}

يجب أن تبدأ قيمة الرابط لصفحة في التطبيق المقدَّمة بالمخطط http:// ‎ أو https:// ‎ على الأقل. يجب أن تتطابق أيضًا مع أي قائمة بيضاء لأنماط عناوين URL تم إدخالها في وحدة التحكّم. وإلا، ستفشل واجهة برمجة التطبيقات للإنشاء مع رمز خطأ HTTP‏ 400.

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

بعد إنشاء Dynamic Links، عليك إعداد تطبيقك لتلقّي Dynamic Links وإرسال المستخدمين إلى المكان المناسب في تطبيقك بعد فتحها.

لتلقّي Dynamic Links في تطبيقك، يُرجى الاطّلاع على مستندات iOS وAndroid و C++‎ وUnity.

تقتصر الطلبات على 5 طلبات في الثانية لكل عنوان IP، و200,000 طلب في اليوم. إذا تم تجاوز هذا الحد، ستعرض الاستجابة رمز خطأ HTTP‏ 429. لطلب المزيد من الحصص، يُرجى ملء هذا النموذج.