快速入门

术语介绍

功能全景图

开户、实名认证、行业资质请到华为广告投放平台操作。

推广和报表接口通过 Marketing API 对外开放， 在使用过程中，依赖的一些接口尚未对外开放，需要到华为投放平台上创建后才可以在 Marketing API 使用。

刷新 access_token

用 Refrest Token 来获取新的 Access Token。建议在 Access Token 即将过期的时候调 用。

调用业务接口，如果返回的 code 为如下内容：

=================================================================== ======================================

{

"code": "1000009992",

"message": "token 已过期"

}

=================================================================== ======================================

请调用刷新 access_token 接口，重新获取一次 access_token，如果仍然失败，将用户登 出，引导用户重新登录。

请求消息

客户端：广告主服务器

服务端：  Huawei  帐号服务器

请求协议： HTTPS

请求方式： POST

接口 URL：https://login.cloud.huawei.com/oauth2/v2/token

请求参数

请求示例

===================================================================

======================================

POST /oauth2/v2/token HTTP/1. 1

Host: login.cloud.huawei.com

Content-Type: application/x-www-form-urlencoded

grant_type=refresh_token&client_id=12345&client_secret=bKaZ*************d2k9few&r efresh_token=CF2Mm03n0aos9iZZ8nIhfyDtoXy74CXeBi50gVVhMpB0IUzlv9ZwizEvTBh VoF820ZPim0JwNR9j2p1qgEQWnIVYZRlp******gekUnsHBkvNev5rd2MdfQMLP

=================================================================== ======================================

响应参数

成功响应消息样例：

=================================================================== ======================================

HTTP/1. 1 200 OK

Content-Type: text/html;charset=UTF-8

Cache-Control: no-store

{"access_token":

"CFyJ4J\/l6wuwcFqYOJG4maq2ca8RAV+g0i+mel6qCV5lvqH0PYtW0+BNwfHWg0AqMn W6ZdBvUgs7ijkxMFh1xVP\/B+vQXz3PWsivkKCuL78XtbLt7vs=", "expires_in": 3600,      "scope": "https:\/\/www.huawei.com\/auth\/account\/base.profile", "token_type": "Bearer"}

===================================================================

======================================

注意：

      json 字符串中存在转义符。如果用 curl 命令或者 postman 工具手工获取

access_token，把“\/”还原为“/”才是正确的 access_token，否则在使用        access_token 的过程中会报 access_token 非法。如果是写代码，采用任意的第三方 库，都能正确解析 json 串， 获取到正确的值

    关于 access_token 和 refresh_token 的长度：这两个字段的长度跟其中编码的内容多

少有关系， 按目前的编码格式，其长度不会超过 1000

失败响应消息样例

=================================================================== ====================================

HTTP/1. 1 400 Bad Request

Content-Type: text/html;charset=UTF-8

{"error":1203,"sub_error":31204,"error_description":"unknown error"}

=================================================================== ======================================

失败返回错误码

获取用户信息

登录成功后，需要在界面展示用户的基本信息， 可以通过调用此接口查询华为帐号信 息并展示在界面上。

请求示例

=================================================================== ======================================

POST /rest.php HTTP/1. 1

Host: account.cloud.huawei.com

Content-Type: application/x-www-form-urlencoded

nsp_svc=GOpen.User.getInfo&access_token=CV7GpkaEz8wYeXW2%2fra%2fJ5%2bjn5H9 Y%2ftaxWLHl5ijevHMr4NzNnTIfkD6El9u******YYT6KN02YhMenGQ2%2f2y7vYJ8Xd 9D94xC2ztKK%2bI%2bfjl1TEfFMNDf3kacE%3d&getNickName=1

=================================================================== =======================================

将红色部分替换成获取到的 access_token

响应样例

=================================================================== =======================================HTTP/1. 1 200 OK

Content-Type: text/html;charset=UTF-8

Cache-Control: no-store

{"displayName":"137******38","openID":"MDFAMTAzODA3NDJANWNiaYTZiaZWNk  YTcxOWFlY2E4N2M3ZDZmMDJkMGM4MGRAMjBjZWNlN2YyMGFmZGIxZWRmOT g3MDI2Nzk1OGEyY2IwMmE0MjAwYjA1ZGY3ZGUxNmJjN2Qw","headPictureURL":"ht tps://upfile-

drcn.platform.hicloud.com/FileServer/image/b.0610086200300000245.20200521231532.Pwh gOVhUxTCLzd8vfvjVKnx9bmWtlUBG. 1000.66140D63E80FF9D81F381F49462E30FF90C 37B86EDD06CCAFF19CFC3C3C98921.png"}

=================================================================== =======================================displayName 是用户昵称