接口文档
1、登录(GET)
2、图片识别(POST):base64格式
3、极验四代识别
4、极验四代识别(返回w)
5、极验二代三代通用(滑动、点选)
6、极验二代三代识别(无感)
7、用户积分查询
8、谷歌recaptcha请求识别
9、谷歌recaptcha获取识别结果
GET http://api.damagou.top/apiv1/login.html?username=xxx&password=xxxx //请求参数 username String [必填] 用户名 password String [必填] 密码 isJson String [选填] 定义返回数据格式 默认值为1, 1-返回文本、2-返回json 返回数据:userKey //例子 GET http://api.damagou.top/apiv1/login.html?username=18310502205&password=123456 //返回结果 // 文本格式: // 正确结果 ABCDEF123123321231243123123123123123 // 错误结果 错误原因 // json格式: // 正确结果 {"msg":"success","data":"ABCDEF123123321231243123123123123123","status":"0"} // 错误结果 {"msg":"错误原因","status":"1"}
POST http://api.damagou.top/apiv1/recognize.html //参数 image String [必填] 图片编码为Base64字符串格式(如果接口返回错误,请将此值进行urlencode) userkey String [必填] 用户登录成功后返回的userkey type String [选填] 题型 默认为1001, 英数混合题 isJson String [选填] 定义返回数据格式 [选填] 默认值为1, 1-返回文本、2-返回json 返回数据:识别结果 //返回结果例子 // 文本格式: // 正确结果 fdck // 错误结果 错误原因 // json格式: // 正确结果 {"msg":"success","data":"fdck","status":"0"} // 错误结果 {"msg":"错误原因","status":"1"}
GET http://api.damagou.top/apiv1/jiyan4Recognize.html //参数 userkey String [必填] 用户登录成功后返回的userkey captchaId String [必填] 极验四代参数captcha_id riskType String [选填] 极验四代参数risk_type,抓到的包中,如果load请求参数中有此参数 则需要填,无则不需要填 challenge String [选填] 部分特殊类型需要填此参数 referer String [选填] http请求的Referer头,部分特殊类型需要填此参数 cookie String [选填] http请求的cookie,部分特殊类型需要填此参数 staticServer String [选填] 图像 js等静态资源的地址,某些特殊类型需要填写,如果请求的域名不是gcaptcha4.geetest.com,则可能需要填写此参数,一般无须填写,如果无法确定可联系客服. server String [选填] 如果load请求的域名不是gcaptcha4.geetest.com,则需要填写此参数,例如: https://***.***.com/public/load?captcha_id=****** 上面load请求的域名不是gcaptcha4.geetest.com,那么调用接口时需要有 server=***.***.com/public 参数. 对某些特殊定制型,如果load请求存在自定义参数,那么server参数为 server=***.***.com/public?自定义参数名1=自定义参数值1&自定义参数名2=自定义参数值2 形式 isJson String [选填] 定义返回数据格式. 默认值为1, 1-返回文本、2-返回json proxy String [选填] 代理ip. 可以传入自己的代理ip.如果使用http或https代理,则传入格式为 ip:端口:账号:密码. 无需账号密码的 可以只传ip和端口, 即 ip:端口. 示例:221.230.226.215:37344:u00111:AbCDEF 如果使用socks5代理,则传入格式为 ip:端口:账号:密码:socks5. 无需账号密码的 可以只传ip和端口, 即 ip:端口:socks5. 示例:221.230.226.215:37344:u00111:AbCDEF:socks5 userAgent String [选填] http请求的User-Agent头. 部分特殊类型需要填此参数. 如遇无法通过, 请填写此参数, 并将所有http请求的User-Agent头设置为和此参数值相同. //返回数据 lot_number|pass_token|gen_time|captcha_output 注意:如果无法通过,请按照以下步骤调试: 1,请将返回的captcha_output进行urlencode编码,编码后'='会被%3D替换. 2,尽量传入所有[选填]参数. 3,给客服留言,协助对接. 4,某些特殊型有自定义参数,可通过server参数传入. //返回结果例子 // 文本格式: // 正确结果 5478d094b6b84770a29ffe411d78135f|f33b4a85fd7f141c3895cce216adc60435f0469f7a4ab32fccdee35f4ce90045|1637774507|1X_RK3ag_IKlW15iHhSywQ== // 错误结果 错误原因 // json格式: // 正确结果 {"data":"5478d094b6b84770a29ffe411d78135f|f33b4a85fd7f141c3895cce216adc60435f0469f7a4ab32fccdee35f4ce90045|1637774507|1X_RK3ag_IKlW15iHhSywQ==","msg":"success","status":"0"} // 错误结果 {"msg":"错误原因","status":"1"}![]()
POST http://api.damagou.top/apiv1/jiyan4CustomRecognize.html //参数 userkey String [必填] 用户登录成功后返回的userkey captchaId String [选填] 极验四代参数captcha_id, 一般需要此参数, 请尽量传入此参数 loadRes String [必填] load请求的返回数据保持不变,urlencode编码后填入此参数 referer String [选填] http请求的Referer头,部分定制类型需要填此参数 staticServer String [选填] 图像js等静态资源的地址,某些特殊类型需要填写,如果请求的域名不是gcaptcha4.geetest.com,则可能需要填写此参 数,一般无须填写,如果无法确定可联系客服. userAgent String [选填] http请求的User-Agent头. 部分特殊类型需要填此参数. 如遇无法通过, 请填写此参数, 并将所有http请求的User-Agent头设置为和此参数值相同. 部分情况需要设置代理ip, 遇到无法识别情况请在load请求与verify请求设置代理ip //返回数据 w 注意:如果无法通过,请按照以下步骤调试: 1,尽量传入所有[选填]参数. 2,给客服留言,协助对接. //返回结果例子 // 文本格式: // 正确结果 b202c76465495f61df6eb8458baa15fc0cfe40da7bbe18b4ccef54885d314a3f9fcb3161d3cccefb87fbccd2e12af550a2ccc49787f5306b409a0af110d703e37422c95a974f33a1b5a206aae9b1ff14c53442612c3f9db16d77f1d74c6cd3ca00af2d70b4bfdbc364d7ceb95dbfa71d6d9774471511ce48513a6e0fdc7ab1a130a2e8350f343a55026856ea13e60c2ea05d31b888f7651e5a160db09dcca2a3c42e2a1f62f0080d5ff59baa1eb041a5eedbe2ff5e73be8e58aa6c72dda2b190899b6f8acf8e16bede45aad763de455f1cbf18d766a86dfffc96d82b70da473d1abce667d42749bd1576a69e694473adc6afc9d9720bd9084bb8ed5f2c470189398efe3ea035597251d18a15779b455b39e5f6bcc21fddf5b4ea2c3debebaa7a4e622903b9f18434e04ed6621a1a2841c75b9ae0f15f5e60f40890698e4546e6fcdd8c46f30fce0294c144e830227a97a6324d0176d94d7b720249c679aa667a5d44f82b08ec043de2738c8ef2f9f60d8e71eb385c7330994ba81fb220b3c1ed6429bfa722f42134a791a42d38ea6683bc1868b9d20f4e030bf0aa8aa1afa4efce2934d82ad0741914a41e775041257004f3e67a2bf8ae48778f890b9407464f2ec04825c1c669a148d5d528bcb7ea85ce1315c4d15d5bfd9c904d92b54bcea341f78cf7956c92b384658b007c5ebcbef92bc1a8e1cc045761b21a0260320b1d192644326f255dcff21dacd95a5f56f6af9f9d1328882b5eb3b57a184181789379789b61632b9df6dec62fb7ddb53d3edaae386e188374b34e9d4c6c378bb29e // 错误结果 错误原因 // json格式: // 正确结果 {"msg":"success","status":"0","data":"b202c76465495f61df6eb8458baa15fc0cfe40da7bbe18b4ccef54885d314a3f9fcb3161d3cccefb87fbccd2e12af550a2ccc49787f5306b409a0af110d703e37422c95a974f33a1b5a206aae9b1ff14c53442612c3f9db16d77f1d74c6cd3ca00af2d70b4bfdbc364d7ceb95dbfa71d6d9774471511ce48513a6e0fdc7ab1a130a2e8350f343a55026856ea13e60c2ea05d31b888f7651e5a160db09dcca2a3c42e2a1f62f0080d5ff59baa1eb041a5eedbe2ff5e73be8e58aa6c72dda2b190899b6f8acf8e16bede45aad763de455f1cbf18d766a86dfffc96d82b70da473d1abce667d42749bd1576a69e694473adc6afc9d9720bd9084bb8ed5f2c470189398efe3ea035597251d18a15779b455b39e5f6bcc21fddf5b4ea2c3debebaa7a4e622903b9f18434e04ed6621a1a2841c75b9ae0f15f5e60f40890698e4546e6fcdd8c46f30fce0294c144e830227a97a6324d0176d94d7b720249c679aa667a5d44f82b08ec043de2738c8ef2f9f60d8e71eb385c7330994ba81fb220b3c1ed6429bfa722f42134a791a42d38ea6683bc1868b9d20f4e030bf0aa8aa1afa4efce2934d82ad0741914a41e775041257004f3e67a2bf8ae48778f890b9407464f2ec04825c1c669a148d5d528bcb7ea85ce1315c4d15d5bfd9c904d92b54bcea341f78cf7956c92b384658b007c5ebcbef92bc1a8e1cc045761b21a0260320b1d192644326f255dcff21dacd95a5f56f6af9f9d1328882b5eb3b57a184181789379789b61632b9df6dec62fb7ddb53d3edaae386e188374b34e9d4c6c378bb29e"} // 错误结果 {"msg":"错误原因","status":"1"}
GET http://api.damagou.top/apiv1/jiyanRecognize.html //参数 userkey String [必填] 用户登录成功后返回的userkey gt String [必填] 极验参数gt challenge String [必填] 极验参数challenge type String [选填] 打码类型 如果验证码无法识别请将此值设置为1006(慎用,会增加积分消耗) headers String [选填] 设置请求极验接口时的 referer、user-agent等请求头信息 success int [选填] 需要此参数时 值为0 isJson String [选填] 定义返回数据格式,默认值为1,1-返回文本、2-返回json server String [选填] 如果get.php请求的域名不是api.geetest.com, 则需要填写此参数. 填写时需对参数值urlencode . server参数的值一般为"http://***/**/get.php"请求的 "http://***/**" 部分. proxy String [选填] 代理ip. 可以传入自己的代理ip.如果使用http或https代理,则传入格式为 ip:端口:账号:密码. 无需账号密码的 可以只传ip和端口, 即 ip:端口. 示例:221.230.226.215:37344:u00111:AbCDEF 如果使用socks5代理,则传入格式为 ip:端口:账号:密码:socks5. 无需账号密码的 可以只传ip和端口, 即 ip:端口:socks5. 示例:221.230.226.215:37344:u00111:AbCDEF:socks5 请务必判断success的值,设置正确的识别模式!!如果获取challenge的请求返回结果中 success为0,例如: {"success":0,"gt":"gt","challenge":"challenge"} 则需要传入success参数,如果为success 1则不用传入success参数 headers参数的格式为 headers=名字|值。如果有多个请求头,参数格式为headers=名字1$名字2$名字3|值1$值2$值3 需要对 "名字|值"或者"名字1$名字2$名字3|值1$值2$值3" 进行urlencode,即最终调用接口传入参数为: headers=urlencode("名字|值")或headers=urlencode("名字1$名字2$名字3|值1$值2$值3") 对urlencode不了解的可以网上找个urlencode工具,利用工具urlencode后,直接复制过来使用即可. //返回数据 challenge的值|validate的值 请务必提交此challenge,不要提交接口参数中的challenge //返回结果例子 // 文本格式: // 正确结果 fqwfdaw9df96c9ccfd5f7cada2bc4097121|f5358109df96c9ccfd5f7cada2bc4097 // 错误结果 错误原因 // json格式: // 正确结果 {"msg":"success","data":"fqwfdaw9df96c9ccfd5f7cada2bc4097121|f5358109df96c9ccfd5f7cada2bc4097","status":"0"} // 错误结果 {"msg":"错误原因","status":"1"} 下图为获取challenge的请求所返回数据的例子:![]()
GET http://api.damagou.top/apiv1/jiyanNoSenseRecognize.html //参数 userkey String [必填] 用户登录成功后返回的userkey gt String [必填] 极验参数gt type String [选填] 打码类型 如果验证码无法识别请将此值设置为1006 isJson String [选填] 定义返回数据格式 默认值为1, 1-返回文本、2-返回json //返回数据 challenge的值|validate的值 请务必提交此challenge,不要提交接口参数中的challenge //返回结果例子 // 文本格式: // 正确结果 fqwfdaw9df96c9ccfd5f7cada2bc4097121|f5358109df96c9ccfd5f7cada2bc4097 // 错误结果 错误原因 // json格式: // 正确结果 {"msg":"success","data":"fqwfdaw9df96c9ccfd5f7cada2bc4097121|f5358109df96c9ccfd5f7cada2bc4097","status":"0"} // 错误结果 {"msg":"错误原因","status":"1"}
GET http://api.damagou.top/apiv1/userInfo.html?userkey=xxxx //参数 userkey String [必填] 用户登录成功后返回的userkey //返回数据说明 {"msg":"success","data":{"common_score":xxx,"intelli_score":0},"status":0} status:正确数据值为0,错误数据值为1 common_score:普通型积分。 intelli_score:特殊型积分。 //返回结果例子: 正确:{"msg":"success","data":{"common_score":100060,"intelli_score":0},"status":0} 错误:{"msg":"xxx","status":1}
GET http://api.damagou.top/recaptcha/recaptchaReq.html?userkey=xxxx&type=1010&googlekey=xxx&invisible=xxx&pageurl=xxx //参数 userkey String [必填] 用户登录成功后返回的userkey type int [选填] 打码类型 值为1011 googlekey String [必填] k 参数的值 (或者 data-sitekey 的值) invisible int [选填] 0-需要一次点击验证唤出街景图片(默认),1-提交表单时直接唤出街景图片 pageurl String [必填] 验证码所在页面(浏览器地址栏)的 url isJson String [选填] 定义返回数据格式 [选填] 默认值为1, 1-返回文本、2-返回json //返回数据说明 OK|xxxx xxxx 为id,调用接口7时此值作为参数传入 //返回结果例子 // 文本格式: // 正确结果 OK|61231078765 // 错误结果 错误原因 // json格式: // 正确结果 {"msg":"success","data":"OK|61231078765","status":"0"} // 错误结果 {"msg":"错误原因","status":"1"}
GET http://api.damagou.top/recaptcha/recaptchaRes.html?id=xxxx //参数 id String [必填] 接口6返回的id值 isJson String [选填] 定义返回数据格式 默认值为1, 1-返回文本、2-返回json //返回数据说明 OK|g-recaptcha-response参数 如果返回结果为CAPCHA_NOT_READY 请在5s内重新提交此请求(5秒内重试) 直到获取正确结果。 //返回结果例子 // 文本格式: // 正确结果 OK|03AOLTBLRNJGFuSOwgEwx5rLysbtPnjrvOFv4ygGNXypahnSCGvsR_Xx_aY3xzbL-oyg-OKi43M5HBY54Qmi7si45VPWGjCJD_NIkE3e7rPz1azdtSmS5JMhL9N0ooXQn2HVZnHzSLmbizgMh89o9GZgUuanD8weKd6wCouxERAKdthgbRec7v2wbDdeMQ6HIXhYO4oyHycZ8HdDpbbnFeCHMXhS0yeDv1_283UZziKp5Ep5xlf-uzlV1fpPEdKqo1CtOz5g6k-0DqOAhrXIwCR5yW9izIqrpncWhf80zVnEdblMuc8ex1bbc0JrpNB2bq47grUgXAiD7BNY487WQBQez1tJWn9rmvKEVJirV9JFrB7TiePTlCY8U3qY2a5n7SAk_DFVav3LfK // 错误结果 错误原因 // json格式: // 正确结果 {"msg":"success","data":"OK|03AOLTBLRNJGFuSOwgEwx5rLysbtPnjrvOFv4ygGNXypahnSCGvsR_Xx_aY3xzbL-oyg-OKi43M5HBY54Qmi7si45VPWGjCJD_NIkE3e7rPz1azdtSmS5JMhL9N0ooXQn2HVZnHzSLmbizgMh89o9GZgUuanD8weKd6wCouxERAKdthgbRec7v2wbDdeMQ6HIXhYO4oyHycZ8HdDpbbnFeCHMXhS0yeDv1_283UZziKp5Ep5xlf-uzlV1fpPEdKqo1CtOz5g6k-0DqOAhrXIwCR5yW9izIqrpncWhf80zVnEdblMuc8ex1bbc0JrpNB2bq47grUgXAiD7BNY487WQBQez1tJWn9rmvKEVJirV9JFrB7TiePTlCY8U3qY2a5n7SAk_DFVav3LfK","status":"0"} // 错误结果 {"msg":"错误原因","status":"1"}