使用场景 | uniCloud

# 使用场景

客户端在通过callFunction调用云函数时，会通过服务提供商分配的request域名来发起请求，目前各服务提供商默认分配的域名如下：

服务提供商	request域名
支付宝云	https://{spaceId}.api-hz.cloudbasefunction.cn
腾讯云	https://{spaceId}.ap-shanghai.tcb-api.tencentcloudapi.com
阿里云	https://api.next.bspapp.com

其中腾讯云与支付宝云为携带服务空间ID的子域名，每个空间不同，阿里云为固定域名。

固定域名是所有开发者共用，可能存在部分开发者违规导致域名被某些地区运营商封禁，从而影响该地区其他开发者正常的业务。

非固定域名可以避免这个问题，不过现在腾讯云和支付宝云提供的均是含有服务空间id的子域名，仍然存在上述问题。

为更好的解决这个问题，uniCloud支付宝云服务空间提供了自定义request域名功能，您可以在web控制台进行配置，配置完成后，所有云函数的request域名将变成您配置的域名。

本文档主要指导您如何在uniCloud web控制台管理和使用云函数自定义request域名。

# 操作步骤

仅支付宝云支持

# 设置云函数自定义request域名

登录uniCloud控制台，选择支付宝云服务空间。
点击左侧菜单栏“云函数”，进入云函数管理页面。
页面右上角“域名绑定”下拉菜单中选择“云函数request域名绑定”，可以查看默认域名及已绑定的域名。
点击“添加域名”，在弹出的窗口中进行配置，绑定域名需先完成CNAME解析，并上传https证书。
绑定成功后，自定义域名默认关闭，点击“启用”按钮后，即可生效。

# 使用自定义request域名

在完成上述步骤后，如需使用自定义request域名，还需要在开发阶段做一些处理，两种使用方案：

# 代码中使用自定义域名

在日常开发中，HBuilderX关联服务空间后，我们可以在代码中直接调用uniCloud.callFunction()来调用云函数，此时使用的是默认request域名。

我们也可以通过uniCloud.init()来初始化uniCloud实例，并在endpoint传入自定义request域名，此时调用uniCloud.callFunction()时，将使用自定义request域名。

const myCloud = uniCloud.init({
  provider: 'alipay',
  spaceId: 'env-xxx', 
  accessKey: 'xxxx',
  secretKey: 'xxxx',
  spaceAppId: 'xxxx',
  endpoint: '控制台绑定的自定义域名',
});
//通过uniCloud实例调用云开发的API
myCloud.callFunction()

示例源码如下，请查看 pre > code 标签中的内容

const myCloud = uniCloud.init({
  provider: 'alipay',
  spaceId: 'env-xxx', 
  accessKey: 'xxxx',
  secretKey: 'xxxx',
  spaceAppId: 'xxxx',
  endpoint: '控制台绑定的自定义域名',
});
//通过uniCloud实例调用云开发的API
myCloud.callFunction()

这种方法适用于在客户端代码中直接使用自定义域名，控制台绑定后即使没有启用，也可以通过设置endpoint来使用自定义域名。