接口采用技术:Http
一、 基础信息。
1. 流程描述:发送post请求至接口地址。进行身份认证,通过后,调用需要的接口方法,处理后,返回结果。
2. 接口路径:http://apiuu.k.cn/http/httpService.php
3. post传输参数定义:
参数名 描述 类型
xmlData 传输进行身份验证的信息。包含:AppID ,AppToken,AppTime,CilentIP,AppCtid
其中AppCtid为签名生成规则为
AppCtid=md5(key + AppToken + AppID+ AppTime);
Key为双方约定的字符串
infobird
Xml
格式如下:
$xml = <<<EOD
<?xml version="1.0" ?>
<msg>
<Head>
<AppID> AppID 值</AppID>
<AppToken> AppToken值 </AppToken>
<AppCtid>AppCtid值</AppCtid>
<AppTime> AppTime 值</AppTime>
<class>调用的类名</class>
<method>调用的方法名</method>
<parameter name="参数名1" type="array">
<array>
<element name="值名1">1111</element>
<element name="值名2">2222</element>
</array>
</parameter>
<parameter name="参数名2" >22</parameter>
</Head>
</msg>
EOD;
4. Php代码示例:
$url='http://api.zn.com/http/httpService.php';
try {
$appID = "101";
$key = “infobird”;
$keywordcode = “STAFF101”;
$curr_time = time();
$CTID = md5($key.$keywordcode.$appID.$curr_time);
$xml = <<<EOD
<?xml version="1.0" ?>
<msg>
<Head>
<AppID>$appID</AppID>
<AppToken>$keywordcode</AppToken>
<AppCtid>$CTID</AppCtid>
<AppTime>$curr_time</AppTime>
<class>AccountCtrl</class>
<method>test</method>
<parameter name="test" type="array">
<array>
<element name="aa">1111</element>
<element name="bb">2222</element>
</array>
</parameter>
<parameter name="bb" >22</parameter>
</Head>
</msg>
EOD;
$post_data = array(
"xmlData=$xml",
);
$post_data = implode('&',$post_data);
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_HEADER, 0);
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $post_data);
$output = curl_exec($ch);
if(! $output){
echo 'error:';var_dump(curl_error($ch));exit;
}
curl_close($ch);
}catch (Exception $e){
echo 2;var_dump($e);
}
var_dump($output);
5. 公用状态码定义:
状态码 描述
XML请求格式错误 2001
请求的AppID错误 2002
请求的AppToken错误 2003
请求的AppCtid错误 2004
请求的AppTime超时(AppTime与当前时间相差30秒) 2005
请求的类不存在 2006
请求的方法不存在 2007
参数不同 2008
参数名称错误 2009
IP地址不被允许 2010
身份认证通过 200
二、 具体接口
1. 登录接口
a) 调用方式:
i. Class: AccountCtrl’;
ii. Method: ‘login’;
iii. Parameter
<?xml version="1.0" ?>
<msg>
<Head>
<AppID>$appID</AppID>
<AppToken>$keywordcode</AppToken>
<AppCtid>$CTID</AppCtid>
<AppTime>$curr_time</AppTime>
<class>AccountCtrl</class>
<method>login</method>
<parameter name="username">test@1.com</parameter>
<parameter name="password" >1</parameter>
</Head>
</msg>
b) 参数说明:
i. 传入参数username:用户名
ii. 传入参数password:密码
iii. 返回值
成功:
<?xml version="1.0" encoding="utf8" ?>
<msg>
<Head>
<AppID>101</AppID>
<AppToken>STAFF101</AppToken>
<AppCtid>84dd50cc39f3c37e545e60e0a9c95452</AppCtid>
<AppTime>1316081132</AppTime>
<class>AccountCtrl</class>
<method>login</method>
<status>200</status>
<body>
<uid>9133</uid>
<username> test@1.com</username>
</body>
</Head>
</msg>
c) 错误码定义
i. 32001 登录失败
2. 获得用户信息
a) 调用方式
i. Class: AccountCtrl’;
ii. Method: ‘getByUid’;
iii. Parameter
<?xml version="1.0" ?>
<msg>
<Head>
<AppID>$appID</AppID>
<AppToken>$keywordcode</AppToken>
<AppCtid>$CTID</AppCtid>
<AppTime>$curr_time</AppTime>
<class>AccountCtrl</class>
<method>getByUid</method>
<parameter name="uid">用户id</parameter>
</Head>
</msg>
b) 参数说明:
i. 传入参数uid:用户uid,登录时返回的uid信息。
ii. 返回值
成功:
<?xml version="1.0" encoding="utf8" ?>
<msg>
<Head>
<AppID>$appID</AppID>
<AppToken>$keywordcode</AppToken>
<AppCtid>$CTID</AppCtid>
<AppTime>$curr_time</AppTime>
<class>AccountCtrl</class>
<method>getByUid</method>
<status>200</status>
<body>
<uid></uid>
<email>test@32.com</email>
<comname>企业名称2</comname>
<mobile>1591111111112</mobile>
<name>真实姓名1</name>
<nickname>昵称</nickname>
</body>
</Head>
</msg>
失败:
<?xml version="1.0" encoding="utf8" ?>
<msg>
<Head>
<AppID>$appID</AppID>
<AppToken>$keywordcode</AppToken>
<AppCtid>$CTID</AppCtid>
<AppTime>$curr_time</AppTime>
<class>AccountCtrl</class>
<method>getByUid</method>
<status>错误码</status>
<body><success>0<success></body>
</Head>
</msg>
c) 错误码定义:
i. 36001 用户不存在
分享到:
相关推荐
接口方案说明,方便大家参考,类似的项目方案可以参考。
EAI是用友给外部系统提供的一个接口。文档包括用友EAI接口及使用说明,对于涉及到用友二次开发的朋友比较有用
用友华表帮助文档
ERP用友开发文档 ERP用友开发文档 ERP用友开发文档 ERP用友开发文档
用有U8中文帮助文档:用友帮助文档\AP_zh-CN.chm 用友帮助文档\AR_zh-CN.chm 用友帮助文档\AU_zh-CN.chm 用友帮助文档\BO_zh-CN.chm 用友帮助文档\CA_zh-CN.chm 用友帮助文档\CG_zh-CN.chm 用友帮助文档\CM_zh-...
一个很不错的用友单据接口程序,对于企业用友ERP二次开发很有用.包括销售管理单据,和库存管理的单据,采购管理单据的二次开发接口代码
用友852操作文档
用友数据接口-二次开发-用友数据接口-excel数据导入用友t6-u8.rar
远程调用用友EAI接口实例 远程调用用友EAI接口实例 远程调用用友EAI接口实例 远程调用用友EAI接口实例
Cell帮助文档V6.1,帮助文档或开发者,报表开发技术 Cell帮助文档V6.1,帮助文档或开发者,报表开发技术 Cell帮助文档V6.1,帮助文档或开发者,报表开发技术
业务系统写入用友财务数据时参考,用友财务接口数据表结构
用友NC65-erp开发工具uapstudio进行开发webservice时,需要对开发工具进行必要的设置,文档总结了一些必要配置及创建一个helloworld案例并用soapui进行测试
此方案是解决用友NC与其他业务系统对接的资料,提供了现金的思想,并且实现了不同系统的数据共享和无缝连接。
用友U9 第三方系统调用接口培训视频,FBR 格式 ,声音清楚,界面清晰
用友T+二次开发说明文档,PDF格式,带示例说明
用友文档学习总结,很全面,是用友初学者使用手册
本系列文档为用友软件公司软件开发标准文档模板,具有一定的参考价值,每个项目阶段的文档都包含在其中,使你的项目开发标准化。
财会软件文档,很好地体现了软件工程思想的实践应用
用友NCC(NCCloud)Openapi使用及测试文档
用友销售管理说明文档,操作流程,业务模式,操作手册