0 | ok | 正常 | 服务请求正常召回 |
1 | 服务器内部错误 | 该服务响应超时或系统内部错误,请留下凯发k8官方旗舰厅的联系方式 | |
2 | parameter invalid | 请求参数非法 | 必要参数拼写错误或漏传(如query和tag请求中均未传入) |
3 | verify failure | 权限校验失败 | |
4 | quota failure | 配额校验失败 | 服务当日调用次数已超限,请前往提升(请优先进行) |
5 | ak failure | ak不存在或者非法 | 未传入ak参数;ak已被删除(可前往恢复); |
8 | parse proto failure | 数据解析失败 | 一般是query输入有误导致,如query输入特殊字符,全角符号。 |
9 | permission denied | 高级权限校验失败 | |
101 | ak参数不存在 | 请求消息没有携带ak参数 | |
200 | app不存在,ak有误请检查再重试 | 根据请求的ak,找不到对应的app | |
201 | app被用户自己禁用,请在控制台解禁 | ||
202 | app被管理员删除 | 恶意app被管理员删除 | |
203 | app类型错误 | 当前api控制台支持server(类型1), mobile(类型2, 新版控制台区分为mobile_android(类型21)及mobile_iphone(类型22))及browser(类型3),除此之外其他类型认为是app类型错误 | |
210 | app ip校验失败 | 在申请server类型应用的时候选择ip校验,需要填写ip白名单,如果当前请求的ip地址不在ip白名单或者不是0.0.0.0/0就认为ip校验失败 | |
211 | app sn校验失败 | server类型app有两种校验方式ip校验和sn校验,当用户请求的sn和服务端计算出来的sn不相等的时候提示sn校验失败 | |
240 | app 服务被禁用 | 用户在api控制台中创建或设置某app的时候禁用了某项服务,若需开通权限,可进入为ak勾选对应服务 | |
250 | 用户不存在 | 根据请求的user_id, 数据库中找不到该用户的信息,请携带正确的user_id | |
251 | 用户被自己删除 | 该用户处于未激活状态 | |
252 | 用户被管理员删除 | 恶意用户被加入黑名单 | |
260 | 服务不存在 | 服务器解析不到用户请求的服务名称 | |
261 | 服务被禁用 | 该服务已下线 | |
302 | 天配额超限,限制访问 | 配额超限,如果想增加配额请 | |
401 | 当前并发量已经超过约定并发配额,限制访问 | 并发控制超限,请控制并发量或 |
api请求中需要用到中文或一些特殊字符的参数,如query、region等,为了避免提交到后台乱码,需要对这几个参数值进行编码处理,转换成utf-8字符的二字符十六进制值,凡是不在下表中的字符都需要进行编码。
字符集合 | 字符 |
---|---|
url非保留字 | a b c d e f g h i j k l m n o p q r s t u v w x y z a b c d e f g h i j k l m n o p q r s t u v w x y z 0 1 2 3 4 5 6 7 8 9 - _ . ~ |
url保留字 | ! * ' ( ) ; : @ & = $ , / ? % # [ ] |
如果中文参数中使用url保留字字符的字面意思,例如:region关键字取值为"?北京",检索关键字包含一个问号,此问号也必须进行编码。
javascript中一般采用encodeuricomponent函数对特殊字符进行编码。
java中可以使用函数urlencoder.encode对特殊字符进行编码。
c#中可以使用函数httputility.urlencode对特殊字符进行编码。
php中可以使用函数urlencode对特殊字符进行编码。
假设ak=yourak(yourak为一个字符串),
在 中配置了该ak的验证方式是sn签名的验证方式,点击下面那排星号,显示security key,可以看到此ak对应的sk私钥,假设sk=yoursk。
请求的url是:
package test;import java.io.unsupportedencodingexception;import java.net.urlencoder;import java.security.nosuchalgorithmexception;import java.util.linkedhashmap;import java.util.map;import java.util.map.entry;//java版计算signature签名publicclasssncal{publicstaticvoidmain(string[] args) throws unsupportedencodingexception,nosuchalgorithmexception{sncal sncal =newsncal();// 计算sn跟参数对出现顺序有关,get请求请使用linkedhashmap保存,该方法根据key的插入顺序排序;post请使用treemap保存 ,该方法会自动将key按照字母a-z顺序排序。所以get请求可自定义参数顺序(sn参数必须在最后)发送请求,但是post请求必须按照字母a-z顺序填充body(sn参数必须在最后)。以get请求为例:https://api.map.baidu.com/geocoder/v2/?address=百度大厦&output=json&ak=yourak,paramsmap中先放入address,再放output,然后放ak,放入顺序必须跟get请求中对应参数的出现顺序保持一致。 map paramsmap =newlinkedhashmap<string,string>();paramsmap.put("address","百度大厦");paramsmap.put("output","json");paramsmap.put("ak","yourak");// 调用下面的toquerystring方法,对linkedhashmap内所有value作utf8编码,拼接返回结果address=百度大厦&output=json&ak=yourakstring paramsstr = sncal.toquerystring(paramsmap);// 对paramsstr前面拼接上/geocoder/v2/?,后面直接拼接yoursk得到/geocoder/v2/?address=百度大厦&output=json&ak=yourakyourskstring wholestr =newstring("/geocoder/v2/?" paramsstr "yoursk");// 对上面wholestr再作utf8编码string tempstr =urlencoder.encode(wholestr,"utf-8");// 调用下面的md5方法得到最后的sn签名7de5a22212ffaa9e326444c75a58f9a0system.out.println(sncal.md5(tempstr));}// 对map内所有value作utf8编码,拼接返回结果publicstringtoquerystring(map<?,?> data)throws unsupportedencodingexception{stringbuffer querystring =newstringbuffer();for(entry<?,?> pair : data.entryset()){querystring.append(pair.getkey()"=");querystring.append(urlencoder.encode((string) pair.getvalue(),"utf-8")"&");}if(querystring.length()>0){querystring.deletecharat(querystring.length()-1);}return querystring.tostring();}// 来自stackoverflow的md5计算方法,调用了messagedigest库函数,并把byte数组结果转换成16进制publicstringmd5(string md5){try{java.security.messagedigest md = java.security.messagedigest.getinstance("md5");byte[] array = md.digest(md5.getbytes());stringbuffer sb =newstringbuffer();for(int i =0; i < array.length;i){sb.append(integer.tohexstring((array[i]&0xff)|0x100).substring(1,3));}return sb.tostring();}catch(java.security.nosuchalgorithmexception e){}returnnull;}}
本篇文章对您是否有帮助?