文档中心 > API类目 > 体检机构API

alibaba.alihealth.examination.hospital.publish (体检机构对接_门店发布/更新)

第三方B端有新的门店发布,或者老的门店更新的时候,使用这个接口

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
detail String 可选 简介 门店简介
tel String 必须 4001023 门店联系电话
city_name String 必须 杭州 门店所属城市
city_code String 必须 330100 门店城市code(国标)
type String 必须 publish 操作类型: publish=发布,update=更新
key_word String 必须 公立、民营、连锁、二甲、社区卫生院 医院等级,三甲、
exam_notice String 可选 须知(废弃) “须知”使用下面note_category字段
point_x String 必须 120.147733 门店位置经度高德 坐标系
point_y String 必须 40.22077 门店位置纬度高德 坐标系
address String 必须 东海路2号 门店地址
work_time String 必须 工作日08:00~18:00 工作时间
hospital_name String 必须 北京宣武门医院 门店名称
hospital_code String 必须 1 门店code,机构保证唯一
routes String 可选 公交108路下车对面 交通线路,通过\r\n 进行换行
logo String 可选 门店logo的url地址 http://images.aliyun.com/image?id=123
online_report Number 可选 1
  • 默认值:0
  • 是否支持在线报告。0:不支持;1:支持
    social_credit_code String 可选 5466X7778 社会统一信用代码
    report_way String 可选 体检后一般在7-15个工作日出具报告,请到体检中心自取纸质报告。 线下报告获取说明(必填)
    report_way_online String 可选 5-16个工作日 线上体检报告几天出具(如果有电子报告必填)
    env_imgs_url String 可选 ["http://abc.jpg","http://123.png"] 环境图片(json字符串数组),第一张是头图;(传图前先找运营同学要图片规范,别瞎传)
    special_tags_code String 必须 特色服务标签 T10009:地铁直达;T10023:周末可约;T10027:周六可约;T10028:免费停车;T10029:地铁周边;T10032:VIP区;T10033:停车便捷;T10034:周日可约;T10035:报告邮寄;T10037:就诊绿通;T10040:绿色通道;T10041:停车优惠;T10042:专人导检;T10044:免费WIFI;T10045:在线可约
    notify String 可选 请大家有序排队 通知信息
    note_category String 可选 { "1": "体检须知" , "2": "核酸须知","3":"上门检测须知" } 不同种类的预约须知;
    mode String 可选 0 经营模式 0自营模式、1平台模式
    agreement String 可选 图片地址 门店与医院协议
    business_license String 可选 图片地址 营业执照,除门店类型为公立、三甲以外的门店类型均要求上传
    medical_license String 必须 图片地址 医疗经营许可
    category String 可选 1,2 类目:1=体检;2=核酸;3=上门;4=健康证;多个类目以逗号分割
    other_qualification String 可选 其他资质图片地址 其他资质图片地址

    响应参数

    名称 类型 示例值 描述
    result ServiceResult reslut result
    • └ err_message
    • String
    • 参数错误
    • errMessage
    • └ data
    • String
    • {"sn":"xxx","mac":"xxx"}
    • data
    • └ err_code
    • String
    • 400
    • errCode
    • └ eagle_eye_trace_id
    • String
    • 21321312
    • eagleEyeTraceId
    • └ success
    • Boolean
    • true
    • success,true表示成功,false表示失败

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    AlibabaAlihealthExaminationHospitalPublishRequest req = new AlibabaAlihealthExaminationHospitalPublishRequest();
    req.setDetail("简介");
    req.setTel("4001023");
    req.setCityName("杭州");
    req.setCityCode("330100");
    req.setType("publish");
    req.setKeyWord("公立、民营、连锁、二甲、社区卫生院");
    req.setExamNotice("须知(废弃)");
    req.setPointX("120.147733");
    req.setPointY("40.22077");
    req.setAddress("东海路2号");
    req.setWorkTime("工作日08:00~18:00");
    req.setHospitalName("北京宣武门医院");
    req.setHospitalCode("1");
    req.setRoutes("公交108路下车对面");
    req.setLogo("门店logo的url地址");
    req.setOnlineReport(1L);
    req.setSocialCreditCode("5466X7778");
    req.setReportWay("体检后一般在7-15个工作日出具报告,请到体检中心自取纸质报告。");
    req.setReportWayOnline("5-16个工作日");
    req.setEnvImgsUrl("[\"http://abc.jpg\",\"http://123.png\"]");
    req.setSpecialTagsCode("特色服务标签");
    req.setNotify("请大家有序排队");
    req.setNoteCategory("{  \"1\": \"体检须知\" , \"2\": \"核酸须知\",\"3\":\"上门检测须知\" }");
    req.setMode("0");
    req.setAgreement("图片地址");
    req.setBusinessLicense("图片地址");
    req.setMedicalLicense("图片地址");
    req.setCategory("1,2");
    req.setOtherQualification("其他资质图片地址");
    AlibabaAlihealthExaminationHospitalPublishResponse rsp = client.execute(req);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <alibaba_alihealth_examination_hospital_publish_response>
        <result>
            <err_message>参数错误</err_message>
            <data>{&quot;sn&quot;:&quot;xxx&quot;,&quot;mac&quot;:&quot;xxx&quot;}</data>
            <err_code>400</err_code>
            <eagle_eye_trace_id>21321312</eagle_eye_trace_id>
            <success>true</success>
        </result>
    </alibaba_alihealth_examination_hospital_publish_response>

    异常示例

    • XML示例
    • JSON示例
    <error_response>
        <code>50</code>
        <msg>Remote service error</msg>
        <sub_code>isv.invalid-parameter</sub_code>
        <sub_msg>非法参数</sub_msg>
    </error_response>

    错误码解释

    错误码 错误描述 解决方案

    API工具

    如何获得此API

    FAQ

    返回
    顶部