图片验证码接口设计文档Word文档下载推荐.docx

1、 日期： 审核： 日期：（版权所有，翻版必究）文件修改记录修改日期修改状态修改页码及条款修改人审核人批准人目 录1. 功能说明 42. 接口说明 43. 接口参数 43.1 获取验证码图片 43.2 验证验证码 63.3 监控验证码 71. 功能说明图片验证码系统与公司具体业务无关， 它的功能相对简单， 主要有获取验证码图片和验证验证码两个过程， 对运维开通监控接口。 网络通讯使用HTTP + GET。2. 接口说明接口描述中总是有一个参数clientid （业务编码）用来指定由哪个业务发起的请求。 其中clientid从1开始算起， 其具体含义由图片验证码系统定义：业务编码业务描述1邮箱登陆

2、2个邮发送短信21Coco发送短信3个邮发送彩信31Coco发送彩信4个邮通讯录5个邮传真51Coco传真体验中心7精品订阅后台管理系统8网盘登陆9网盘提取文件10群邮件11WAP系统999运营其他业务9999运维监控注意：clientid为0时， 服务器会认为非法业务， 不会响应请求。3. 接口参数3.1 获取验证码图片接口含义：客户端通过http请求获取验证码图片接口协议：HTTP/GET命令字：getimage请求参数说明：参数描述约束clientid业务编码， 描述当前使用的是哪些业务整数必须大于0随机数随机数是为了防止缓存 请求示例：http:/ PVCSVR-GETIMAGE-UR

3、L/getimage?clientid=clientid& 如， /I:10080/getimage?clientid=1&19383应答消息字段：应答消息实体：验证码图片流在应答消息头中，服务器设置有Cookie， 其中包含agentid会话字符串应答示例：HTTP/1.1 200 OKDate: Fri, 21 Nov 2008 01:57:21 GMTConnection: closeAccept-Ranges: bytesPragma: No-cacheSet-Cookie: agentid=a06dfd7f5146a842907f9a174a194ee6b4a11065bc1137c

4、70b54293878208980; PATH=/; DOMAIN=;Content-Type: image/jpegContent-Length: 1381图片字节流3.2 验证验证码业务服务器通过http请求验证验证码的正确性HTTP /GETconfirmimagepvccode=验证码字符串?verifysession=session字符串整数， 必须大于0pvccode验证码字符串agentid会话字符串运维在使用此接口时， 业务编码clientid请设置为9999请求示例：/Imagecode.api.localdomain:10081/confirmimage?pvccode=i

5、dio&agentid=865c0c0b4ab0e063e5caa3387c1a8741c2946f6b9b7292fcded763083c81bcbf字段名类型长度（字节）是否必选String64必选与验证请求中的agentid一致ResultInteger验证结果：0：正确1：错误 Wed, 18 Feb 2009 08:04:20 GMT KeepAlive 74f6748a1d219db516e2346ba6a98be47d22329bc34bc7343bc9624b61d12767a9Result=13.3 监控验证码运维通过http请求获取验证码字符串/ PVCSVR-GETIMAGE-URL 如， http:10080 HTTP/1.1 200 OK Fri, 21 Nov 2008 02:24:57 GMT agentid=8d7a4d0fb2e0f875f80e379af403eaae338daa834058ade0ce2c6072ec8ef7df; text 4hJFw