检索用户档案 retrieve-profiles

最近更新： 2026年7月7日

主题：
Authentication

IMPORTANT

此页面上的内容仅供参考。使用此API需要来自Adobe的当前许可证。不允许未经授权使用。

IMPORTANT

REST API V2实施受限制机制文档限制。

请求 request

HTTP

路径

/api/v2/{serviceProvider}/profiles

方法

GET

路径参数

serviceProvider

在载入过程中与服务提供商关联的内部唯一标识符。

必填

标头

授权

授权标头文档中描述了持有者令牌有效负载的生成。

必填

AP设备标识符

AP-Device-Identifier标头文档中描述了设备标识符有效负载的生成。

必填

X-Device-Info

X-Device-Info标头文档中介绍了设备信息有效负载的生成。

强烈建议在应用程序的设备平台允许显式提供有效值时始终使用它。

提供该属性后，Adobe Pass身份验证后端将隐式地将显式设置的值与提取的值合并（默认情况下）。

如果未提供，Adobe Pass身份验证后端将隐式使用提取的值（默认情况下）。

必填

X-Forwarded-For

流设备的IP地址。

强烈建议始终将其用于服务器到服务器的实施，尤其是在由程序员服务而不是流设备进行调用时。

对于客户端到服务器实施，流设备的IP地址将隐式发送。

可选

Adobe-Subject-Token
或
X-Roku-Reserved-Roku-Connect-Token

Adobe-Subject-Token / X-Roku-Reserved-Roku-Connect-Token标头文档中介绍了为Platform Identity方法生成单点登录有效负载的过程。

有关使用平台标识启用单点登录的流的更多详细信息，请参阅使用平台标识流的单点登录文档。

可选

AD-Service-Token

AD-Service-Token标头文档介绍了服务令牌方法单点登录有效负载的生成。

有关使用服务令牌启用单点登录的流的更多详细信息，请参阅使用服务令牌流的单点登录文档。

可选

AP — 合作伙伴 — 框架 — 状态

AP-Partner-Framework-Status标头文档介绍了为Partner方法生成单一登录有效负载的过程。

有关使用合作伙伴启用单点登录流程的更多详细信息，请参阅使用合作伙伴流程进行单点登录文档。

可选

AP-Visitor-Identifier

AP-Visitor-Identifier标头文档中描述了访客标识符有效负载的生成。

可选

客户端应用程序接受的媒体类型。

如果指定，则必须为application/json；charset=utf-8。

可选

User-Agent

客户端应用程序的用户代理。

可选

响应 response

代码

文本

描述

200

确定

响应正文包含有效配置文件的映射，该映射可能为空。

400

错误请求

请求无效，客户端需要更正请求并重试。响应正文可能包含遵守增强型错误代码文档的错误信息。

401

未授权

访问令牌无效，客户端需要获取新的访问令牌并重试。有关更多详细信息，请参阅动态客户端注册概述文档。

405

不允许使用该方法

HTTP方法无效，客户端需要使用请求资源允许的HTTP方法并重试。有关更多详细信息，请参阅请求部分。

500

内部服务器错误

服务器端遇到问题。响应正文可能包含遵守增强型错误代码文档的错误信息。

成功 success

标头

状态

200

必填

Content-Type

application/json

必填

正文

用户档案

JSON包含键、值对的映射。

键元素由以下值定义：

table 0-row-3 1-row-3 1-bgcolor-#eff2f7 2-bgcolor-#eff2f7 3-bgcolor-#eff2f7 5-bgcolor-#deebff layout-auto html-authored
值
mvpd	在新用户引导过程中与身份提供商关联的内部唯一标识符。	必填

值元素由以下属性定义：

table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3 1-bgcolor-#eff2f7 2-bgcolor-#eff2f7 3-bgcolor-#eff2f7 5-bgcolor-#deebff 9-bgcolor-#deebff 13-bgcolor-#deebff 17-bgcolor-#deebff 21-bgcolor-#deebff layout-auto html-authored
属性
notBefore	配置文件无效之前的时间戳（以毫秒为单位）。	必填
notAfter	时间戳（以毫秒为单位），在该时间戳之后配置文件无效。	必填
发行者	拥有该配置文件的实体。可能的值包括： mvpd （例如，Spectrum、Cablevision等）创建配置文件的原因是：基本身份验证、使用平台标识的单点登录或使用服务令牌的单点登录。 Apple 创建配置文件的原因是：使用合作伙伴Apple进行单点登录。	必填
type	配置文件的类型。可能的值包括：常规创建配置文件的原因是：基本身份验证。 appleSSO 创建配置文件的原因是：使用合作伙伴Apple进行单点登录。 platformSSO 创建配置文件的原因是：使用平台标识进行单点登录。 serviceTokenSSO 创建配置文件的原因是：使用服务令牌进行单点登录。	必填
属性	JSON包含键、值对的映射。关键元素由用户元数据属性定义，可以是：必填，如“userID” 非强制性的，如“zip”、“householdID”、“maxRating”等。属性的值可以是：简单列表映射在身份验证流程完成后，用户元数据将变为可用，但在授权流程期间，某些元数据属性可能会更新，具体取决于MVPD和有问题的特定元数据属性。	必填

必填

错误 error

标头

状态

400, 401, 405, 500

必填

Content-Type

application/json

必填

正文

响应正文可能提供附加的错误信息，这些信息将遵循增强型错误代码文档。

必填

示例 samples

1. 检索通过基本身份验证获得的配置文件

请求

code language-https

GET /api/v2/REF30/profiles HTTP/1.1

    Authorization: Bearer eyJhbGciOiJSUzI1NiJ9.eyJzdWIiOiJjNGZjM2U3ZS0xMmQ5LTQ5NWQtYjc0Mi02YWVhYzhhNDkwZTciLCJuYmYiOjE3MjQwODc4NjgsImlzcyI6ImF1dGguYWRvYmUuY29tIiwic2NvcGVzIjoiYXBpOmNsaWVudDp2MiIsImV4cCI6MTcyNDEwOTQ2OCwiaWF0IjoxNzI0MDg3ODY4fQ.DJ9GFl_yKAp2Qw-NVcBeRSnxIhqrwxhns5T5jU31N2tiHxCucKLSQ5guBygqkkJx6D0N_93f50meEEyfb7frbHhVHHwmRjHYjkfrWqHCpviwVjVZKKwl8Y3FEMb0bjKIB8p_E3txX9IbzeNGWRufZBRh2sxB5Q9B7XYINpVfh8s_sFvskrbDu5c01neCx5kEagEW5CtE0_EXTgEb5FSr_SfQG3UUu_iwlkOggOh_kOP_5GueElf9jn-bYBMnpObyN5s-FzuHDG5Rtac5rvcWqVW2reEqFTHqLI4rVC7UKQb6DSvPBPV4AgrutAvk30CYgDsOQILVyrjniincp7r9Ww
    AP-Device-Identifier: fingerprint YmEyM2QxNDEtZDcxNS01NjFjLTk0ZjQtZTllNGM5NjZiMWVi
    X-Device-Info: ewoJInByaW1hcnlIYXJkd2FyZVR5cGUiOiAiU2V0VG9wQm94IiwKCSJtb2RlbCI6ICJUViA1dGggR2VuIiwKCSJtYW51ZmFjdHVyZXIiOiAiQXBwbGUiLAoJIm9zTmFtZSI6ICJ0dk9TIgoJIm9zVmVuZG9yIjogIkFwcGxlIiwKCSJvc1ZlcnNpb24iOiAiMTEuMCIKfQ==
    Accept: application/json
    User-Agent: Mozilla/5.0 (Apple TV; U; CPU AppleTV5,3 OS 11.0 like Mac OS X; en_US)

响应

code language-https

HTTP/1.1 200 OK

Content-Type: application/json;charset=UTF-8

{
    "profiles": {
        "Cablevision": {
            "notBefore": 1752149281000,
            "notAfter": 1783685280000,
            "issuer": "Cablevision",
            "type": "regular",
            "attributes": {
                "userID": {
                    "value": "BASE64_value_userId",
                    "state": "plain"
                },
                "householdID": {
                    "value": "BASE64_value_householdId",
                    "state": "plain"
                },
                "zip": {
                    "value": "BASE64_value_zip",
                    "state": "enc"
                }
            }
        },
        "Spectrum": {
            "notBefore": 1752149272300,
            "notAfter": 1783685284670,
            "issuer": "Spectrum",
            "type": "regular",
            "attributes": {
                "userID": {
                    "value": "BASE64_value_userId",
                    "state": "plain"
                }
            }
        }
     }
}

2. 检索通过基本身份验证或使用服务令牌方法的单点登录获得的配置文件

请求

code language-https

GET /api/v2/REF30/profiles HTTP/1.1

    Authorization: Bearer eyJhbGciOiJSUzI1NiJ9.eyJzdWIiOiJjNGZjM2U3ZS0xMmQ5LTQ5NWQtYjc0Mi02YWVhYzhhNDkwZTciLCJuYmYiOjE3MjQwODc4NjgsImlzcyI6ImF1dGguYWRvYmUuY29tIiwic2NvcGVzIjoiYXBpOmNsaWVudDp2MiIsImV4cCI6MTcyNDEwOTQ2OCwiaWF0IjoxNzI0MDg3ODY4fQ.DJ9GFl_yKAp2Qw-NVcBeRSnxIhqrwxhns5T5jU31N2tiHxCucKLSQ5guBygqkkJx6D0N_93f50meEEyfb7frbHhVHHwmRjHYjkfrWqHCpviwVjVZKKwl8Y3FEMb0bjKIB8p_E3txX9IbzeNGWRufZBRh2sxB5Q9B7XYINpVfh8s_sFvskrbDu5c01neCx5kEagEW5CtE0_EXTgEb5FSr_SfQG3UUu_iwlkOggOh_kOP_5GueElf9jn-bYBMnpObyN5s-FzuHDG5Rtac5rvcWqVW2reEqFTHqLI4rVC7UKQb6DSvPBPV4AgrutAvk30CYgDsOQILVyrjniincp7r9Ww
    AP-Device-Identifier: fingerprint YmEyM2QxNDEtZDcxNS01NjFjLTk0ZjQtZTllNGM5NjZiMWVi
    X-Device-Info: ewoJInByaW1hcnlIYXJkd2FyZVR5cGUiOiAiU2V0VG9wQm94IiwKCSJtb2RlbCI6ICJUViA1dGggR2VuIiwKCSJtYW51ZmFjdHVyZXIiOiAiQXBwbGUiLAoJIm9zTmFtZSI6ICJ0dk9TIgoJIm9zVmVuZG9yIjogIkFwcGxlIiwKCSJvc1ZlcnNpb24iOiAiMTEuMCIKfQ==
    AD-Service-Token: eyJhbGciOiJSUzI1NiJ9.eyJzdWIiOiJkZDNmYWIyN2NmMjg0ZmU2ZWU0ZDY3ZmExZjY4MzE3YyIsImlzcyI6IkFkb2JlIiw.....
    Accept: application/json
    User-Agent: Mozilla/5.0 (Apple TV; U; CPU AppleTV5,3 OS 11.0 like Mac OS X; en_US)

响应

code language-https

HTTP/1.1 200 OK

Content-Type: application/json;charset=UTF-8

{
   "profiles": {
      "AdobeShibboleth": {
         "notBefore": 1748073636999,
         "notAfter": 1748105173000,
         "issuer": "AdobeShibboleth",
         "type": "serviceTokenSSO",
         "attributes": {
            "upstreamUserID": {
               "value": "AAdzZWNyZXQxydCkywfPBl0KExk8OWhdbUBVDDJBttfKD7RAcRlc32Pbuwd1...",
               "state": "plain"
            },
            "userID": {
               "value": "AAdzZWNyZXQxydCkywfPBl0KExk8OWhdbUBVDDJBttfKD7RAcRlc32Pbuwd14aTV....",
               "state": "plain"
            },
            "mvpd": {
               "value": "AdobeShibboleth",
               "state": "plain"
            }
         }
      },
      "Spectrum": {
         "notBefore": 1752149281000,
         "notAfter": 1783685280000,
         "issuer": "Spectrum",
         "type": "regular",
         "attributes": {
            "userID": {
               "value": "BASE64_value_userId",
               "state": "plain"
            }
         }
      }
   }
}

3. 检索通过基本身份验证或使用Platform Identity方法的单点登录获得的配置文件

请求

code language-https

GET /api/v2/REF30/profiles HTTP/1.1

    Authorization: Bearer eyJhbGciOiJSUzI1NiJ9.eyJzdWIiOiJjNGZjM2U3ZS0xMmQ5LTQ5NWQtYjc0Mi02YWVhYzhhNDkwZTciLCJuYmYiOjE3MjQwODc4NjgsImlzcyI6ImF1dGguYWRvYmUuY29tIiwic2NvcGVzIjoiYXBpOmNsaWVudDp2MiIsImV4cCI6MTcyNDEwOTQ2OCwiaWF0IjoxNzI0MDg3ODY4fQ.DJ9GFl_yKAp2Qw-NVcBeRSnxIhqrwxhns5T5jU31N2tiHxCucKLSQ5guBygqkkJx6D0N_93f50meEEyfb7frbHhVHHwmRjHYjkfrWqHCpviwVjVZKKwl8Y3FEMb0bjKIB8p_E3txX9IbzeNGWRufZBRh2sxB5Q9B7XYINpVfh8s_sFvskrbDu5c01neCx5kEagEW5CtE0_EXTgEb5FSr_SfQG3UUu_iwlkOggOh_kOP_5GueElf9jn-bYBMnpObyN5s-FzuHDG5Rtac5rvcWqVW2reEqFTHqLI4rVC7UKQb6DSvPBPV4AgrutAvk30CYgDsOQILVyrjniincp7r9Ww
    AP-Device-Identifier: fingerprint YmEyM2QxNDEtZDcxNS01NjFjLTk0ZjQtZTllNGM5NjZiMWVi
    X-Device-Info: ewoJInByaW1hcnlIYXJkd2FyZVR5cGUiOiAiU2V0VG9wQm94IiwKCSJtb2RlbCI6ICJUViA1dGggR2VuIiwKCSJtYW51ZmFjdHVyZXIiOiAiQXBwbGUiLAoJIm9zTmFtZSI6ICJ0dk9TIgoJIm9zVmVuZG9yIjogIkFwcGxlIiwKCSJvc1ZlcnNpb24iOiAiMTEuMCIKfQ==
    Adobe-Subject-Token: eyJhbGciOiJSUzI1NiJ9.eyJzdWIiOiIyMmM4MDU1MjEzMDIwYzhmZGYzOGZkMTI1YWViMzUzYSIsImlzcyI6....
    Accept: application/json
    User-Agent: Mozilla/5.0 (Apple TV; U; CPU AppleTV5,3 OS 11.0 like Mac OS X; en_US)

响应

code language-https

HTTP/1.1 200 OK

Content-Type: application/json;charset=UTF-8

{
   "profiles": {
      "AdobePass_SMI": {
         "notBefore": 1724337476000,
         "notAfter": 1724345252000,
         "issuer": "AdobePass_SMI",
         "type": "platformSSO",
         "attributes": {
            "upstreamUserID": {
               "value": "38524bdc3d1caac0b3e139003ea0954e15ad9648",
               "state": "plain"
            },
            "userID": {
               "value": "38524bdc3d1caac0b3e139003ea0954e15ad9648",
               "state": "plain"
            },
            "mvpd": {
               "value": "AdobePass_SMI",
               "state": "plain"
            }
         }
      },
      "Cablevision": {
         "notBefore": 1752149281000,
         "notAfter": 1783685280000,
         "issuer": "Spectrum",
         "type": "regular",
         "attributes": {
            "userID": {
               "value": "BASE64_value_userId",
               "state": "plain"
            }
         }
      }
   }
}

recommendation-more-help

pass-help-authentication

检索用户档案 retrieve-profiles

请求 request

响应 response

成功 success

错误 error

示例 samples

​1. 检索通过基本身份验证获得的配置文件

​2. 检索通过基本身份验证或使用服务令牌方法的单点登录获得的配置文件

​3. 检索通过基本身份验证或使用Platform Identity方法的单点登录获得的配置文件

1. 检索通过基本身份验证获得的配置文件

2. 检索通过基本身份验证或使用服务令牌方法的单点登录获得的配置文件

3. 检索通过基本身份验证或使用Platform Identity方法的单点登录获得的配置文件