跳到主要内容

沙盒环境

1 概述​

「DataNexus」提供了单独的沙盒环境，方便通过仅切换域名的方式，将数据接入到沙盒环境中，验证数据是否正确接入。同时，由于沙盒环境的所有数据与正式环境是完全隔绝的，接入沙盒环境的测试数据不会对真实应用产生影响，避免了脏数据影响线上数据应用。

信息

腾讯并不会使用沙盒环境的数据，故沙盒环境仅供您调试数据使用。

DataNexus 沙盒环境仅用于数据上报 API 的调试，不支持功能操作 API 的调试。上报的沙盒数据有效期为 3 天。



2 使用场景​

「DataNexus」沙盒环境适用于接入新的应用场景时，根据应用场景的数据上报要求完成开发后，通过沙盒域名将数据上报至沙盒环境验证数据是否符合应用场景的要求，确认上报正确后，再切换域名将数据上报到正式环境进行应用。

最佳实践如下：

  • 在「DataNexus」数据接入工作台中新建接入项目，在工作台的项目详情页查看接入文档，了解数据接入要求；
  • 根据要求将数据上报至沙盒环境，在 日志查询 中查看数据；
  • 确认数据上报无误后，切换回正式环境域名正常上报数据。


3 使用说明​

3.1 请求域名​

「DataNexus」数据上报的沙盒环境和正式环境有各自独立的域名，如下：

环境类型域名
沙盒环境https://datanexus-sandbox.e.qq.com
正式环境https://api.e.qq.com

3.2 请求地址​

「DataNexus」当前支持上报数据至沙盒环境的 API 包括：

接口名称请求地址
用户行为添加/更新https://datanexus-sandbox.e.qq.com/v1.1/action/add

3.3 请求方式​

调用沙盒环境 API 上报数据时，请求方式与正式环境相同。

HTTP Method​

调用方应根据具体接口的要求设置 HTTP Method为 GET 或 POST。


HTTP Header​

调用方应遵循 HTTP 协议设置相应的 Header，目前支持的Header有：Content-Type，用于指定数据格式。例如： 

Content-Type: application/json

编码方式​

Marketing API 支持的编码方式为 UTF-8。


请求通用参数​

名称类型必填限制描述
access_tokenstringY以 Query Parameter方式在请求路径中传递授权令牌，正式环境及沙盒环境使用相同的 access_token。
timestamptimestampY以 Query Parameter方式在请求路径中传递当前的时间戳，单位为秒，允许客户端请求最大时间误差为 300 秒。 MarketingAPI 所使用的时间戳，若无特殊说明，均为秒级时间戳。MarketingAPI 所使用的时区为GMT+8，例如当时间戳为1494840119时，表示 2018-05-15 17:21:59
noncestringY以 Query Parameter方式在请求路径中传递随机字串标识，不超过32个字符，由调用方自行生成，需保证全局唯一性
信息

「DataNexus」-<数据源>-【查看密钥】支持一键生成 Access Token（具有数据上报权限组，有效期为永久）。


3.4 请求体参数​

调用沙盒环境 API 上报数据时，请求体参数与正式环境相同（沙盒环境和正式环境共用账号和数据源）。




该内容是否有帮助？