平台概述

简介

医加云开放平台是基于联空网络在医疗+互联网领域近十年的技术沉淀与行业深耕，以自身PaaS服务能力为基座，打造的医疗数字化能力开放平台。我们以“赋能医疗创新，共建智慧生态”为使命，致力于将核心产品“联空医加”积累的智慧服务、互联网医院、支付服务、专科诊疗数字化等能力模块化、标准化，向医院、医疗ISV（独立软件开发商）及生态伙伴开放，构建一个灵活、安全、高效的医疗数字化开发与协作平台，助力客户快速实现个性化需求开发与全场景服务升级。

合作价值

对医院：快速响应医院个性化需求，降低自研成本；通过平台生态引入优质服务资源，提升运营效率。
对ISV：免去底层技术重复开发，聚焦业务创新；共享联空生态流量与资源，加速商业化落地。
对产业链伙伴：无缝对接医院场景，拓展医疗服务边界，实现资源精准匹配。

alt text

技术保障与支持

符合等保三级等医疗数据安全规范，提供全链路数据加密与权限管理。
提供沙箱测试环境、SDK、全生命周期文档及技术支持，保障开发效率。

愿景

医加云开放平台不仅是快速接入平台，更是一个医疗数字化创新的“连接器”与“加速器”。我们期待与医院、开发者、生态伙伴共同探索医疗服务的无限可能。
前往官网了解，即刻加入，共创未来！

1. 获取API访问权限

在开始开发之前，您需要先获取平台的API访问权限。请按照以下步骤操作：

注册账户
请联系我们的商务并注册开发者账户。由商务给您下发您的机构标识。
申请API密钥
登录后，前往开发者控制台并申请一个API密钥。该密钥将用于您对接平台服务时的身份验证。
验证账户信息
为确保安全性，您需要完成账户信息的验证（如邮箱、电话等）。完成验证后，您将可以使用API。
API文档访问
您可以在开发者中心找到详细的API文档，包括所有接口的功能描述、请求参数、返回结果等。请详细阅读相关文档，以了解如何调用不同的服务。

2. 开发环境准备

在进行对接之前，请确保您的开发环境满足以下要求：

2.1 支持的编程语言

我们的API支持多种编程语言的集成。常见的开发语言包括：

Python
Java
Node.js
Go
PHP

2.2 SDK与工具

为便于开发，我们提供了多个语言的SDK，可以帮助您快速集成平台的服务。您可以在 SDK下载页获取相关SDK。

3. 对接流程

3.1 身份认证

每个API请求都需要携带身份认证信息。我们的平台采用 API密钥 进行身份认证。

在每个请求的 Header 中加入
Authorization: Bearer <your_api_key>，其中 <your_api_key> 是您的API密钥。
FunctionCode: {FunctionCode}，其中 FunctionCode 是各服务组件编码

3.2 请求示例

以下是一个基本的API请求示例（以Python为例）：

python

import requests

url = "http://api.linkingopen.com/test/service/im/eplustoolim/api/conversation/userInfo"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "FunctionCode": "TER-B007",
    "Content-Type": "application/json"
}
data = {
    "image_url": "https://example.com/sample.jpg"
}

response = requests.post(url, json=data, headers=headers)

if response.status_code == 200:
    print("成功响应:", response.json())
else:
    print("请求失败:", response.status_code, response.text)

3.3 错误处理

在对接过程中，可能会遇到不同的错误情况。我们建议您根据错误码进行相应的处理。

错误码	错误描述	解决方案
400	错误的请求参数	检查请求的参数格式、类型、值是否符合API要求
401	未授权，API密钥无效或过期	确保API密钥有效，重新生成或更新API密钥
403	禁止访问，权限不足	检查当前账户是否拥有访问权限，或联系管理员申请权限
404	请求的资源未找到	检查请求的URL是否正确，或所请求的资源是否存在
500	服务器内部错误	检查平台状态页面，确认是否是平台问题，或稍后再试

如果遇到其他未知错误，您可以尝试以下步骤：

重新检查API请求：确认请求参数是否完整且符合要求。
查看API文档：确保使用的API接口、参数和方法与文档一致。
联系技术支持：如果问题仍无法解决，请通过邮件或电话与我们联系，我们会尽快为您提供帮助。

3.4 API请求限制

为了保证平台的稳定性，平台对API调用频率进行了一定的限制。具体限制如下：

限制类型	数值
每分钟请求次数	100次
每日请求次数	10,000次

如果超过限制，您将收到 HTTP 429 错误码。我们建议您合理分配请求时间，避免频繁请求。

您可以通过实现请求重试机制来避免因超出限制而造成的请求失败。以下是一个简单的重试示例：

python

import time
import requests

def make_request_with_retry(url, headers, data, retries=3, delay=5):
    for i in range(retries):
        response = requests.post(url, json=data, headers=headers)
        if response.status_code == 429:  # 超过请求限制
            print(f"请求超限，正在重试... ({i + 1}/{retries})")
            time.sleep(delay)  # 等待一段时间再重试
        elif response.status_code == 200:
            return response.json()
        else:
            print(f"请求失败: {response.status_code}")
            return None
    return None

4. 安全性与隐私

在对接过程中，平台会涉及到数据的传输与存储。请注意以下安全要求：

加密传输
所有的API请求必须使用 HTTPS 协议，确保数据在传输过程中不被截获。我们强烈建议您使用SSL证书加密所有的API通信，并验证服务器的身份，防止中间人攻击。
密钥保护
API密钥是您账户的唯一凭证，请妥善保管并避免泄露。不要将API密钥硬编码在公开代码中。如果可能，使用环境变量或密钥管理工具来存储API密钥。定期更新API密钥，并确保旧的密钥及时失效。
数据隐私
平台承诺遵守相关法律法规，保障用户数据的隐私与安全。在使用API时，请勿发送敏感或未经授权的数据。尽可能将敏感数据进行加密存储，并限制其访问权限。
访问控制
请仅授予必要的访问权限，尽量避免赋予过多权限给用户或系统。建议采用最小权限原则，只开放最基本的访问权限。定期审计API访问日志，确保无异常访问行为。
防止DDoS攻击
为了保障平台的正常运行，避免DDoS攻击等恶意流量的影响，我们采取了防火墙、速率限制和流量监控等措施。在请求频率较高时，平台可能会自动调整访问策略，确保系统稳定性。

5. 调试与支持

在对接过程中，如果遇到任何问题，可以通过以下方式获取帮助：

5.2 技术支持

如果您在开发过程中遇到难以解决的问题，可以联系平台技术支持团队：

邮箱：wenkai.z@linkingcloud.cn
电话：17602190612

我们的技术支持团队将尽最大努力帮助您解决问题，并为您提供所需的技术指导。

5.3 文档

详细的API文档可以在开发者控制台中访问，文档涵盖了所有API接口、参数说明、示例代码等。文档地址：API文档

在文档中，您可以找到每个API接口的使用方法，输入输出格式，以及常见的使用场景。文档会根据实际的API更新而不断完善。

6. 常见问题

6.1 如何重置API密钥？

如果您的API密钥丢失或需要更换，可以在联系商务或者技术人员重置密钥。重置后，新生成的API密钥将会自动替代旧密钥。请确保及时更新您的应用配置。

6.2 API接口的更新频率如何？

平台会定期对API接口进行更新。每次更新前，我们会通过邮件或公告的方式通知所有开发者，请定期关注相关信息。我们保证每次更新都会提前通知，并为开发者提供详细的迁移指南。

6.3 如何进行API的版本控制？

平台采用版本控制的API设计，所有接口的版本都会在URL中显示。例如，/v1/ocr 表示1.0版本的OCR接口。如果平台发布了新版本的API，我们将提供向后兼容性支持，并告知开发者哪些功能发生了变化。

6.4 API调用失败时，如何快速定位问题？

当您遇到API调用失败的情况时，请检查以下几个方面：

检查请求参数：确保您的请求中包含了所有必需的参数，并且参数值的格式、类型正确。
查看返回的错误码：根据返回的错误码，查阅文档中对应的错误信息，判断问题所在。
检查API限制：确保没有超出API调用次数限制。
查看服务状态：平台可能会因为维护等原因出现短时间不可用，您可以访问我们的平台状态页面查看最新的服务状态。

如果上述步骤无法解决问题，请及时联系技术支持。

6.5 是否支持离线模式？

目前，平台的大多数服务都需要通过API在线访问。不过，对于一些基础服务（如OCR识别等），我们提供了本地SDK，您可以通过本地部署的方式离线调用。具体的SDK下载和文档说明，请参阅我们的离线SDK文档。

感谢您选择我们的平台进行集成！如果在开发过程中遇到任何问题，请随时联系我们。我们将为您提供全力支持，确保您的项目顺利推进。

OCR识别

线下支付

线上支付

IM聊天室

平台概述

简介

合作价值

技术保障与支持

愿景

1. 获取API访问权限

2. 开发环境准备

2.1 支持的编程语言

2.2 SDK与工具

3. 对接流程

3.1 身份认证

3.2 请求示例

3.3 错误处理

3.4 API请求限制

4. 安全性与隐私

5. 调试与支持

5.2 技术支持

5.3 文档

6. 常见问题

6.1 如何重置API密钥？

6.2 API接口的更新频率如何？

6.3 如何进行API的版本控制？

6.4 API调用失败时，如何快速定位问题？

6.5 是否支持离线模式？

平台概述 ​

简介 ​

合作价值 ​

技术保障与支持 ​

愿景 ​

1. 获取API访问权限 ​

2. 开发环境准备 ​

2.1 支持的编程语言 ​

2.2 SDK与工具 ​

3. 对接流程 ​

3.1 身份认证 ​

3.2 请求示例 ​

3.3 错误处理 ​

3.4 API请求限制 ​

4. 安全性与隐私 ​

5. 调试与支持 ​

5.2 技术支持 ​

5.3 文档 ​

6. 常见问题 ​

6.1 如何重置API密钥？ ​

6.2 API接口的更新频率如何？ ​

6.3 如何进行API的版本控制？ ​

6.4 API调用失败时，如何快速定位问题？ ​

6.5 是否支持离线模式？ ​

平台概述

简介

合作价值

技术保障与支持

愿景

1. 获取API访问权限

2. 开发环境准备

2.1 支持的编程语言

2.2 SDK与工具

3. 对接流程

3.1 身份认证

3.2 请求示例

3.3 错误处理

3.4 API请求限制

4. 安全性与隐私

5. 调试与支持

5.2 技术支持

5.3 文档

6. 常见问题

6.1 如何重置API密钥？

6.2 API接口的更新频率如何？

6.3 如何进行API的版本控制？

6.4 API调用失败时，如何快速定位问题？

6.5 是否支持离线模式？