OneLink API

APIレート

• API経由でOneLink計測リンクを作成できるレート制限は、アカウントにつき1ヵ月あたり750万件（UTCタイムゾーン）です。
• 750万を超過した後の全てのリクエストは処理されず、リンクは作成されません。APIコールは、エラーステータスコード429とメッセージ "throttling limit exceeded" (スロットリング制限の超過) を受信します。
  
• レート制限の使用量に関する情報は、OneLink API ダッシュボードに表示されています。

リンクの可視性

• APIを介して作成されたリンクは、AppsFlyer管理画面のOneLinkカスタムリンクのリストには表示されません。
• ベストプラクティス：APIで作成されたリンクをローカルの表などに保存し、今後リンクにアクセスできるようにしてください。

TTL 

• OneLink APIを使用して作成された OneLinkショートURLのデフォルトの有効期間 (TTL) は 31 日です。
  このTTLは、リンクがクリックされるたびに 31 日間延長されます。
  有効期限が切れた後にこれらのリンクをクリックするした場合、OneLinkの基本設定で定義された動作がデフォルトになりますが、アトリビューション計測は機能しません。
• 最大TTLは31日です。31より大きいTTLの値は、デフォルトの31日に上書きされます。
• デフォルトのTTLを変更するには、パラメーター ttl={value}を追加します。 日数、時間数、または分数を指定します。
  例： ttl=7d ttl=12h /  ttl=10m。
• 更新リクエストを送信し、TTLを指定することができます。これらの更新リクエストは既存リンクのTTLをリセットし、リクエストボディ内で指定されたものを設定します。
  • これは TTL が置き換えられることを意味します。例えば、現在TTLが29dで設定されているリンクをTTL 2d でに更新すると、TTL=2d (31dではなく) に変更されます。
  • 更新リクエストコールは、計測リンクの寿命を延ばす可能性があります。例えば、現在 TTL 20d であるが 5日が超過したリンクに対して TTL 31d で更新コールを行った場合、TTL は更新時から 31d になります。
• リンクのTTLを自動延長したくない場合は、リンクに パラメーター renew_ttl=false を追加してください。
  このパラメーターの値はboolean値で、true (デフォルト) または false のいずれかを付与してください。
• パラメータ renew_ttl は実際のURLには表示されません。

特殊文字

ペイロード

ペイロードのクエリ文字列は2,048文字を超えないでください。

URL ID

URL ID（またはショートリンク ID）を編集して、キャンペーンのオファー内容を強調表示できます。
例：https:// myapp.onelink.me/abc123/apples
URL IDは50文字を超えてはならず、文字と数字の組み合わせにすることができます。
デフォルト：8文字のランダムな英数字

注意：

• URL IDを編集できるのは、現在の IDがまだ使用されていない場合のみです。
• URL IDが既に使用されている場合、リンクの作成は失敗し、エラー応答 (400) が返されます。あなたとあなたの開発者は、そのようなイベントで何が起こるかを決定し、構成する必要があります。
• 失敗した呼び出しは、引き続き毎月の API クォータにカウントされます。