5.1.返回码-打码兔.docVIP

打码兔HTTP接口使用说明 简介 打码兔HTTP接口提供查询余额、请求打码（通过URL打码、POST图片打码）、报告错误、查询打码结果等功能。 除POST图片打码仅支持POST方法外，其他功能都支持POST和GET两种方法。 所有请求都为单步式请求，所有请求都包括appID、user、pwd、sign四个参数，结果以json方式返回，成功时ret返回0，否则ret返回负数。 软件可以用“查询余额”请求在空闲时查询网络和服务器可用性、以及用户名、用户密码的正确性；可用“POST文件打码”或“通过URL打码”请求服务器打码，一般情况下该请求直接返回打码结果；在明确知道验证码错误的情况下，可以用“报告结果”请求告诉服务器验证码错误；对于超过30秒的长超时验证码，可用“查询打码结果”查询打码结果。 为了防止盗取用户信息等非法行为，所有请求都必须上送签名字段，签名字段是由软件KEY和用户名及其他关键字段连接并进行MD5得到；用户密码字段不送明文，对用户名、用户密码分别进行MD5，连接再进行MD5，最后把软件KEY与上面MD5的结果再次MD5得到。 为了方便脚本语言操作，所有MD5的结果都进行16进制字符串（a-f小写）的扩展。 POST文件打码支持3种方式：1）文件数据编码为16进制字符串，通过fileData字段上传；2）文件数据编码为Base64字符串，通过fileDataBase64上传；3）用multipart/form-data进行POST文件数据到服务器。 请求参数 请求参数包括： # 参数名 含义 包含的请求 说明 appID 应用ID 所有请求 整数。管理后台的软件列表中的“软件ID”。 user 用户名 所有请求 pwd 用户密码块 所有请求 1 连接用户名md5的16进制、用户密码md5的16进制，再进行md5，表示为16进制形式 2连接软件KEY、第一步的结果，再进行md5，表示为16进制形式 sign 签名 所有请求 把软件KEY、用户名、其他关键字段连接起来，再md5运算，取16进制前8个字符 id 验证码ID 查询打码结果、报告错误 整数。由请求打码返回 type 验证码类型ID 打码 整数，参考管理后台的价格表。 len 验证码长度 打码 整数，0不限制。可选参数，默认0 timeout 验证码超时 打码 整数，单位秒。可选参数，默认30 text 是否文本数据 通过POST文件打码 （可选）不为空，文件数据为文本数据，数据必须是gbk编码 fileData 文件数据 通过POST文件打码方式一 16进制编码的字符串 fileDataBase64 文件数据 通过POST文件打码方式二 Base64编码的字符串 extName 文件扩展名 通过POST文件打码方式一二 扩展名不包括前面的点，只能由数字、字母组成。可选 url 验证码的URL 通过URL打码 进行URL编码，必填 cookie COOKIE 通过URL打码 进行URL编码。可选，默认空 referer REFERER 通过URL打码 进行URL编码。可选，默认空 pwd参数的计算 对用户名进行MD5，并扩展为16进制形式得到A。如用户名为“name”，结果为“b068931cc450442b63f5b3d276ea4297” 对密码进行MD5，并扩展为16进制形式得到B。如密码为“password”，结果为“5f4dcc3b5aa765d61d8327deb882cf99” 连接A和B，进行MD5，并扩展为16进制形式得到C。连接第一步结果和第二步结果，结果为“b068931cc450442b63f5b3d276ea42975f4dcc3b5aa765d61d8327deb882cf99”，进行MD5并扩展，结果为“df4b90a86a333bd3d5a926e6b45752bb”。 连接软件KEY和上一步结果C，进行MD5，并扩展为16进制形式得到pwd。如软件KEY为“d79a3dfbe19e6ef46552a6”，对上一步结果进行MD5并扩展，结果为“05ce70090c97c9a2baec9fa45811a575”。 sign参数的计算 连接软件KEY、用户名和其他需要签名的字段参数，得到A。如软件KEY为“d79a3dfbe19e6ef46552a6”，用户名为“name”,对于查询余额，结果为“d79a3dfbe19e6ef46552a6name”。 对上一步结果A进行MD5，并扩展为16进制形式得到B。对“d79a3dfbe19e6ef46552a6name”进行MD5并扩展，结