文档中心 > 开发指南

网络接口白名单

更新时间:2024/07/18 访问次数:1725

以下内容为开发者在调用部分API/组件时遇到域名管控的说明,主要分为官方默认支持域名白名单及小游戏独立申请域名白名单2类:

一、独立域名白名单使用

1. 白名单规范要求

① 仅支持https协议域名。

② 域名须已完成ICP备案

③ 一类域名白名单最多可支持20个域名。

2. 申请方式

1)request白名单

在小游戏开发 > 开发设置 > 服务器域名白名单>域名白名单 > 添加白名单 > 添加 或者续期。

2)资源以及websocket白名单

可通过以下路径申请域名白名单:

3. 使用方式

request请求类

使用API: cloud.application.httpRequest (必须引入@tbmp/mp-cloud-sdk)

示例代码如下:

//game.js文件初始化示例代码 
import cloud from '@tbmp/mp-cloud-sdk';

cloud.init({
  //test、online
  env: 'test'
});

----------------------------------
  //调用接口的方法
  async function testCloud() {
    let result
    try {
      result = await cloud.application.httpRequest({
        //不需要完整域名,只需要接口访问路径即可
        'path': '/welcome',
        'method': 'GET',
        'headers': {},
        'params': {"name":"hanruo","action":"test"},
        'body': {},
        //cloudAppId为域名白名单配置后获取,在配置处查看具体参数
        'exts': { 
          "cloudAppId": "xxxx",
          "timeout": 4000,
           //调用需要填写该字段,包括协议头以及端口号(可省略),支持http、https
           "domain":"https://www.taobao.com"
        }
      });
    } catch (error) {
      console.log(error)
    }
    console.log("result:", JSON.stringify(result));
  }

----------------------------------
  //执行方法
  testCloud();



==================================
  //如果需要用户授权,服务端获取对应token,则如下调用:
  //执行方法
  my.authorize({
    scopes: 'scope.userInfo', //需要授权的权限包,此处以用户信息权限包为例
    success: (res) => {
      console.log("res:", res);
      testCloud();
    },
    fail(res) {
      console.log("fail:", res);
    }
  });

WebSocket通信类

使用API:my.connectSocket

resource资源类组件与其它API

使用API:my.downloadFile url入参、my.createInnerAudioContext src入参。

二、官方默认支持的域名列表

1. request请求类

1)miniappcloud.taobao.com;

2)media.taobao.com;

3)upload.media.aliyun.com;

4)miniappcloud-common-file.oss-cn-zhangjiakou.aliyuncs.com;

5)\\S\\.alicdn\\.com$;

6)\\S\\.mmstat\\.com$;

2. WebSocket通信类

1)openchannel.alipay.com;

2)hpmweb.alipay.com;

3. resource资源类

1)*.mappcloud.com;

2)*.aliimg.com;

3)*.alibaba.com;

4)*.aliyun.com;

5)*.aliyuncs.com;

6)*.alimmdn.com;

7)*.tbcdn.cn;

8)*.taobaocdn.com;

9)*.taobao.com;

10)*.mmcdn.cn;

11)*.hpcdn.net;

12)*.alicdn.com;

13)*.1688.com;

14)*.umeng.com;

15)*.tb.cn;

16)*.aliyun.com;

17)*.alitrip.com;

18)*.alitrip.hk;

19)*.lazada.sg;

20)*.alibabausercontent.com;

4. webview访问类

1)\\S\\.alibaba\\.com$;

2)\\S\\.aliyun\\.com$;

3)\\S\\.aliyuncs\\.com$;

4)\\S\\.alimmdn\\.com$;

5)\\S\\.tbcdn\\.cn$;

6)\\S\\.taobaocdn\\.com$;

7)\\S\\.taobao\\.com$;

8)\\S\\.alicdn\\.com$;

9)\\S\\.1688\\.com$;

10)\\S\\.umeng\\.com$;

11)\\S\\.alitrip\\.com$;

12)\\S\\.alitrip\\.hk$;

13)\\S\\.lazada\\.sg$;

14)\\S\\.tmall\\.com$;

FAQ

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