应用名名称(必须)
域名(必须,web应用可以是访问路径,接口应用是出口ip,必须统一使用http://或者https:// 开头)
pc端链接(可选)
手机端链接(可选)
应用图标(可选)
应用简介(必须)
应用所属人名称(必须)
应用所属人联系方式(可选)
忽略ssl的例子(java):
public class XXXTest {
@Test
public void test() {
String url = "https://xxx.xxx.com/api?appId=xxx&appSecret=xxx";
try (CloseableHttpClient httpClient = createHttpClient()) {
HttpGet httpGet = new HttpGet(url);
try (CloseableHttpResponse httpResponse = httpClient.execute(httpGet)) {
HttpEntity entity = httpResponse.getEntity();
String result = entity.toString();
EntityUtils.consume(entity);
System.out.println(result);
}
} catch (Exception e) {
}
}
private CloseableHttpClient createHttpClient() throws KeyStoreException, NoSuchAlgorithmException, KeyManagementException {
SSLContext sslcontext = SSLContexts.custom()
.loadTrustMaterial(null, (chain, authType) -> true)
.build();
SSLConnectionSocketFactory sslSf = new SSLConnectionSocketFactory(sslcontext, null, null,
new NoopHostnameVerifier());
return HttpClients.custom().setSSLSocketFactory(sslSf).build();
}
}
生成公钥的例子(java):
参考:http://www.cnblogs.com/wanghaixing/p/5630070.html
请求方式:GET/POST(HTTPS)
请求地址:https://itddapi.wuxiapptec.com/test?access_token=token
请求包体:
...
参数说明:
...
返回结果:
...
1)请求方式,标明接口调用的HTTP方法,区分HttpGet/HttpPost请求。所有的请求都为HTTPS协议。
2)请求地址,接口的请求地址。
3)请求包体/参数说明,标明请求参数示例及说明,参数说明包括字段含义、取值范围。
4)返回结果/参数说明,标明返回参数示例及说明。所有接口的返回结果里都有success、code、message、data。对接方需根据code是否为0或者success是否为true判断是否调用成功(0与true是成功)。而message仅作参考,后续可能会有变动,因此不可作为是否调用成功的判据。
需要对接方获取appId以及appSecret,获取方式参考3.对接须知,获取access_token方式如下,注意:获取token接口后期会加入接口频次限制,token默认2小时过期,推荐使用后台job每2小时内自动调用接口刷新token机制,而不是每次对接都需要调用token接口:
请求方式:GET(HTTPS)
请求地址:https://itddapi.wuxiapptec.com/auth/sns/app/token?appId=key&appsecret=secret
参数说明:
参数 |
参数类型 |
必须 |
说明 |
appId |
String |
是 |
应用的唯一标识key |
appSecret |
String |
是 |
应用的密钥 |
返回说明:
{
"code": 0,
"message": "ok",
"success": "true",
"data": " eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJkaWdpdGFsLXRva2VuIiwiZXhwIjoxNTUxMTcyMDQ1LCJ1c2VySWQiOiIwMzExMDMiLCJuYW1lIjoi5byg55KQIn0.dC3HbH1eOCIT_kv2J8Nc47OqMFzQ8E9Nzgoe9D4B0kQ"
}
请求方式:GET(HTTPS)
请求地址:https://itddapi.wuxiapptec.com/auth/sns/mobile/user/info?access_token=token
参数说明:
参数 |
参数类型 |
必须 |
说明 |
code |
String |
是 |
通过免登获取的code值 |
返回说明:
{
"code": 0,
"message": "ok",
"success": "true",
"data": "{"userId":"031103","name":"张三"}"
}
请求方式:GET(HTTPS)
请求地址:https://itddapi.wuxiapptec.com/auth/sns/pc/user/info?access_token=token
参数说明:
参数 |
参数类型 |
必须 |
说明 |
code |
String |
是 |
通过免登获取的code值 |
返回说明:
{
"code": 0,
"message": "ok",
"success": "true",
"data": "{"userId":"031103","name":"张三"}"
}
请求方式:POST(HTTPS)
请求地址:https://itddapi.wuxiapptec.com/message/text/send?access_token=token
参数说明:
参数 |
参数类型 |
必须 |
说明 |
users |
List<String> |
是 |
工号集合,最大可同时发送40人 |
content |
String |
是 |
内容 |
返回说明:
{
"code": 0,
"message": "ok",
"success": "true",
"data": "{Object}"
}
请求方式:POST(HTTPS)
请求地址:https://itddapi.wuxiapptec.com/message/link/send?access_token=token
参数说明:
参数 |
参数类型 |
必须 |
说明 |
users |
List<String> |
是 |
工号集合,最大可同时发送40人 |
content |
String |
是 |
内容 |
title |
String |
是 |
标题 |
picUrl |
String |
是 |
图片链接 |
msgUrl |
String |
是 |
点击消息跳转的链接 |
返回说明:
{
"code": 0,
"message": "ok",
"success": "true",
"data": "{Object}"
}
此接口比较复杂,应用场景不算很多,目前需要发送oa消息,需要联系digital管理员开通配置。OA消息可以显示form表单、附件、标题、图片、链接等多内容的消息集合