Join us for Firebase Summit on November 10, 2021. Tune in to learn how Firebase can help you accelerate app development, release with confidence, and scale with ease. Register

با REST API پیوندهای پویا ایجاد کنید

با Firebase Dynamic Links REST API می توانید پیوندهای پویای کوتاه ایجاد کنید. این API یا یک پیوند پویا طولانی یا یک شیء حاوی پارامترهای پیوند پویا را می پذیرد و یک URL مانند مثال زیر را برمی گرداند:

https://example.page.link/WXYZ

پیوندهای پویای کوتاه ایجاد شده با API و سرویس گیرنده (Android/iOS) SDK در کنسول Firebase نشان داده نمی شود. چنین پیوندهای پویا برای به اشتراک گذاری کاربر به کاربر در نظر گرفته شده است. برای بازاریابی موارد استفاده، همچنان به ایجاد لینک های خود را به طور مستقیم از طریق صفحه پویا لینک از کنسول فایربیس.

قبل از اینکه شروع کنی

  1. کلید API خود را دریافت کنید. برای احراز هویت درخواست های خود در API ، به یک کلید API نیاز دارید. برای یافتن کلید API خود:
    1. را باز صفحه تنظیمات از کنسول فایربیس. اگر از شما خواسته شد که یک پروژه را انتخاب کنید ، پروژه Firebase خود را از منو انتخاب کنید.
    2. توجه داشته باشید از ارزش این زمینه وب API کلیدی.
  2. در فایربیس کنسول، باز کردن بخش پویا لینک.
  3. اگر قبلاً شرایط خدمات را قبول نکرده اید و برای پیوندهای پویا دامنه خود را تعیین نکرده اید ، در صورت درخواست از شما این کار را انجام دهید.

    اگر قبلاً دامنه Dynamic Links دارید ، به آن توجه کنید. هنگام ایجاد پیوندهای پویا ، باید دامنه Dynamic Links را ارائه دهید.

برای کوتاه کردن پیوند پویای طولانی می توانید از API پیوندهای پویای Firebase استفاده کنید. برای این کار، یک درخواست 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 به یاد بگیرند که چگونه به ایجاد طولانی پویا لینک.

همچنین می توانید با تعیین مستقیم پارامترهای Dynamic Link ، یک Dynamic Link کوتاه ایجاد کنید. برای این کار، یک درخواست 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

چنین رشته هایی با کدگذاری تعداد 62 بیتی به طور تصادفی ایجاد می شوند. از این تنظیم برای جلوگیری از حدس و خزیدن 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: // شروع شود. همچنین باید با الگوهای نشانی وب سفید موجود در کنسول مطابقت داشته باشد. در غیر این صورت ، API ایجاد با کد خطای HTTP 400 خراب می شود.

مراحل بعدی

اکنون که پیوندهای پویا ایجاد کرده اید ، باید برنامه خود را برای دریافت پیوندهای پویا تنظیم کرده و پس از باز شدن کاربر ، کاربران را به مکان مناسب برنامه خود ارسال کنید.

برای دریافت پویا لینک ها در برنامه شما، اسناد و مدارک برای دیدن در iOS ، آندروید ، C ++ ، و وحدت .

درخواست ها به 5 درخواست/آدرس IP/ثانیه و 200.000 درخواست/روز محدود می شود. اگر بیش از، پس از آن پاسخ خواهد HTTP کد خطا 429. به درخواست برای سهمیه بیشتر بازگشت، با پر کردن این فرم .