ドキュメントAdobe PassAdobe Pass 認証

（レガシー）認証の開始 initiate-authorization

最終更新日： 2026年10月8日
NOTE
このページのコンテンツは、情報提供のみを目的として提供されています。 このAPIを使用するには、Adobeの現在のライセンスが必要です。 無断使用は認められません。
IMPORTANT
製品のお知らせ ページに集計されている最新のAdobe Pass認証製品のお知らせと廃止予定について、常に情報を得てください。
NOTE
REST APIの実装は​ スロットル メカニズム ​によって制限されています

REST API エンドポイント clientless-endpoints

<REGGIE_FQDN>:

<SP_FQDN>:

説明 description

承認応答を取得します。

エンドポイント
様に呼び出されました
入力
パラメーター
HTTP
メソッド
応答
HTTP
応答
<SP_FQDN>/api/v1/authorize
ストリーミングアプリ

または

プログラマーサービス
​1. 依頼者（必須）
2。 deviceId （必須）
3。 リソース （必須）
4。 device_info/X-Device-Info （必須）
5. deviceType
6. deviceUser （非推奨）
7。 appId （非推奨）
8。 追加パラメーター（オプション）
GET
認証の詳細またはエラーの詳細を含むXMLまたはJSONが失敗した場合。 以下のサンプルを参照してください。
200 – 成功
403 – 成功なし
入力パラメーター
説明
依頼者
この操作が有効なプログラマの依頼者Id。
deviceId
デバイス ID バイト。
リソース
resourceId （またはMRSS フラグメント）を含む文字列は、ユーザーが要求したコンテンツを識別し、MVPD認証エンドポイントによって認識されます。
device_info/

X-Device-Info
ストリーミングデバイス情報。

注：これはdevice_infoをURL パラメーターとして渡すことができますが、このパラメーターの潜在的なサイズとGET URLの長さに制限があるため、HTTP ヘッダーでX-Device-Infoとして渡す必要があります。

詳細については、​ デバイスと接続情報の受け渡しを参照してください。
deviceType
デバイスの種類（Roku、PCなど）。

このパラメーターが正しく設定されている場合、ESMは、クライアントレスを使用する場合にデバイスの種類🔗ごとに分割された指標を提供するため、Roku、AppleTV、Xboxなどのさまざまなタイプの分析を実行できます。

パス指標の​ クライアントレス デバイス タイプ パラメーターの利点​

注​を参照：device_infoはこのパラメーターを置き換えます。
deviceUser
デバイスユーザーID。
appId
アプリケーション ID/名前。

メモ:device_infoがこのパラメーターに置き換わります。
追加パラメーター
呼び出しには、次のような他の機能を有効にするオプションのパラメーターも含めることができます。

* generic_data - ​ プロモーション TempPass

例：generic_data=("email":"email@domain.com")
CAUTION
ストリーミングデバイス IP アドレス

クライアント間の実装の場合、ストリーミングデバイスのIP アドレスは、この呼び出しで暗黙的に送信されます。 サーバー間の実装では、regcode​呼び出しはストリーミングデバイスではなくプログラマーサービスによって行われます。ストリーミングデバイスのIP アドレスを渡すには、次のヘッダーが必要です：
code language-none 
X-Forwarded-For : <streaming\_device\_ip>
ここで、<streaming\_device\_ip>はストリーミングデバイスのパブリック IP アドレスです。


例：
code language-none 
POST /reggie/v1/{req_id}/regcode HTTP/1.1
    X-Forwarded-For:203.45.101.20

応答サンプル sample-response

  • ケース 1：成功

    * **XML:**

    "'XML
    <?xml version=“1.0” encoding=“UTF-8” standalone=“yes”?>
    <authorization>
    <expires>1348148289000</expires>
    <mvpd>sampleMvpdId</mvpd>
    <requestor>sampleRequestorId</requestor>
    <resource>sampleResourceId</resource>
    </authorization>
    "

  • JSON:

    code language-json 
    {
  "mvpd": "sampleMvpdId",
  "resource": "sampleResourceId",
  "requestor": "sampleRequestorId",
  "expires": "1348148289000"
}
IMPORTANT
応答がプロキシ MVPDから来る場合、その応答にproxyMvpdという名前の追加エレメントが含まれる場合があります。

  • ケース 2：承認が拒否されました

    code language-json 
    <error>
  <status>403</status>
  <message>User not authorized</message>
  <details>Your subscription package does not include the "ASFAFD" channel.
  Please go to http://www.ca.ble/upgrade in order to upgrade your subscription.</details>
</error>
recommendation-more-help
pass-help-authentication