我的书签
添加书签
移除书签另外，如果有团队/个人有兴趣的话，也欢迎帮助我们来实现其它语言的客户端，具体细节可以联系@nobodyiam和@lepdou。
首先需要在Apollo中接入你的应用，具体步骤可以参考。
1.2 通过带缓存的Http接口从Apollo读取配置
该接口会从缓存中获取配置，适合频率较高的配置拉取请求，如简单的每30秒轮询一次配置。
由于缓存最多会有一秒的延时，所以如果需要配合配置推送通知实现实时更新配置的话，请参考。
URL: {config_server_url}/configfiles/json/{appId}/{clusterName}/{namespaceName}?ip={clientIp}
Method: GET
参数说明：
1.2.2 Http接口返回格式
该Http接口返回的是JSON格式、UTF-8编码，包含了对应namespace中所有的配置项。
返回内容Sample如下：
1.2.3 测试
由于是Http接口，所以在URL组装OK之后，直接通过浏览器、或者相关的http接口测试工具访问即可。
该接口会直接从数据库中获取配置，可以配合配置推送通知实现实时更新配置。
1.3.1 Http接口说明
URL: {config_server_url}/configs/{appId}/{clusterName}/{namespaceName}?releaseKey={releaseKey}&ip={clientIp}
参数说明：
1.3.2 Http接口返回格式
该Http接口返回的是JSON格式、UTF-8编码。
如果配置没有变化（传入的releaseKey和服务端的相等），则返回HttpStatus 304，response body为空。
如果配置有变化，则会返回HttpStatus 200，response body为对应namespace的meta信息以及其中所有的配置项。
返回内容Sample如下：
由于是Http接口，所以在URL组装OK之后，直接通过浏览器、或者相关的http接口测试工具访问即可。
1.4 应用感知配置更新
Apollo提供了基于Http long polling的配置更新推送通知，第三方客户端可以看自己实际的需求决定是否需要使用这个功能。
如果对配置更新时间不是那么敏感的话，可以通过定时刷新来感知配置更新，刷新频率可以视应用自身情况来定，建议在30秒以上。
如果需要做到实时感知配置更新（1秒）的话，可以参考下面的文档实现配置更新推送的功能。
1.4.1 配置更新推送实现思路
这里建议大家可以参考Apollo的Java实现：RemoteConfigLongPollService.java，代码量200多行，总体上还是比较简单的。
1.4.1.1 初始化
首先需要确定哪些namespace需要配置更新推送，Apollo的实现方式是程序第一次获取某个namespace的配置时就会来注册一下，我们就知道有哪些namespace需要配置更新推送了。
初始化后的结果就是得到一个notifications的Map，内容是namespaceName -> notificationId（初始值为-1）。
运行过程中如果发现有新的namespace需要配置更新推送，直接塞到notifications这个Map里面即可。
1.4.1.2 请求服务
有了notifications这个Map之后，就可以请求服务了。这里先描述一下请求服务的逻辑，具体的URL参数和说明请参见后面的接口说明。
- 请求远端服务，带上自己的应用信息以及notifications信息
- 服务端针对传过来的每一个namespace和对应的notificationId，检查notificationId是否是最新的
- 如果都是最新的，则保持住请求60秒，如果60秒内没有配置变化，则返回HttpStatus 304。如果60秒内有配置变化，则返回对应namespace的最新notificationId, HttpStatus 200。
- 如果传过来的notifications信息中发现有notificationId比服务端老，则直接返回对应namespace的最新notificationId, HttpStatus 200。
- 客户端拿到服务端返回后，判断返回的HttpStatus
- 如果返回的HttpStatus是304，说明配置没有变化，重新执行第1步
- 如果返回的HttpStauts是200，说明配置有变化，针对变化的namespace重新去服务端拉取配置，参见。同时更新notifications map中的notificationId。重新执行第1步。
1.4.2 Http接口说明
Method: GET
参数说明：
1.4.3 Http接口返回格式
该Http接口返回的是JSON格式、UTF-8编码，包含了有变化的namespace和最新的notificationId。
返回内容Sample如下：
1.4.4 测试
由于是Http接口，所以在URL组装OK之后，直接通过浏览器、或者相关的http接口测试工具访问即可。
Apollo从1.6.0版本开始增加访问密钥机制，从而只有经过身份验证的客户端才能访问敏感配置。如果应用开启了访问密钥，客户端发出请求时需要增加签名，否则无法获取配置。
需要设置的Header信息：
1.6 错误码说明
正常情况下，接口返回的Http状态码是200，下面列举了Apollo会返回的非200错误码说明。
客户端传入参数的错误，如必选参数没有传入等，客户端需要根据提示信息检查对应的参数是否正确。
1.6.2 401 - Unauthorized
客户端未授权，如服务端配置了访问密钥，客户端未配置或配置错误。
1.6.3 404 - Not Found
接口要访问的资源不存在，一般是URL或URL的参数错误，或者是对应的namespace还没有发布过配置。
1.6.4 405 - Method Not Allowed
接口访问的Method不正确，比如应该使用GET的接口使用了POST访问等，客户端需要检查接口访问方式是否正确。
