第三方平台对接云助手

第三方平台

简介

实现明源其他平台与云助手平台的数据互通
1、在云助手注册平台信息
2、获取token
3、接口调用

获取token

正式：https://www.fdccloud.com/api/tenant-open/get-pt-token
预发布：https://qy-qa.fdccloud.com/api/tenant-open/get-pt-token
测试：https://qy-ci.fdccloud.com/api/tenant-open/get-pt-token

传参方式:

POST

{
    "pt_id": "ypass",
    "pt_secret": "mysoft5f4ef85ca2ee0"
}

参数说明：

返回值

{
    "errcode": 0,
    "errmsg": "ok",
    "data": {
        "access_token": "OG1wSWF5bG9TUzNheEw2RVFPWjhIaGhjbHkvRGROQkkra0doa212TFAxUmZZYklhbklqdGNzK2hSUEthTU9JS1lTbDBOWS9wQUczMzkyMnZBRlZiQ1lhRy82VVcwTzFySzh5YmFhMk45eExzbFZQRGZ6Zmdqc3h3RVFIZFE0L29hRklMNFJiVVBHRDh5ZVJ6RkdGU013PT0=",
        "expires_in": 7200
    }
}

参数说明：

企业搜索

正式：https://www.fdccloud.com/api/tenant-open/search-tenant?access_token=ACCESS_TOKEN
预发布：https://qy-qa.fdccloud.com/api/tenant-open/search-tenant?access_token=ACCESS_TOKEN
测试：https://qy-ci.fdccloud.com/api/tenant-open/search-tenant?access_token=ACCESS_TOKEN

传参方式:

POST

{
    "tenant_code": "poly"
}

参数说明：

返回值

{
    "errcode": 0,
    "errmsg": "ok",
    "data": {
        "tenant_id": "my56a9c966df069",
        "tenant_code": "mysoft_ci",
        "tenant_name": "测试企业"
   }
}

参数说明：

获取租户信息

请求参数说明

返回结果

{
    "errcode": 0,
    "errmsg": "ok",
    "data": {
        "tenant_id": "my56a9c966df069",
        "tenant_code": "mysoft_ci",
        "tenant_name": "测试企业"
   }
}

租户列表

正式：https://www.fdccloud.com/api/tenant-open/get-tenants?access_token=ACCESS_TOKEN
预发布：https://qy-qa.fdccloud.com/api/tenant-open/get-tenants?access_token=ACCESS_TOKEN
测试：https://qy-ci.fdccloud.com/api/tenant-open/get-tenants?access_token=ACCESS_TOKEN

传参方式:

GET

返回值

{
    "errcode": 0,
    "errmsg": "ok",
    "data": [{
        "tenant_id": "my56a9c966df069",
        "tenant_code": "mysoft_ci",
        "tenant_name": "测试企业",
        "scrm_customer_id": "92c15ba6-c472-4b22-bcd6-5d7930d6e61b",
        "scrm_top_customer_id": "92c15ba6-c472-4b22-bcd6-5d7930d6e61b",
        "scrm_authorize_guid": "92c15ba6-c472-4b22-bcd6-5d7930d6e61b",
        "erpapi_url":"http://ci.mysoft.com.cn:8081/fdccloud_307"
    }]
}

参数说明：

创建租户

正式：https://tenants.fdccloud.com/tenant/api/create-tenant-v2?access_token=token&callback_url=xx
预发布：https://tenants-qa.fdccloud.com/tenant/api/create-tenant-v2?access_token=token&callback_url=xx
测试：https://tenants-ci.fdccloud.com/tenant/api/create-tenant-v2?access_token=token&callback_url=xx

请求包结构

{
    "owner_area":"8",
    "contract_number":"LY0020191008000016",
    "contract_name":"中铁房地产集团(福州)有限公司",
    "tenant_code":"zhongtie_ci",
    "customer_id":"28af4f13-45d2-4443-8efb-006e7fdbd585",
    "customer_name":"中铁房地产集团(福州)有限公司",
    "admin_name":"张三",
    "admin_mail":"zhangs01@mingyuanyun.com",
    "admin_phone":"13657250918",
    "yzs_expire_at":"2021-09-18",
    "from":"erp_manager"
}

请求参数说明

返回结果

{
    "success": 1,
    "data": {
        "tenant_id": "my611a29d4053cd",
        "tenant_code": "zxl_test_3"
    }
}

callback_url回调样例代码

$data = [
            'tenant_code'=>$tenant_code,
            'success'=>$isOk,
            'message'=>$err
];
$curl  = new Curl();
//post formdata方式
$ret = $curl->post($callbackurl, $data);

通讯录初始化

正式：https://www.fdccloud.com/api/tenant-open/init-address?access_token=ACCESS_TOKEN
预发布：https://qy-qa.fdccloud.com/api/tenant-open/init-address?access_token=ACCESS_TOKEN
测试：https://qy-ci.fdccloud.com/api/tenant-open/init-address?access_token=ACCESS_TOKEN

传参方式:

POST

{
    "from": "jmpt",
    "tenant_code": "ywy_ci"
}

参数说明：

返回值

{
    "errcode": 0,
    "errmsg": "ok"
}

参数说明：

发布应用

正式：https://www.fdccloud.com/api/tenant-open/publish-app?access_token=ACCESS_TOKEN
预发布：https://qy-qa.fdccloud.com/api/tenant-open/publish-app?access_token=ACCESS_TOKEN
测试：https://qy-ci.fdccloud.com/api/tenant-open/publish-app?access_token=ACCESS_TOKEN

传参方式:

POST

{
    "tenant_id": "my56a9c966df069",
    "app_name": "移动审批",
    "app_memo": "随时随地，轻松审批",
    "app_logo_url": "https://x/images/mWorkflow_640_v3.png",
    "openurl": "http://x/index?kindType=5",
    "backend_url": "http://x/settings/basic/index",
    "enable_visual_range_ctrl":1,
    "enable_auth_ctrl":1,
    "owner":"张三"
}

参数说明：

重要：saas应用发布后，需要云助手团队审核通过，客户才能在云助手中看到对应的应用

返回值

{
    "errcode": 0,
    "errmsg": "ok",
    "data": {
        "app_code": "9001",
        "app_key": "third5810502b5e148"
    }
}

参数说明：

编辑应用

正式：https://www.fdccloud.com/api/tenant-open/edit-app?access_token=ACCESS_TOKEN
预发布：https://qy-qa.fdccloud.com/api/tenant-open/edit-app?access_token=ACCESS_TOKEN
测试：https://qy-ci.fdccloud.com/api/tenant-open/edit-app?access_token=ACCESS_TOKEN

传参方式:

POST

{
    "app_key": "third5810502b5e148",
    "tenant_id": "my56a9c966df069",
    "app_name": "移动审批",
    "app_memo": "随时随地，轻松审批",
    "app_logo_url": "https://x/images/mWorkflow_640_v3.png",
    "openurl": "http://x/index?kindType=5",
    "backend_url": "http://x/settings/basic/index",
    "enable_visual_range_ctrl":1,
    "enable_auth_ctrl":1,
    "app_type":2,
    "download_url":"https://a.b.c/d.zip",
    "owner":"张三"
}

参数说明：

重要：saas应用更新后，需要云助手团队审核通过，客户才能在云助手中看到更新后的应用

返回值

{
    "errcode": 0,
    "errmsg": "ok",
    "data": {
        "app_code": "9001",
        "app_key": "third5810502b5e148"
    }
}

参数说明：

租户应用授权

正式：https://tenants.fdccloud.com/tenant/api/modify-app-authorized?access_token=token
预发布：https://tenants-qa.fdccloud.com/tenant/api/modify-app-authorized?access_token=token
测试：https://tenants-ci.fdccloud.com/tenant/api/modify-app-authorized?access_token=token

请求包结构

{
    "add_authorized_appkey":"mysoft5d36b507746b1,mysoft6116305e0b16d",
    "del_authorized_appkey":"mysoft61161a7750d79",
    "tenant_id": "my56a9c966df069"
}

请求参数说明

返回结果

{
    "success": 1,
    "data": "应用授权成功"
}