[关闭]
@myyzs 2021-01-13T01:48:09.000000Z 字数 5338 阅读 83

万能集成方案接口文档

万能集成

获取access_token

接口地址

https://www.fdccloud.com/api/tenant-open/get-pt-token

请求方式

POST

请求参数

{
   "pt_id":"xxxx",
   "pt_secret":"aaaa"
}

返回结果

 //成功
    {
        "errcode": 0,
        "errmsg": "ok",
        "isComplete": 1,
        "data": {
            "access_token": "OG1wSWF5bG9TUzNheEw2RVFPWjhIaGhjbHkvRGROQkkra0doa212TFAxUmZZYklhbklqdGNzK2hSUEthTU9JS1lTbDBOWS9wQUczMzkyMnZBRlZiQ1lhRy82VVcwTzFySzh5YmFhMk45eExzbFZQRGZ6Zmdqc3h3RVFIZFE0L29NVUNCejc2MGI4Qm5lVWJyenBkOVJBPT0=",
            "expires_in": 7200
        }
    }
    //失败
    {
        "errcode": 1011,
        "errmsg": "pt_id或者pt_secret不合法",
        "data": ""
     }

开启集成接口

接口地址

https://www.fdccloud.com/api/tenant-open/open-wnjc?access_token=ACCESS_TOKEN

请求方式

POST

请求参数

{
     "tenant_id":"my59f28f2804a9d",
     "user_field":"user_code",
     "user_secret":"xxxxxxxxxxxxx",
     "send_msg_app_code":["3021","3042"],
     "msg_api":"http://xxxxx/api/sendmsg",
     "client_id":"AppDemo",
     "client_secret":"27084a70a3fba78",
     "extra_config":{"topic":"xxxx"}
}

参数说明

参数 说明
tenant_id 云助手租户id，唯一
user_field url中用户身份信息的key
user_secret 秘钥，用来解析用户信息
send_msg_app_code 发送消息的应用集合，只有填写对应的app_code才会转发该应用的消息接口，常用的应用的app_code，管理简讯：3021，移动报表：3023，移动审批：3022，移动计划：3042
msg_api 开启的应用的消息，会把消息的对象发送到此接口中
client_id 获取mip的token需要的client_id
client_secret 获取mip的token需要的client_secret
extra_config mip额外配置

返回结果

  //成功
    {
        "errcode": 0,
        "errmsg": "ok"
    }
    //失败
    {
        "errcode": 1,
        "errmsg": "请填写消息接口地址"
    }

说明

  1. 支持重复调用，如果开启了，则更新参数，没有开启，则开启集成方案同时添加参数

关闭集成接口

接口地址

https://www.fdccloud.com/api/tenant-open/close-wnjc?access_token=ACCESS_TOKEN

请求方式

POST

参数说明

参数 说明
tenant_id 云助手租户id，唯一

请求参数

{
     "tenant_id":"my59f28f2804a9d"
}

返回结果

  //成功
    {
        "errcode": 0,
        "errmsg": "ok"
    }
    //失败
    {
        "errcode": 1,
        "errmsg": "关闭失败"
    }

备注


1.errcode 值为0，则成功请求，其他则代表失败错误码

消息接口参数

{
    "EventTopic": "xxxx.3022",
    "EventBody": {
        "handleType": "sendMsg",
        "msgInfo": {
            "biz_id": "biz10001",
            "appcode": "3022",
            "tenant_id": "dev_fangl",
            "openid": "mysoft5f60203871098500325831",
            "msgtype": "oa",
            "content": {
                "message_url": "http:\/\/www.baidu.com",
                "body": {
                    "title": "测试标题2",
                    "content": "这是一个测试内容"
                }
            },
            "extra": "{\"biz_type\":0,\"open\":\"http:\\\/\\\/www.baidu.com\"}"
        },
        "userInfo": {
            "yzs_user_code": "10002",
            "user_guid": "5f6020383cca8",
            "user_name": "张3",
            "user_code": "10002",
            "mobile_tel": "",
            "offcie_tel": "",
            "home_tel": "",
            "email": "",
            "is_disabled": "0",
            "is_mobile_user": null,
            "user_kind": null,
            "create_time": "2020-09-15 10:00:24",
            "dept_guid": "5f602034f2ad0",
            "user_pwd": "9103c8c82514f39d8360c7430c4ee557",
            "erp_ver": "",
            "user_name_pinyin": "zhang3",
            "user_name_pinyin_h": "z",
            "update_time": "2020-09-17 15:10:31",
            "is_combination_mobile": "0",
            "is_wf_display": "0",
            "erp_wx_user_id": "",
            "default_station": ""
        }
    },
    "Header": [{
        "EventId": ""
    }, {
        "EventCode": "xxxx"
    }, {
        "Host": "127.0.0.1"
    }, {
        "Timespan": "2020-09-29 15:27:04"
    }]
}

msgInfo

OA

{
"biz_id": "200001968993",
"tenant_id": "my596c24f03fc0e",
"appcode": "3022",
"openid": "mysoft5f349ecea537b116142106",
"msgtype": "oa",
"content": {
    "head": {
        "bgcolor": "33b5e5",
        "text": "头部标题"
    },
    "message_url": "https:\/\/qy-ci.fdccloud.com\/my596c24f03fc0e\/demo\/clx\/html?__from=wnjc&user_code=sTmsmW4aNFfmEYKCHiVXRQ%3D%3D",
    "body": {
        "title": "应用集成206896",
        "content": "5月20日，习近平赴江西考察调研。上午，他到了位于赣州市区的江西金力永磁科技股份有限公司，下午的行程则集中在了赣州于都县。一周之前的中共中央政治局会议决定，从今年6月开始，在全党自上而下分两批开展“不忘初心、牢记使命”主题教育。在主题教育即将开展之际，习近平总书记此次到访中央红军长征集结出发地，引人关注。",
        "author": "初良祥",
        "image": "https:\/\/oss-mytest.oss-cn-hangzhou.aliyuncs.com\/0000\/applogos\/89275627eb304471795da7a10f8e7ef6.jpg?x-oss-process=image\/bright,0",
        "form": [{
            "key": "姓名:",
            "value": "张三"
        }, {
            "key": "年龄:",
            "value": "20"
        }],
        "file_count": 3,
        "rich": {
            "num": "15.6",
            "unit": "元"
        },
        "ywstatus": {
            "text": "待审批",
            "color": "ff0000"
        }
    }
},
"status": 1,
"safe": null,
"sendto": 96,
"no_disturbing": 0,
"traceId": "599e76893974113cf4331d6439657113c526fc51",
"mark": [{
    "bgcolor": "0000FF",
    "text": "帅"
}],
"extra": {
    "biz_type": 0,
    "open": "http:\/\/qy-ci.fdccloud.com\/workflow-micro\/my596c24f03fc0e\/workflow\/process-list\/index?kindType=5&wakeMode=&",
    "process_guid": "A88AAFDE-C20A-EA11-80BA-005056A81237-689",
    "creator": "mysoft5ca315b51b86e920156269",
    "process_detail_url": "http:\/\/qy-ci.fdccloud.com\/workflow-micro\/my596c24f03fc0e\/workflow\/process-list\/index?kindType=5"
},
"recv_time": "2020-10-13 11:31:55",
"mns_messageid": "C9BDB4CA4C9F630C39384045C9682800"

}

news

{
    "biz_id": null,
    "tenant_id": "my596c24f03fc0e",
    "appcode": "3022",
    "openid": "mysoft5f349ecea537b116142106",
    "msgtype": "news",
    "content": "{\"articles\":[{\"title\":\"new类消息标题\",\"description\":\"new字类消息的描述\",\"url\":\"http:\\\/\\\/qy-ci.fdccloud.com\\\/workflow-micro\\\/my596c24f03fc0e\\\/workflow\\\/process-list\\\/index?kindType=5&__from=wnjc\",\"picurl\":\"https:\\\/\\\/my.fdccloud.com\\\/img\\\/logo.png\"}]}",
    "status": 1,
    "safe": null,
    "sendto": 96,
    "no_disturbing": 0,
    "traceId": "cb141cb0c53b73d6508002d009611019ea7761a4",
    "recv_time": "2020-09-29 16:43:50",
    "mns_messageid": "C9BDB4CA4C9F61357FA593C91AC04FF6"
}

text

{
    "biz_id": null,
    "tenant_id": "my596c24f03fc0e",
    "appcode": "3022",
    "openid": "mysoft5f349ecea537b116142106",
    "msgtype": "text",
    "content": {
        "content": "这是一个text类消息测试"
    },
    "status": 1,
    "safe": null,
    "sendto": 96,
    "no_disturbing": 0,
    "traceId": "26582ab326082be3c9901a050b0597fbf60f641e",
    "recv_time": "2020-09-29 17:35:20",
    "mns_messageid": "C9BDB4CA4C9F630B7FBC93F84040B465"
}

参数说明

根据msgtype的值来判断消息类型，

text类消息,msgInfo['content']['content']为消息内容

news类消息,msgInfo['content']['articles'][0]['title']为标题，
msgInfo['content']['articles'][0]['description']为内容，
msgInfo['content']['articles'][0]['url']为跳转链接,
msgInfo['content']['articles'][0]['picurl']为图片地址

oa类消息，
msgInfo['content']['body']['title']为标题，
msgInfo['content']['body']['content']为内容，
msgInfo['content']['message_url']为跳转链接,
msgInfo['content']['body']['image']为图片地址

userInfo：用户信息体，里面有usercode，userguid信息

添加新批注
在作者公开此批注前，只有你和作者可见。
回复批注