三、注册中心API服务（RESTFUL 格式）

服务注册中心为支持服务注册与发现功能，提供的 RESTFUL 格式API接口如下：

3.1、服务注册 & 续约 API

说明：新服务注册上线1s内广播通知接入方；需要接入方循环续约，否则服务将会过期（三倍于注册中心心跳时间）下线；

  1. 地址格式：{服务注册中心跟地址}/registry
  3. 请求参数说明：
  4.  1、accessToken：请求令牌；
  5.  2、biz：业务标识
  6.  2、env：环境标识
  7.  3、registryDataList：服务注册信息
  9. 请求数据格式如下，放置在 RequestBody 中，JSON格式：
  11.     {
  12.         "accessToken" : "xx",
  13.         "biz" : "xx",
  14.         "env" : "xx",
  15.         "registryDataList" : [{
  16.             "key" : "service01",
  17.             "value" : "address01"
  18.         }]
  19.     }

3.2、服务摘除 API

说明：新服务摘除下线1s内广播通知接入方；

  1. 地址格式：{服务注册中心跟地址}/remove
  3. 请求参数说明：
  4.  1、accessToken：请求令牌；
  5.  2、biz：业务标识
  6.  2、env：环境标识
  7.  3、registryDataList：服务注册信息
  9. 请求数据格式如下，放置在 RequestBody 中，JSON格式：
  11.     {
  12.         "accessToken" : "xx",
  13.         "biz" : "xx",
  14.         "env" : "xx",
  15.         "registryDataList" : [{
  16.             "key" : "service01",
  17.             "value" : "address01"
  18.         }]
  19.     }

3.3、服务发现 API

说明：查询在线服务地址列表；

  1. 地址格式：{服务注册中心跟地址}/discovery
  3. 请求参数说明：
  4.  1、accessToken：请求令牌；
  5.  2、biz：业务标识
  6.  2、env：环境标识
  7.  3、keys：服务注册Key列表
  9. 请求数据格式如下，放置在 RequestBody 中，JSON格式：
  11.     {
  12.         "accessToken" : "xx",
  13.         "biz" : "xx",
  14.         "env" : "xx",
  15.         "keys" : [
  16.             "service01",
  17.             "service02"
  18.         ]
  19.     }

3.4、服务监控 API

说明：long-polling 接口，主动阻塞一段时间（三倍于注册中心心跳时间）；直至阻塞超时或服务注册信息变动时响应；

  1. 地址格式：{服务注册中心跟地址}/monitor
  3. 请求参数说明：
  4.  1、accessToken：请求令牌；
  5.  2、biz：业务标识
  6.  2、env：环境标识
  7.  3、keys：服务注册Key列表
  9. 请求数据格式如下，放置在 RequestBody 中，JSON格式：
  11.     {
  12.         "accessToken" : "xx",
  13.         "biz" : "xx",
  14.         "env" : "xx",
  15.         "keys" : [
  16.             "service01",
  17.             "service02"
  18.         ]
  19.     }