三个接口,
收到 200 就完成

Client ID 与 Secret 只用于识别对接方;每次请求再带一个医院租户编码。你只需要发送房间与笼位、宠物住院、医生处方,收到 200 即完成。

管理员发给你的凭证 Client ID + Client Secret
每次请求携带 医院租户编码 X-EasyChong-Tenant-Code
  • 01房间与笼位
  • 02宠物住院
  • 03医生处方

复制示例,只替换业务内容

管理员会给你一套对接方凭证,以及每家医院各自的租户编码。业务编号仍使用你们已有的房间号、住院单号、宠物号和医生工号。

1

获取 Access Token

管理员会分别提供 Client ID 和 Client Secret。

Terminal
curl -X POST "https://openapi.easychong.cn/oauth2/token" \
  -u "$CLIENT_ID:$CLIENT_SECRET" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "grant_type=client_credentials"

从响应中复制 access_token,放进下面三个请求的 Authorization 请求头。

2

发送房间与笼位

一个请求提交一个房间和它的全部笼位。

POST · 房间 + 笼位
curl -X POST "https://openapi.easychong.cn/openapi/v1/rooms" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "X-EasyChong-Tenant-Code: $TENANT_CODE" \
  -H "Content-Type: application/json" \
  -d '{
    "roomNo": "R01",
    "roomName": "一楼犬住院区",
    "roomType": "DOG",
    "floor": 1,
    "cages": [
      { "cageNo": "R01-01", "cageName": "01号笼" },
      { "cageNo": "R01-02", "cageName": "02号笼" }
    ]
  }'

roomNo 填房间编号;cageNo 填笼位编号;roomType 可填 DOG、CAT、ICU、ISOLATION 或 EXOTIC。

3

发送宠物住院信息

主人、宠物、笼位和负责医生一次提交。

POST · 宠物住院
curl -X POST "https://openapi.easychong.cn/openapi/v1/pets" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "X-EasyChong-Tenant-Code: $TENANT_CODE" \
  -H "Content-Type: application/json" \
  -d '{
    "admissionNo": "ADM-20260901-001",
    "petNo": "PET-1001",
    "petName": "豆包",
    "species": "DOG",
    "breed": "泰迪",
    "weightKg": 6.5,
    "ownerName": "王女士",
    "ownerPhone": "13800000000",
    "cageNo": "R01-01",
    "doctorNo": "DOC-001",
    "doctorName": "李医生",
    "admittedAt": "2026-09-01T10:05:00+08:00"
  }'

admissionNo 填住院单号;petNo 填宠物编号或病历号;doctorNo 填对方系统里的医生工号。护理负责人由 EasyChong 内部安排,第三方不传。

4

发送医生处方

一张处方可以包含多条药品或其他医嘱。

POST · 医生处方
curl -X POST "https://openapi.easychong.cn/openapi/v1/prescriptions" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "X-EasyChong-Tenant-Code: $TENANT_CODE" \
  -H "Content-Type: application/json" \
  -d '{
    "prescriptionNo": "RX-20260901-001",
    "admissionNo": "ADM-20260901-001",
    "doctorNo": "DOC-001",
    "doctorName": "李医生",
    "items": [
      {
        "category": "DRUG",
        "name": "阿莫西林",
        "dosage": "0.5",
        "unit": "片",
        "frequency": "BID",
        "route": "口服",
        "durationDays": 3
      }
    ]
  }'

admissionNo 与上一步保持一致;category 可填 DRUG、PROCEDURE、NURSING、DIET 或 OTHER。每条明细的编号可以不填。

200

看到 200 就完成

EasyChong 已校验并可靠保存请求。后台入库、重试和报警由我们负责,不要求第三方查询任务状态。

三个接口统一响应
{
  "success": true,
  "message": "接收成功",
  "requestId": "4b1d7fe55f6c4b2dbaf768c8730520bb"
}

requestId 只在联系 EasyChong 排查问题时提供,不是查询地址。所有字段的中文含义、必填性和可填值都在中文字段文档中。

一次对接,多家医院按编码区分

每个对接方在一个环境使用一套凭证。每家医院有一个 EasyChong 分配的租户编码,放进请求头即可;内部 tenantId 永不对外。

沙箱凭证会执行真实鉴权、字段校验和可靠保存,但不会写入 EasyChong 正式业务数据。

对接方身份Client ID + Secret
对接方
凭证自动确定
医院
租户编码确定
请求头
X-EasyChong-Tenant-Code
Client Secret 只交付一次

请保存在第三方服务端,不要写进网页、App 或代码仓库。

新增医院只需联系 EasyChong 增加租户授权,不需要重新签发 Client Secret。

每个字段都有中文说明

在线文档会显示中文名称、是否必填、可填值、格式和完整示例。首期不开放修改、停嘱、出院和任务查询。

打开中文字段文档