开始前必读

平台概述

平台主要提供如下基础服务

更新日志

开始开发

申请中台APPID

1。请访问地址 https://mconsole.linkingcloud.cn/admin/index.html#/login 如果没有权限登录，请在钉钉群反馈

2。在 中台应用管理-》增加应用

3。上传自己的公私钥

4。设置 跳转地址 该地址用于应用接入中台后，钉钉扫码登录之后的回跳地址

登录开放平台管理后台,  应用管理 -- 我的应用  来创建应用

邮件中请包含RSA公钥   RSA公钥生成请参考如下链接 https://mssdk.linkingcloud.cn/#a_6cb0be81be5a47e49422ced06adf34c3

生成APPID公钥

第一步 生成RSA密钥

生成方式一（推荐）：使用支付宝提供的一键生成工具（内附使用说明）

• Windows：下载
• MAC OSX：下载

解压打开文件夹，直接运行“支付宝RAS密钥生成器SHAwithRSA1024_V1.0.bat”（WINDOWS）或“SHAwithRSA1024_V1.0.command”（MACOSX），点击“生成RSA密钥”，会自动生成公私钥，然后点击“打开文件位置”，即可找到工具自动生成的密钥。

生成方式二：也可以使用OpenSSL工具命令生成

首先进入OpenSSL工具，再输入以下命令。

经过以上步骤，开发者可以在当前文件夹中（OpenSSL运行文件夹），看到app_private_key.pem（开发者RSA私钥）、app_private_key_pkcs8.pem（pkcs8格式开发者RSA私钥）和app_public_key.pem（开发者RSA公钥）3个文件。开发者将私钥保留，将公钥提交给支付宝配置到开发平台，用于验证签名。以下为私钥文件和公钥文件示例。

注意：对于使用Java的开发者，将pkcs8在console中输出的私钥去除头尾、换行和空格，作为开发者私钥，对于.NET和PHP的开发者来说，无需进行pkcs8命令行操作。

标准的私钥文件示例（PHP、.NET使用）

PKCS8处理后的私钥文件示例（Java使用）

公钥文件示例

第二步 密钥配置

开发者登录开放平台后，找到并进入应用。

点击“RSA(SHA1)密钥”处的“设置开发者公钥”（如已设置则显示“查看开发者公钥”，可修改），将公钥文件去除头尾、换行和空格，仅需填入字符串。

例如转换前公钥pem文件格式：

转换后得到的字符串为：

第三步 获取联空网络公钥

应用上线后点击“查看联空网络公钥”，即可获取联空网络，用于联空网络返回数据的验签和联空网络异步通知的验证签名

对于联空网络公钥，看到的是一个字符串，如下：

如果需要使用文件方式（如使用服务端SDK的PHP/.NET版本）读取联空网络公钥，需要在头尾加入标示后保存至文件，文件内容如下：

接口调用说明

接口调用服务地址

使用 HTTP POST调用接口

使用原生HTTP POST 调用本服务请构造如下参数  POST到正式接口 https://mapi.linkingcloud.cn/gateway

公共请求参数如下

注意,POST请求前请对提交的参数使用自己的RSA私钥签名,服务器端会使用当初申请APPID的公钥验证签名

详细的签名方法请见下文  https://mssdk.linkingcloud.cn/#a_78f60d1e8d244c348d0926ac0f592832

签名与验签

开放平台下载的sdk已将RSA（SHA1）签名验签方法封装，开发者只需要调用sdk配置业务入参即可，用sdk封装的方法发送请求到开放平台时，sdk会自动签名。

如开发者不用sdk，可根据SHA1规则自己拼写签名方法。以下是结合开放平台业务对自主签名进行简单说明：

请求参数签名

1. 筛选
获取所有请求参数，不包括字节类型参数，如文件、字节流，剔除sign字段。

2. 排序
将筛选的参数按照第一个字符的键值ASCII码递增排序（字母升序排序），如果遇到相同字符则按照第二个字符的键值ASCII码递增排序，以此类推。

3. 拼接
将排序后的参数与其对应值，组合成“参数=参数值”的格式，并且把这些参数用&字符连接起来，此时生成的字符串为待签名字符串。SDK中已封装签名方法，开发者可直接调用，详见SDK说明。如自己开发，则需将待签名字符串和私钥放入SHA1 RSA算法中得出签名（sign）的值。
 

4. 调用签名函数
使用各自语言对应的SHA1WithRSA签名函数利用商户私钥对待签名字符串进行签名，并进行Base64编码。 

返回参数验证签名

开发者只对平台返回的json中的 sign 字段移除, 然后将json 的第一级key使用2.排序的规则排序,然后使用3.拼接的方式拼接成字符串  然后 使用自带的语言工具使用rsa 验证签名。

调用签名函数：使用各自语言对应的SHA1WithRSA签名验证函数，传入待验签字段、平台公钥、参数sign对应的值（该参数为支付宝返回）进行验签，根据返回结果判定是否验签通过。

公共错误码

平台网关会对开发者的接口非业务调用错误做统一处理，返回码如下：

字典说明

payment_type  支付方式

特别说明

所有支付接口中的 return_url、notify_url 参数不能带参数,    不要在页面文件的后面再加上自定义参数。例如：

• 错误的写法：http://www.alipay.com/alipay/return_url.php?xx=11
• 正确的写法：http://www.alipay.com/alipay/return_url.php

增加额外的参数可能导致验证签名不正确

 return_url、notify_url   参数必须是合法的地址  可以被支付平台访问的地址 

• 错误的写法：
  http://localhost/alipay/return_url.php
  http://localhost:80/alipay/return_url.php
  http://商户自定义地址/alipay/return!url.do
• 正确的写法：
  能够正常访问的域名地址：http://商户自定义地址/alipay/return_url.php
  能够正常访问的IP地址：http://121.1.1.255/alipay/return_url.php

数据类API

中台业务数据Key集合

业务数据上传接口（每天上传） mapi.data.upload

• 请求参数
• 响应参数

{
  "app_id": "2014072300007148",
  "method": "mapi.data.upload",
  "timestamp": "2014-07-24 03:07:50",
  "nonce_str": "92e31204-4c8d-4057-96e3-d7ac3557bb17",
  "code": "",
  "msg": "",
  "biz_content": {
    "sub_code": "",
    "sub_msg": ""
  },
  "sign_type": "rsa",
  "sign": "DZXh8eeTuAHoYE3w1J+POiPhfDxOYBfUNn1lkeT/V7P4zJdyojWEa6IZs6Hz0yDW5Cp/viufUb5I0/V5WENS3OYR8zRedqo6D+fUTdLHdc+EFyCkiQhBxIzgngPdPdfp1PIS7BdhhzrsZHbRqb7o4k3Dxc+AAnFauu4V6Zdwczo="
}
        

业务数据上传接口（实时上传） mapi.event.data.upload

• 请求参数
• 响应参数

{
  "app_id": "2014072300007148",
  "method": "mapi.event.data.upload",
  "timestamp": "2014-07-24 03:07:50",
  "nonce_str": "8fd04c99-30d4-41b3-84a0-b46a49f0eb2b",
  "code": "",
  "msg": "",
  "biz_content": {
    "sub_code": "",
    "sub_msg": ""
  },
  "sign_type": "rsa",
  "sign": "DZXh8eeTuAHoYE3w1J+POiPhfDxOYBfUNn1lkeT/V7P4zJdyojWEa6IZs6Hz0yDW5Cp/viufUb5I0/V5WENS3OYR8zRedqo6D+fUTdLHdc+EFyCkiQhBxIzgngPdPdfp1PIS7BdhhzrsZHbRqb7o4k3Dxc+AAnFauu4V6Zdwczo="
}
        

子系统客户上传对比流程

中台目前提供3个客户相关接口

1.先通过 mapi.org.data.upload 上传各个子系统客户数据，上传的数据可以用于在联空客户平台进行客户对比和匹配

2.匹配之后，可以通过 mapi.organization.query 查询子系统的客户是否已成功匹配，匹配成功返回每个客户唯一的主索引ID

3.mapi.organization.list  查询可以查询客户平台所有有效且匹配成功的客户集合

联空客户平台地址：https://mconsole.linkingcloud.cn/mch/index.html#/login （无法登陆请在钉钉群内申请）

客户列表查询 mapi.organization.list

• 请求参数
• 响应参数

{
  "app_id": "2014072300007148",
  "method": "mapi.organization.list",
  "timestamp": "2014-07-24 03:07:50",
  "nonce_str": "767febae-4d33-4fb5-95bc-5f5f64bdec0a",
  "code": "",
  "msg": "",
  "biz_content": {
    "sub_code": "",
    "sub_msg": "",
    "org_datas": [
      {
        "org_id": null,
        "org_name": null,
        "org_short_name": null,
        "org_source": null,
        "org_type": null,
        "org_school": null,
        "org_level": null,
        "org_is_valid": null
      }
    ]
  },
  "sign_type": "rsa",
  "sign": "DZXh8eeTuAHoYE3w1J+POiPhfDxOYBfUNn1lkeT/V7P4zJdyojWEa6IZs6Hz0yDW5Cp/viufUb5I0/V5WENS3OYR8zRedqo6D+fUTdLHdc+EFyCkiQhBxIzgngPdPdfp1PIS7BdhhzrsZHbRqb7o4k3Dxc+AAnFauu4V6Zdwczo="
}
        

客户数据查询 mapi.organization.query

• 请求参数
• 响应参数

{
  "app_id": "2014072300007148",
  "method": "mapi.organization.query",
  "timestamp": "2014-07-24 03:07:50",
  "nonce_str": "368c1cde-1755-4dac-8d60-1208c36b97ef",
  "code": "",
  "msg": "",
  "biz_content": {
    "sub_code": "",
    "sub_msg": "",
    "org_id": null,
    "org_name": null,
    "org_short_name": null,
    "org_source": null,
    "org_level": null,
    "org_school": null,
    "org_type": null,
    "org_is_valid": null
  },
  "sign_type": "rsa",
  "sign": "DZXh8eeTuAHoYE3w1J+POiPhfDxOYBfUNn1lkeT/V7P4zJdyojWEa6IZs6Hz0yDW5Cp/viufUb5I0/V5WENS3OYR8zRedqo6D+fUTdLHdc+EFyCkiQhBxIzgngPdPdfp1PIS7BdhhzrsZHbRqb7o4k3Dxc+AAnFauu4V6Zdwczo="
}
        

客户数据上传 mapi.org.data.upload

• 请求参数
• 响应参数

{
  "app_id": "2014072300007148",
  "method": "mapi.org.data.upload",
  "timestamp": "2014-07-24 03:07:50",
  "nonce_str": "18198654-bd0c-4a70-b6a3-6be04b991721",
  "code": "",
  "msg": "",
  "biz_content": {
    "sub_code": "",
    "sub_msg": "",
    "org_id": null
  },
  "sign_type": "rsa",
  "sign": "DZXh8eeTuAHoYE3w1J+POiPhfDxOYBfUNn1lkeT/V7P4zJdyojWEa6IZs6Hz0yDW5Cp/viufUb5I0/V5WENS3OYR8zRedqo6D+fUTdLHdc+EFyCkiQhBxIzgngPdPdfp1PIS7BdhhzrsZHbRqb7o4k3Dxc+AAnFauu4V6Zdwczo="
}
        

预约记录提交 mapi.datasync.reserve.submit

• 请求参数
• 响应参数

{
  "app_id": "2014072300007148",
  "method": "mapi.datasync.reserve.submit",
  "timestamp": "2014-07-24 03:07:50",
  "nonce_str": "9e41e3bf-735c-4f7d-9d00-b12be8d3cd2e",
  "code": "",
  "msg": "",
  "biz_content": {
    "sub_code": "",
    "sub_msg": "",
    "code": 1,
    "message": null
  },
  "sign_type": "rsa",
  "sign": "DZXh8eeTuAHoYE3w1J+POiPhfDxOYBfUNn1lkeT/V7P4zJdyojWEa6IZs6Hz0yDW5Cp/viufUb5I0/V5WENS3OYR8zRedqo6D+fUTdLHdc+EFyCkiQhBxIzgngPdPdfp1PIS7BdhhzrsZHbRqb7o4k3Dxc+AAnFauu4V6Zdwczo="
}
        

预约记录更新 mapi.datasync.reserve.update

• 请求参数
• 响应参数

{
  "app_id": "2014072300007148",
  "method": "mapi.datasync.reserve.update",
  "timestamp": "2014-07-24 03:07:50",
  "nonce_str": "a47deaf1-ca9d-4adc-a778-12384244a64e",
  "code": "",
  "msg": "",
  "biz_content": {
    "sub_code": "",
    "sub_msg": "",
    "code": 1,
    "message": null
  },
  "sign_type": "rsa",
  "sign": "DZXh8eeTuAHoYE3w1J+POiPhfDxOYBfUNn1lkeT/V7P4zJdyojWEa6IZs6Hz0yDW5Cp/viufUb5I0/V5WENS3OYR8zRedqo6D+fUTdLHdc+EFyCkiQhBxIzgngPdPdfp1PIS7BdhhzrsZHbRqb7o4k3Dxc+AAnFauu4V6Zdwczo="
}
        

预约支付通知 mapi.datasync.reserve.paynotify

• 请求参数
• 响应参数

{
  "app_id": "2014072300007148",
  "method": "mapi.datasync.reserve.paynotify",
  "timestamp": "2014-07-24 03:07:50",
  "nonce_str": "a2fabb91-df4a-4fc9-af4d-0a2343bdbd94",
  "code": "",
  "msg": "",
  "biz_content": {
    "sub_code": "",
    "sub_msg": "",
    "code": 1,
    "message": null
  },
  "sign_type": "rsa",
  "sign": "DZXh8eeTuAHoYE3w1J+POiPhfDxOYBfUNn1lkeT/V7P4zJdyojWEa6IZs6Hz0yDW5Cp/viufUb5I0/V5WENS3OYR8zRedqo6D+fUTdLHdc+EFyCkiQhBxIzgngPdPdfp1PIS7BdhhzrsZHbRqb7o4k3Dxc+AAnFauu4V6Zdwczo="
}
        

处方上传 mapi.datasync.prescription.submit

• 请求参数
• 响应参数

{
  "app_id": "2014072300007148",
  "method": "mapi.datasync.prescription.submit",
  "timestamp": "2014-07-24 03:07:50",
  "nonce_str": "8d30506e-df56-45ec-9a2d-59c7538cfb48",
  "code": "",
  "msg": "",
  "biz_content": {
    "sub_code": "",
    "sub_msg": "",
    "code": 1,
    "message": null
  },
  "sign_type": "rsa",
  "sign": "DZXh8eeTuAHoYE3w1J+POiPhfDxOYBfUNn1lkeT/V7P4zJdyojWEa6IZs6Hz0yDW5Cp/viufUb5I0/V5WENS3OYR8zRedqo6D+fUTdLHdc+EFyCkiQhBxIzgngPdPdfp1PIS7BdhhzrsZHbRqb7o4k3Dxc+AAnFauu4V6Zdwczo="
}
        

处方修改 mapi.datasync.prescription.update

• 请求参数
• 响应参数

{
  "app_id": "2014072300007148",
  "method": "mapi.datasync.prescription.update",
  "timestamp": "2014-07-24 03:07:50",
  "nonce_str": "fc6689b3-109d-4984-bc01-60a4939fe2d4",
  "code": "",
  "msg": "",
  "biz_content": {
    "sub_code": "",
    "sub_msg": "",
    "code": 1,
    "message": null
  },
  "sign_type": "rsa",
  "sign": "DZXh8eeTuAHoYE3w1J+POiPhfDxOYBfUNn1lkeT/V7P4zJdyojWEa6IZs6Hz0yDW5Cp/viufUb5I0/V5WENS3OYR8zRedqo6D+fUTdLHdc+EFyCkiQhBxIzgngPdPdfp1PIS7BdhhzrsZHbRqb7o4k3Dxc+AAnFauu4V6Zdwczo="
}
        

处方支付通知 mapi.datasync.prescription.paynotify

• 请求参数
• 响应参数

{
  "app_id": "2014072300007148",
  "method": "mapi.datasync.prescription.paynotify",
  "timestamp": "2014-07-24 03:07:50",
  "nonce_str": "87f3f932-c4c1-413e-a655-fede06bf0045",
  "code": "",
  "msg": "",
  "biz_content": {
    "sub_code": "",
    "sub_msg": "",
    "code": 1,
    "message": null
  },
  "sign_type": "rsa",
  "sign": "DZXh8eeTuAHoYE3w1J+POiPhfDxOYBfUNn1lkeT/V7P4zJdyojWEa6IZs6Hz0yDW5Cp/viufUb5I0/V5WENS3OYR8zRedqo6D+fUTdLHdc+EFyCkiQhBxIzgngPdPdfp1PIS7BdhhzrsZHbRqb7o4k3Dxc+AAnFauu4V6Zdwczo="
}
        

用户就诊卡绑定 mapi.user.card.bind

• 请求参数
• 响应参数

{
  "app_id": "2014072300007148",
  "method": "mapi.user.card.bind",
  "timestamp": "2014-07-24 03:07:50",
  "nonce_str": "c48dcf02-46a9-4967-b55e-1ce83f1b16ba",
  "code": "",
  "msg": "",
  "biz_content": {
    "sub_code": "",
    "sub_msg": ""
  },
  "sign_type": "rsa",
  "sign": "DZXh8eeTuAHoYE3w1J+POiPhfDxOYBfUNn1lkeT/V7P4zJdyojWEa6IZs6Hz0yDW5Cp/viufUb5I0/V5WENS3OYR8zRedqo6D+fUTdLHdc+EFyCkiQhBxIzgngPdPdfp1PIS7BdhhzrsZHbRqb7o4k3Dxc+AAnFauu4V6Zdwczo="
}
        

用户就诊卡解绑 mapi.user.card.cancel

• 请求参数
• 响应参数

{
  "app_id": "2014072300007148",
  "method": "mapi.user.card.cancel",
  "timestamp": "2014-07-24 03:07:50",
  "nonce_str": "a54c0d6c-b834-41ee-95f3-75d50fdec32a",
  "code": "",
  "msg": "",
  "biz_content": {
    "sub_code": "",
    "sub_msg": ""
  },
  "sign_type": "rsa",
  "sign": "DZXh8eeTuAHoYE3w1J+POiPhfDxOYBfUNn1lkeT/V7P4zJdyojWEa6IZs6Hz0yDW5Cp/viufUb5I0/V5WENS3OYR8zRedqo6D+fUTdLHdc+EFyCkiQhBxIzgngPdPdfp1PIS7BdhhzrsZHbRqb7o4k3Dxc+AAnFauu4V6Zdwczo="
}
        

用户就诊卡列表 mapi.user.card.list

• 请求参数
• 响应参数

{
  "app_id": "2014072300007148",
  "method": "mapi.user.card.list",
  "timestamp": "2014-07-24 03:07:50",
  "nonce_str": "50b71e48-4583-4d28-b1e0-3f2eb9329729",
  "code": "",
  "msg": "",
  "biz_content": {
    "sub_code": "",
    "sub_msg": "",
    "datas": [
      {
        "name": "张三",
        "id_card": null,
        "card_id": null,
        "card_no": null,
        "card_type": null,
        "customer_id": null,
        "user_index_id": null
      }
    ]
  },
  "sign_type": "rsa",
  "sign": "DZXh8eeTuAHoYE3w1J+POiPhfDxOYBfUNn1lkeT/V7P4zJdyojWEa6IZs6Hz0yDW5Cp/viufUb5I0/V5WENS3OYR8zRedqo6D+fUTdLHdc+EFyCkiQhBxIzgngPdPdfp1PIS7BdhhzrsZHbRqb7o4k3Dxc+AAnFauu4V6Zdwczo="
}
        

就诊卡详情 mapi.user.card.detail

• 请求参数
• 响应参数

{
  "app_id": "2014072300007148",
  "method": "mapi.user.card.detail",
  "timestamp": "2014-07-24 03:07:50",
  "nonce_str": "b2321757-e1ba-42bc-a9f9-67011477f2ac",
  "code": "",
  "msg": "",
  "biz_content": {
    "sub_code": "",
    "sub_msg": "",
    "datas": [
      {
        "name": "张三",
        "id_card": null,
        "label_cn": null,
        "create_time": null,
        "card_id": null,
        "card_no": null,
        "cert_type": "IDENTITY_CARD"
      }
    ]
  },
  "sign_type": "rsa",
  "sign": "DZXh8eeTuAHoYE3w1J+POiPhfDxOYBfUNn1lkeT/V7P4zJdyojWEa6IZs6Hz0yDW5Cp/viufUb5I0/V5WENS3OYR8zRedqo6D+fUTdLHdc+EFyCkiQhBxIzgngPdPdfp1PIS7BdhhzrsZHbRqb7o4k3Dxc+AAnFauu4V6Zdwczo="
}
        

患者健康指标数据上传 mapi.user.health.index.data

• 请求参数
• 响应参数

{
  "app_id": "2014072300007148",
  "method": "mapi.user.health.index.data",
  "timestamp": "2014-07-24 03:07:50",
  "nonce_str": "caadc954-7a71-4c0f-afea-d8c69f355ca7",
  "code": "",
  "msg": "",
  "biz_content": {
    "sub_code": "",
    "sub_msg": ""
  },
  "sign_type": "rsa",
  "sign": "DZXh8eeTuAHoYE3w1J+POiPhfDxOYBfUNn1lkeT/V7P4zJdyojWEa6IZs6Hz0yDW5Cp/viufUb5I0/V5WENS3OYR8zRedqo6D+fUTdLHdc+EFyCkiQhBxIzgngPdPdfp1PIS7BdhhzrsZHbRqb7o4k3Dxc+AAnFauu4V6Zdwczo="
}
        

联空中台免登体系API

中台免登流程

中台免登流程

子系统接入方式 ，以前台登陆举例：

    1.构造以下地址 ：

     https://mauth.linkingcloud.cn/connect/authorize?client_id={中台应用ID}&response_type={response_type}&scope={scope}&response_mode={response_mode}&state={state}&redirect_uri=UrlEncode(登录跳转地址)

入参说明：

    用户扫码之后，会跳转redirect_uri并带上code参数 

     返回地址如：http://redirect_uri?code=&state=

    2.code换取获取用户信息的access_token

    请求路径：https://mauth.linkingcloud.cn/connect/token

     请求方式：post

     Content-Type:  application/x-www-form-urlencoded

入参：
{
    "grant_type": "authorization_code", 
    "code": "code", 
    "client_id": "中台应用ID", 
    "client_secret": "中台应用secret", 
    "redirect_uri": "构造地址传入的跳转redirect_uri"
}

出参：
{
    "data": {
        "access_token": "eyJhbGciOiJSUzI1NiIsImtpZCI6IjA1MkM1RTQyMTVDRDBDMUUxNTA1RTA4RTZBRjNBREJFRkJGRDc4MjIiLCJ0eXAiOiJKV1QifQ.eyJzdWIiOiIzNGEwZjI4NC03MDdmLTQ1ZmMtOWFmNi1iZjlkYzg5ZWZjZjIiLCJuYW1lIjoiemVuZ3dlbmthaSIsImNsaWVudF9pZCI6IkxDTUMyMDE5MDkxNjExMTQxODAwMyIsImFwcElkIjoiTENNQzIwMTkwOTE2MTExNDE4MDAzIiwidXNlck5hbWUiOiJ6ZW5nd2Vua2FpIiwibmlja05hbWUiOiJ6d2siLCJtb2JpbGUiOiIxNzYwMjE5MDYxMiIsInRva2VuX3VzYWdlIjoiYWNjZXNzX3Rva2VuIiwianRpIjoiYTAyMWVkNTItMTFhZC00NzYyLTkyN2EtMDQyY2IzMjJhNzNlIiwiY2ZkX2x2bCI6InByaXZhdGUiLCJzY29wZSI6WyJvcGVuaWQiLCJwcm9maWxlIl0sImF1ZCI6InJlc291cmNlX3NlcnZlciIsImF6cCI6IkxDTUMyMDE5MDkxNjExMTQxODAwMyIsIm5iZiI6MTU3NTQ0MTk5MCwiZXhwIjoxNTc1NDQ1NTkwLCJpYXQiOjE1NzU0NDE5OTAsImlzcyI6Imh0dHA6Ly9sb2NhbGhvc3Q6NDgwMy8ifQ.YbHs4HY-PYFxRCHb2rKd5qFx0dYquPLJY2XOcMynfMzVElwWTuSA9gktt4LrQSou6CQxXOn6fcrjchhOTjWLGHLJAyJwZrWiaHMIt5Ds-8LWrVZQtOY-V9WbHVu5OV-g8qUGmfrD4KwuVSU5gIz_FsOrCCIHlhK6smPIghWMw76FrjBzU4nmUSOK7HGO8U65EmcjvbW852lVvAg2n4SgAl22ysGaWy6IjZHKLqeB2sFSpGUodOwciSkubvsjlpcLvyxvTH0FQ4Y17N2rMzZIluj_FdcflTPtzgx7Ptd3Xei8XZakReoSDrbvnNjMxBiW3s24jYnXS4bPOgL3bXR7ZA", 
        "expires_in": 3600, 
        "id_token": "eyJhbGciOiJSUzI1NiIsImtpZCI6IjA1MkM1RTQyMTVDRDBDMUUxNTA1RTA4RTZBRjNBREJFRkJGRDc4MjIiLCJ0eXAiOiJKV1QifQ.eyJzdWIiOiIzNGEwZjI4NC03MDdmLTQ1ZmMtOWFmNi1iZjlkYzg5ZWZjZjIiLCJuYW1lIjoiemVuZ3dlbmthaSIsImNsaWVudF9pZCI6IkxDTUMyMDE5MDkxNjExMTQxODAwMyIsImFwcElkIjoiTENNQzIwMTkwOTE2MTExNDE4MDAzIiwidXNlck5hbWUiOiJ6ZW5nd2Vua2FpIiwibmlja05hbWUiOiJ6d2siLCJtb2JpbGUiOiIxNzYwMjE5MDYxMiIsInRva2VuX3VzYWdlIjoiaWRfdG9rZW4iLCJqdGkiOiIyYjExNTg1Mi0xYWVjLTRhOWMtODVjYS00NTY2YmUzYjE0MmEiLCJjZmRfbHZsIjoicHJpdmF0ZSIsImF1ZCI6IkxDTUMyMDE5MDkxNjExMTQxODAwMyIsImF0X2hhc2giOiJvNEhQLV9PdFlNTTN1bW9aN1U2T1dBIiwiYXpwIjoiTENNQzIwMTkwOTE2MTExNDE4MDAzIiwibmJmIjoxNTc1NDQxOTkwLCJleHAiOjE1NzU0NDMxOTAsImlhdCI6MTU3NTQ0MTk5MCwiaXNzIjoiaHR0cDovL2xvY2FsaG9zdDo0ODAzLyJ9.diicQJioTo6t-fLVDJQ4PH9YAE-fteloyMCEvY1yx4AsJHpIHpjaQ1d4ijE_6-GmtXbPDzoR29vqiZWLKKF7bZkvj5r7OIW23ZgQMB3Xz8HwaLm5YfuPl1EVSHa8NpuWrqBFhJHNqB1ep8c8w06KukxZrbNkFPNJ4JMIeh9nK-GybNhR5Iu8_mZQVMuBPepiGp2TPE9229etTXBbuAZ4y5emQnXaG6yMzuhdVSi_L_F9zbivcB7zW63yfQTsSr2Y9j5Ovq49C8mjpjEx5XSZI2uD0_aR3cJ7cSxig83fc4K3-oKDm5wT6QfT50izEBGONhZ_GEnxhCdatixg90CCrA", 
        "scope": "openid profile", 
        "token_type": "Bearer"
    }
}

1.  

2. 3.获取登陆用户信息

3. 请求路径：https://mauth.linkingcloud.cn/connect/userinfo

4. 请求方式：post Content-Type:  application/x-www-form-urlencoded

5. 请求的 headers 增加认证 Authorization：Bearer {access_token}

6.  

   出参：
   {
       "data": {
           "appId": "LCMC20190916111418003", //中台应用ID
           "aud": "LCMC20190916111418003", 
           "avatar": "https://static-legacy.dingtalk.com/media/lADPDgQ9qTAJOwnNAtjNAuw_748_728.jpg", //登陆用户头像
           "iss": "http://localhost:4803/", 
           "mobile": "17602190612", //手机号
           "nickName": "zwk", //昵称
           "sub": "34a0f284-707f-45fc-9af6-bf9dc89efcf2", //用户ID
           "userName": "zengwenkai" //用户登陆名
       }
   }

1.  

2. 4.使用access_token请求中台API资源

3.  请求的 headers 增加认证 Authorization：Bearer {access_token}

登录用户菜单权限获取 mapi.user.auth.menu

• 请求参数
• 响应参数

{
  "app_id": "2014072300007148",
  "method": "mapi.user.auth.menu",
  "timestamp": "2014-07-24 03:07:50",
  "nonce_str": "cbccbde1-ffe5-4772-a083-dc7dd43f326c",
  "code": "",
  "msg": "",
  "biz_content": {
    "sub_code": "",
    "sub_msg": "",
    "menu_list": [
      {
        "menu_id": null,
        "menu_name": null,
        "menu_route_name": null,
        "menu_route_path": null
      }
    ]
  },
  "sign_type": "rsa",
  "sign": "DZXh8eeTuAHoYE3w1J+POiPhfDxOYBfUNn1lkeT/V7P4zJdyojWEa6IZs6Hz0yDW5Cp/viufUb5I0/V5WENS3OYR8zRedqo6D+fUTdLHdc+EFyCkiQhBxIzgngPdPdfp1PIS7BdhhzrsZHbRqb7o4k3Dxc+AAnFauu4V6Zdwczo="
}
        

中台配置中心

中台配置中心接入方案

1.请先在中台管理控制台为各自的应用进行配置，中台管理控制台地址： https://mconsole.linkingcloud.cn/admin/index.html

2.后端接入：

    请先安装NUGET包  MiddleServiceAppConfig

    加入代码：

    .NET CORE->Program.cs

 在appsettings.json文件加入获取配置的参数如

3.使用方法 

消息服务

文本转语音通知服务 mapi.im.voice.code

• 请求参数
• 响应参数

{
  "app_id": "2014072300007148",
  "method": "mapi.im.voice.code",
  "timestamp": "2014-07-24 03:07:50",
  "nonce_str": "6736be5e-0200-47ae-ab2e-2381f9abd3a5",
  "code": "",
  "msg": "",
  "biz_content": {
    "sub_code": "",
    "sub_msg": "",
    "data": {
      "call_id": "116012354148^10281378****"
    }
  },
  "sign_type": "rsa",
  "sign": "DZXh8eeTuAHoYE3w1J+POiPhfDxOYBfUNn1lkeT/V7P4zJdyojWEa6IZs6Hz0yDW5Cp/viufUb5I0/V5WENS3OYR8zRedqo6D+fUTdLHdc+EFyCkiQhBxIzgngPdPdfp1PIS7BdhhzrsZHbRqb7o4k3Dxc+AAnFauu4V6Zdwczo="
}
        

单条模板消息推送 mapi.messageservice.singlepush

• 请求参数
• 响应参数

{
  "app_id": "2014072300007148",
  "method": "mapi.messageservice.singlepush",
  "timestamp": "2014-07-24 03:07:50",
  "nonce_str": "76f68bdc-b995-4585-8f28-73723d8ff92f",
  "code": "",
  "msg": "",
  "biz_content": {
    "sub_code": "",
    "sub_msg": ""
  },
  "sign_type": "rsa",
  "sign": "DZXh8eeTuAHoYE3w1J+POiPhfDxOYBfUNn1lkeT/V7P4zJdyojWEa6IZs6Hz0yDW5Cp/viufUb5I0/V5WENS3OYR8zRedqo6D+fUTdLHdc+EFyCkiQhBxIzgngPdPdfp1PIS7BdhhzrsZHbRqb7o4k3Dxc+AAnFauu4V6Zdwczo="
}
        

批量模板消息推送 mapi.messageservice.batchpush

• 请求参数
• 响应参数

{
  "app_id": "2014072300007148",
  "method": "mapi.messageservice.batchpush",
  "timestamp": "2014-07-24 03:07:50",
  "nonce_str": "6fb7455b-c567-493e-81c1-1c9ca06b1faa",
  "code": "",
  "msg": "",
  "biz_content": {
    "sub_code": "",
    "sub_msg": ""
  },
  "sign_type": "rsa",
  "sign": "DZXh8eeTuAHoYE3w1J+POiPhfDxOYBfUNn1lkeT/V7P4zJdyojWEa6IZs6Hz0yDW5Cp/viufUb5I0/V5WENS3OYR8zRedqo6D+fUTdLHdc+EFyCkiQhBxIzgngPdPdfp1PIS7BdhhzrsZHbRqb7o4k3Dxc+AAnFauu4V6Zdwczo="
}
        

全量模板消息推送 mapi.messageservice.fullpush

• 请求参数
• 响应参数

{
  "app_id": "2014072300007148",
  "method": "mapi.messageservice.fullpush",
  "timestamp": "2014-07-24 03:07:50",
  "nonce_str": "0a9f11f4-2a6b-4125-a921-a8c52f6702d9",
  "code": "",
  "msg": "",
  "biz_content": {
    "sub_code": "",
    "sub_msg": ""
  },
  "sign_type": "rsa",
  "sign": "DZXh8eeTuAHoYE3w1J+POiPhfDxOYBfUNn1lkeT/V7P4zJdyojWEa6IZs6Hz0yDW5Cp/viufUb5I0/V5WENS3OYR8zRedqo6D+fUTdLHdc+EFyCkiQhBxIzgngPdPdfp1PIS7BdhhzrsZHbRqb7o4k3Dxc+AAnFauu4V6Zdwczo="
}
        

自定义短信推送

请求参数

请求参数示例：

{
        "customer_id" : "xxxxxxxxxxxxxx",
        "biz_content" : {
                "sms_content":"",
                "mobile":""
        },
        "method" : "if.pushmessage.mobile",
        "nonce_str" : "b207223f-51af-4f37-ae0e-95785f155c2a",
        "sign" : "1d0V72eBUo/3K2AT3WMW2*********",
        "timestamp" : "2022-12-29 13:49:19"
}

响应参数

响应参数示例

{

        "code": "10000",

        "msg": "发送成功"
}

厂商消息推送服务

调用厂商消息推送服务前，请先联系管理员创建好厂商凭证（厂商ID、厂商私钥、消息类型ID、模板ID）

请求地址：https://mapi.linkingcloud.cn/base/message/Provision/SingleSend

 biz_content 参数说明

channel_params  参数说明

template_fields 数组参数说明

 business_params 参数说明

 入参示例：

出参

{
    "code": "10000",
    "isSuccess": true
}

根据业务类型推送模板消息 mapi.message.push.messagetype

• 请求参数
• 响应参数