Soap接口
SOAP的定义
SOAP 是一种轻量级协议,用于在分散型、分布式环境中交换结构化信息。 SOAP 利用 XML 技术定义一种可扩展的消息处理框架,它提供了一种可通过多种底层协议进行交换的消息结构。 这种框架的设计思想是要独立于任何一种特定的编程模型和其他特定实现的语义。
SOAP接口的应用
我们的指纹机可以支持基于XML的SOAP数据接口,您可以在自己的程序中嵌入SOAP请求,就可以下载、上传指纹机中的用户信息,指纹信息及验证记录,并能够很方便的导入到企业自己的数据库或者软件里从而适应企业对人员管理的特殊需要以及不同软件的需要。
基于iClock的SOAP协议规范约定:
1)所有的参数均以<Arg/>形式传递,参数值中<Arg PIN=”2”/><Arg>形式等价于<PIN>2</PIN></Arg>形式
2)所有返回值均以<Return/>形式返回,返回值均以属性值形式返回如<Return PIN=”2”></Return>
3)所有的SOAP提交均采用POST方法
4)如果有错误发生将返回标准Soap错误标记
<SOAP-ENV:Fault>
<faultcode>500</faultcode>
<faultstring>Internal Error</faultstring>
</SOAP-ENV:Fault>
其它错误遵循HTTP错误状态代码
如果所提交的SOAP-XML格式不符合WELL FORMAT 或访问的方法名不存在则系统会返回500 一般性服务错误。如:访问服务名错误将在HTTP头中返回404错误。
服务名:iWsService
该服务名称指明了需要Web Server 提供SOAP服务
HTTP头:
遵循标准的SOAP-HTTP头规则
POST /iWsService HTTP/1.0 ‘需要SOAP服务
Content-Type: text/xml ‘需要指明SOAP解析格式为XML
Content-Length: nnnnn ‘需要指明该SOAP请求的XML大小
SOAPAction:”uri:someuri” ‘扩展的HTTP协议,表示该SOAP的作用域其后的URI可以为空如可接受的格式有
SOAPAction:
SOAPAction:””
SOAPAction:”uri:someuri”
Uri可以是任何合法的域名称
服务器在响应SOAP请求后返回
HTTP/1.0 200 OK ‘200表示成功
Server: ZKWEBSERVER
Content-Type: text/xml
返回的XML-SOAP数据
注意:如需进一步的开发和技术方案,请与我们技术人员联系。 |