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

يمكنك إنشاء روابط ديناميكية قصيرة باستخدام واجهة برمجة تطبيقات REST للروابط الديناميكية لـ Firebase. تقبل واجهة برمجة التطبيقات هذه إما ارتباطًا ديناميكيًا طويلاً أو كائنًا يحتوي على معلمات ارتباط ديناميكي ، وتُرجع عنوان URL مثل المثال التالي:

https://example.page.link/WXYZ

الروابط الديناميكية القصيرة التي تم إنشاؤها باستخدام API والعميل (Android / Apple) SDK لا تظهر في وحدة تحكم Firebase. هذه الروابط الديناميكية مخصصة للمشاركة بين مستخدم وآخر. لتسويق حالات الاستخدام، والاستمرار في خلق الروابط الخاصة بك مباشرة من خلال الصفحة الديناميكية سريعة من وحدة التحكم Firebase.

قبل ان تبدأ

  1. احصل على مفتاح API الخاص بك. ستحتاج إلى مفتاح API لمصادقة طلباتك إلى API. للعثور على مفتاح API الخاص بك:
    1. فتح صفحة إعدادات وحدة التحكم Firebase. إذا طُلب منك اختيار مشروع ، فحدد مشروع Firebase من القائمة.
    2. يحيط علما قيمة الحقل الويب API مفتاح.
  2. في وحدة تحكم Firebase، فتح الباب الحيوي الوصلات.
  3. إذا لم تكن قد وافقت بالفعل على شروط الخدمة وقمت بتعيين مجال للروابط الديناميكية الخاصة بك ، فقم بذلك عندما يُطلب منك ذلك.

    إذا كان لديك بالفعل مجال روابط ديناميكية ، فقم بتدوين ذلك. تحتاج إلى توفير مجال ارتباطات ديناميكية عند إنشاء روابط ديناميكية برمجيًا.

يمكنك استخدام Firebase Dynamic Links API لتقصير ارتباط ديناميكي طويل. للقيام بذلك، وجعل طلب HTTP POST إلى shortLinks نقطة النهاية، تحديد طويلة الارتباط الحيوي في 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 لتعلم كيفية إنشاء طويلة الحيوي الوصلات.

يمكنك أيضًا إنشاء ارتباط ديناميكي قصير عن طريق تحديد معلمات الارتباط الديناميكي مباشرة. للقيام بذلك، وجعل طلب HTTP POST إلى shortLinks نقطة النهاية، وتحديد المعلمات الارتباط الحيوي في 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 الكائن، راجع مرجع API .

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

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

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

https://example.page.link/UVWXYZuvwxyz12345

يتم إنشاء هذه السلاسل بواسطة تشفير base62 الذي تم إنشاؤه عشوائيًا بأرقام 96 بت. استخدم هذا الإعداد لمنع تخمين عناوين URL للروابط الديناميكية والزحف إليها ، مما قد يعرض معلومات حساسة لمستلمين غير مقصودين.

إذا قمت بتعيين المعلمة إلى "SHORT" ، والمكون الطريق ستكون سلسلة هذا هو فقط ما دامت هناك حاجة لتكون فريدة من نوعها، ويبلغ طوله لا يقل عن 4 حروف.

https://example.page.link/WXYZ

استخدم هذه الطريقة إذا لم يتم الكشف عن معلومات حساسة إذا تم تخمين عنوان 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.

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

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

للحصول على دينامية سريعة في التطبيق الخاص بك، راجع وثائق دائرة الرقابة الداخلية ، الروبوت ، C ++ ، و الوحدة .

الطلبات محددة بـ 5 طلبات / عنوان IP / ثانية ، و 200000 طلب / يوم. إذا تجاوزت، ثم استجابة سيعود رمز خطأ HTTP 429. لطلب مزيد من الحصص، وملء هذا النموذج .