数据中心域名调整指引
一、名词解释
1.1、指导视频
1.2、阅读对象
本文的阅读对象为开发人员，如项目实施或业务人员收到该通知，请联系项目开发人员查看该文档。 如在本文中未匹配到旧域名，不知如何调整，请提交工单。
1.3、数据中心
目前用友的公有云生产环境分为5个数据中心：商开、核心1、核心2、核心3、海外； 后续新增加的数据中心是核心4。
不同数据中心调用开放平台的接口请求域名不同，所以后续客户调用开放平台接口时 需先调用【获取租户所在数据中心域名】接口。（接口详细信息看第五章节）
1.4、获取租户所在数据中心域名
【获取租户所在数据中心域名】通过该接口，根据租户id可以获取到对应数据中心调用接口的请求域名， 包含请求接口域名和获取token域名。
后续调用开放平台接口均需要先通过该接口获取域名信息，然后根据具体接口 文档的请求地址进行拼接调用。
1.5、注意
请开发者通过【获取租户所在数据中心域名】动态获取域名 或者 基础域名信息放在配置文件。 禁止耦合在代码中。后续如果租户所在数据中心迁移，因为数据中心不同，调用接口地址也会随数据中心变化而调整。 耦合在代码中，如出现此类情况，后续还会引发调整工作量。
二、调整变化
2.1、各数据中心接口调用域名调整
如果还存在其他域名怎么确定数据中心？ 先根据5.1获取到对应基础域名，可以找到调整后的域名。从而确定自己是哪个数据中心。
| 调整时间 | 所述数据中心 | 调整前域名（旧域名） | 调整后域名 |
|---|---|---|---|
| 2023年07月31日 | 商开 | dbox.diwork.com | dbox.yonyoucloud.com |
| 2023年08月04日 | 核心1 | yonbip-core1.diwork.com | c1.yonyoucloud.com |
| 2023年09月15日 | 核心2 | yonbip.diwork.com | c2.yonyoucloud.com |
| 2023年08月11日 | 核心3 | yonbip-core3.diwork.com | c3.yonyoucloud.com |
| 2023年08月23日 | 海外 | globalbip.diwork.com或globalbip.yonyou.com或sg.yonyoucloud.com | global.yonyoucloud.com |
2.2、【获取租户所在数据中心域名】接口请求域名调整
| 调整前域名（旧域名） | 调整后域名 |
|---|---|
| https://api.diwork.com/open-auth/dataCenter/getGatewayAddress?tenantId=xxxxxxxx | https://apigateway.yonyoucloud.com/open-auth/dataCenter/getGatewayAddress?tenantId=xxxxxxxx |
2.3、获取Token接口
部分客开项目使用api.diwork.com获取token，此调用需要调整
【数据中心域名】可以通过【获取租户所在数据中心域名】获取具体的域名地址：
| 调整前域名（旧域名） | 调整后域名 |
|---|---|
| https://api.diwork.com/open-auth/selfAppAuth/getAccessToken | https://数据中心域名/iuap-api-auth/open-auth/selfAppAuth/getAccessToken |
2.4、调用业务接口
部分客开项目调用业务接口的基础域名使用的是api.diwork.com 此情况需要调整（【数据中心域名】可以通过【获取租户所在数据中心域名】获取具体的域名地址）
2.5、单点登录场景
https://****/login 调整为 https://数据中心域名/login
2.6、其他场景
如以上场景未枚举出您使用域名的情况，不要随意调整，避免影响项目正常运行。 请联系对应项目的用友方实施，提交工单。集团研发会跟您工单留的联系方式，联系您指导解决。
三、兼容期
【二、调整变化】 中 列举的所有旧域名， 将于 2023年11月30日 正式废弃。（因业务系统登录域名也同步废弃，接口diwork域名废弃延后,具体时间确认中，如收到通知还请尽快调整。）至时如客户还未进行调整，则无法正确调用接口， 请注意。
四、常见问题
4.1、如何判断自己的租户属于哪个数据中心？
查看2.1、调整前（旧域名） 和自己代码中的域名进行对比， 然后查看所属数据中心即可。
4.2、租户ID（tenantId）如何获取？
五、调整示例
5.1、【获取租户所在数据中心域名】接口信息
接口地址：https://apigateway.yonyoucloud.com/open-auth/dataCenter/getGatewayAddress?tenantId=xxxxxxxx
该接口请求地址调整，其他传参返参不做调整。
5.2、核心逻辑
下图为建议的接口调用流程， 从下图也可以看出，目前只有一个域名是固定的，即【获取租户所在数据中心域名】 该地址可以放到配置文件中，后续方便调整。
可以调用【获取租户所在数据中心域名】获取对应接口基础域名信息，这个地址一般不会调整。建议是调用这个接口动态获取， 如果感觉调整成本较大，也可以获取域名后，放到自己的配置文件中固定配置。
5.3、代码示例
https://gitee.com/ecological-technology/openapidemo
