每天健康开放平台《开发说明》
一、每天健康开放平台简介
每天健康开放平台是每天健康对医院接入每天健康系统提供的一组接口。
对接方式
接口对接数据同步
即使用体检中心使用每天健康提供的接口，获取订单、套餐、单位等信息，或体检中心调用每天健康接口，同步体检项目，回单、单位等信息。
对接之前
在使用每天健康开放平台对接前，您需要在线下与每天健康渠道运营合作经理联系，协商合作事宜，联系方式如下：
Email: huwenya@mytijian.com
在与渠道运营经理联系并与每天健康公司达成相关合作后，您将获得接入账号及使用开发平台接口的 appKey 及 appSecret （暂时没有开放申请）
接口地址
正式环境使用: https://api.mytijian.com/open-api/V2/
测试环境使用: https://test-api.mytijian.com/open-api/V2/
二、基础词汇定义
| 词汇 | 描述 |
|---|---|
| app | app指的一个可在开放平台进行业务操作的最基本实体 |
| appKey | 平台分配给接入商的appKey用于标识某个具体的app |
| appSecret | app秘钥，请妥善保管，secret是app调用接口非常重要的凭据 |
| signKey | 参数签名key，双方各自保存，不在任何接口调用中传输。 |
| aesKey | AES加密使用的密码，双方各自保存，不在任何接口调用中传输。 |
| accessToken | 一般接口的唯一调用凭据。2小时内可重复使用。 |
| nonce | 一次性校验码。接口调用参数签名时使用，只能使用一次。 |
| algorithm | 加密算法，接口返回数据时使用的加密算法。 |
| openId | 指用户id。开放平台与应用之间只用openId表示某个具体用户。一个openId仅对一个app有效。 |
三、相关文档说明目录
《开发说明》系列文档提供了开放平台介绍、基础数据描述和开发者规范等内容。
接口调用限制说明
为了合理利用服务器资源，我们对一些查询接口做了调用次数限制。建议开发者合理安排接口调用。
当开放平台监测到接口被异常频繁调用的时候，可能会进行熔断处理。app在一段时间内可能无法再调用某个服务。
每一个应用具体拥有的接口权限，以商务洽谈为准。
接口列表
| 接口 | 调用地址 | 需要签名 | 调用限制 |
|---|---|---|---|
| 测试接口 | /noop | 是 | 不限制 |
| 测试接口 | /noop-nosign | 否 | 不限制 |
| 获取AccessToken | /accesstoken | 否 | 500次/每天 |
| 一次性校验码和数据签名 | /nonce | 否 | 不限制 |
文档更新时间: 2018-10-12 17:22
