Check out what’s new from Firebase at Google I/O 2022. Learn more

צור קישורים דינמיים עם REST API

אתה יכול ליצור קישורים דינמיים קצרים עם Firebase Dynamic Links REST API. ממשק API זה מקבל קישור דינמי ארוך או אובייקט המכיל פרמטרים של קישור דינמי, ומחזיר כתובת URL כמו הדוגמה הבאה:

https://example.page.link/WXYZ

קישורים דינמיים קצרים שנוצרו עם ה-API וה-SDK של הלקוח (Android/Apple) אינם מופיעים במסוף Firebase. קישורים דינמיים כאלה מיועדים לשיתוף משתמש למשתמש. למקרי שימוש שיווקי, המשך ליצור את הקישורים שלך ישירות דרך דף הקישורים הדינמיים של מסוף Firebase.

לפני שאתה מתחיל

  1. קבל את מפתח ה-API שלך. תזדקק למפתח API כדי לאמת את הבקשות שלך ל-API. כדי למצוא את מפתח ה-API שלך:
    1. פתח את דף ההגדרות של מסוף Firebase. אם תתבקש לבחור פרויקט, בחר את פרויקט Firebase שלך ​​מהתפריט.
    2. שים לב לערך של השדה Web API Key .
  2. במסוף Firebase, פתח את הקטע קישורים דינמיים .
  3. אם עדיין לא קיבלת את תנאי השירות והגדרת דומיין עבור הקישורים הדינמיים שלך, עשה זאת כאשר תתבקש.

    אם כבר יש לך דומיין Dynamic Links, שים לב אליו. עליך לספק דומיין של קישורים דינמיים כאשר אתה יוצר קישורים דינמיים באופן פרוגרמטי.

אתה יכול להשתמש ב-API של Firebase Dynamic Links כדי לקצר קישור דינמי ארוך. לשם כך, בצע בקשת 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 סיביות שנוצרו באקראי. השתמש בהגדרה זו כדי למנוע ניחוש וסריקה של כתובות האתרים של הקישורים הדינמיים שלך, מה שעלול לחשוף מידע רגיש לנמענים לא מכוונים.

אם תגדיר את הפרמטר ל- "SHORT" , רכיב הנתיב יהיה מחרוזת שאורכה רק כמה שצריך כדי להיות ייחודית, באורך מינימלי של 4 תווים.

https://example.page.link/WXYZ

השתמש בשיטה זו אם מידע רגיש לא ייחשף אם ניחש כתובת אתר קצרה של קישור דינמי.

הדוגמה הבאה מראה כיצד ניתן להגדיר את פרמטר 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://. זה חייב גם להתאים לרשימת ההיתרים של דפוסי כתובות אתרים שהוזנו במסוף. אחרת, ממשק ה-API ליצירת ייכשל עם קוד שגיאה HTTP 400.

הצעדים הבאים

כעת לאחר שיצרת קישורים דינמיים, עליך להגדיר את האפליקציה שלך כדי לקבל קישורים דינמיים ולשלוח משתמשים למקום הנכון באפליקציה שלך לאחר שמשתמש יפתח אותם.

כדי לקבל קישורים דינמיים באפליקציה שלך, עיין בתיעוד עבור iOS , Android , C++ ו- Unity .

הבקשות מוגבלות ל-5 בקשות/כתובת IP/שנייה ול-200,000 בקשות ליום. אם חריגה, התגובה תחזיר את קוד שגיאה HTTP 429. כדי לבקש מכסה נוספת, מלא טופס זה .