注意:以下文档只适用于TOP接口,请谨慎使用!

文档中心 > 智能硬件

API数据模拟

更新时间:2018/08/02 访问次数:4982

为了更好的开发调试体验,平台提供了“配置中心”,用来做tida-rop中api的数据模拟。开发者也可以在配置中心添加自己的服务端接口模拟数据,方便本地调试。

tida-rop的API数据模拟

创建新版本的时候,默认会添加tida-rop里所有api的模拟数据到配置中心:

image.png | left | 626x323

点击“查看”查看模拟数据:

image.png | left | 593x357

点击“编辑”可以修改模拟数据,可以修改某些字段更改模拟数据返回结果:

image.png | left | 600x492

同一个接口也可以添加不同参数的模拟数据,点击“从此新建”:

image.png | left | 601x414

这样,如果使用url=https://www.taobao.com请求模拟数据,则会获得该数据下的结果。
注:强烈建议所有tida-rop的api数据至少保留一条,否则有可能导致审核不通过

自定义API的模拟

配置中心允许开发者添加自有服务器接口的模拟。
点击“新建接口”:

image.png | left | 471x385

使用tida-rop的api请求模拟数据:

Tida.rop.call('mock', {
  apiName: 'testApi'
}).then(function (data) {
  console.log(data);
  // console output
  // {
  //   "result": "这是一个测试结果"
 ?// }
}, function (err) {
  console.log(err);
});

给testApi添加一条不同参数的数据:

image.png | left | 553x268

则通过mock带上参数testparam=40请求模拟数据,会获得以下结果:

Tida.rop.call('mock', {
  apiName: 'testApi',
  params: {
    testparam: 40
 ?}
}).then(function (data) {
  console.log(data);
  // console output
  // {
  //   "result": "这是一个测试结果"
 ?// }
}, function (err) {
  console.log(err);
});

API参数匹配规则

在请求模拟数据的时候,对于多参数的接口,会采用以下规则进行匹配:
querystring中的多个key-value对,分别和该接口现有模拟数据参数进行匹配,取最接近的数据返回。
例如:
请求的参数为:

{
  "a": 1,
  "b": 2,
  "c": 3
}

现有模拟数据参数有以下几条:

<无参数>
a=1&b=3
a=1&c=3

由于第三条模拟数据最接近请求的参数(a=1, c=3),则会返回第三条数据。

FAQ

关于此文档暂时还没有FAQ
返回
顶部