Mediago API
zh
  • en
  • zh
  1. 身份认证
Mediago API
zh
  • en
  • zh
  • 身份认证
    • 获取访问令牌
      POST
  • 账户管理
    • 获取授权账户列表
      GET
  • 广告计划管理
    • 获取授权广告计划列表
      GET
    • 获取广告计划详情
      GET
    • 创建广告计划
      POST
    • 更新广告计划
      POST
    • 批量更新广告计划
      POST
    • 批量开启/关闭广告计划
      POST
    • 批量归档广告计划
      POST
  • 广告管理
    • 获取授权广告列表
      GET
    • 批量开启/关闭广告
      POST
  • Sites屏蔽管理
    • 获取账户层级Site屏蔽列表
      GET
    • 账户层级Site屏蔽/解除屏蔽
      POST
    • 获取广告计划层级Site屏蔽列表
      GET
    • 广告计划层级Site屏蔽/解除屏蔽
      POST
  • API 报表
    • 获取账户层级天级报表
      GET
    • 获取广告计划天级报表
      GET
    • 获取广告天级报表
      GET
    • 获取广告计划或广告小时级报表
      GET
    • 获取账户层级Site天级报表
      GET
    • 获取广告计划层级Site天级报表
      GET
  1. 身份认证

获取访问令牌

POST
https://api.mediago.io/data/v1/authentication
Last modified:2025-09-28 10:25:30
使用API Token获取访问令牌。令牌在3600秒后过期。注意:新的access_token生成后,旧的access_token将会失效。

身份认证#

💡首先,您需要通过联系您的AM或发送邮件到 ext_mediago_am@baidu.com 获取API Token。
💡其次,您需要使用API Token调用认证API来获取Access Token。
💡一旦您获得了Access Token,您需要在HTTP头中将此令牌作为bearer token传递,以便在Access Token过期之前进行后续调用。
💡当新的access_token被调用时,原来的access_token将失效。如果您要发送多个请求,请在每个API请求中使用相同的access_token应用单线程处理。请不要为每个请求调用access_token,否则API可能响应错误代码401
状态码:
代码描述
200成功
400参数无效
401access_token无效
403access_token已过期
404请求URL错误
429QPS限制已超出
500内部服务器错误
502api_token无效
请求参数:
属性详情
api_token通过联系您的客户经理获取base64编码的api token
http_basic_auth${api_token}格式的字符串。例如:如果api_token是Basic YWJjZGVmZzEyMw==,则Authorization头如下:Authorization: Basic YWJjZGVmZzEyMw==

Request

Header Params

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.mediago.io/data/v1/authentication' \
--header 'Authorization: Basic {{api_token}}' \
--header 'Content-Type: application/x-www-form-urlencoded;charset=utf-8'

Responses

🟢200成功响应
application/json
Body

Example
{
    "access_token": "ACCESS_TOKEN",
    "token_type": "Bearer",
    "expires_in": 3599
}
🟠400错误请求 - 无效参数
🟠401未授权 - 无效访问令牌
🟠403禁止访问 - 令牌已过期
🟠404未找到 - 无效URL
🟠429请求过多 - QPS限制
🔴500内部服务器错误
🔴502网关错误 - 无效API令牌
Modified at 2025-09-28 10:25:30
Next
获取授权账户列表
Built with