接口参数 若无特殊说明,接口参数同时支持GET和POST传递;推荐:查询/删除用GET,创建/更新用POST。
参数名字 | 参数类型 | 是否必须 | 默认值 | 备注 | 参数说明 |
---|---|---|---|---|---|
app_key | 字符串 | 必须 | 最小:32 | 公共参数 开发者应用的app_key,查看我的app_key,如果还没有,可免费注册开通。 | |
sign | 字符串 | 可选 | 公共参数接口签名,其中: | ||
uuid | 字符串 | 可选 | 公共参数 UUID,当前登录的应用会员ID,即全局唯一用户ID,查看我的应用会员。传递此参数后,可以在开放平台查看每日活跃会员统计图表。uuid需要和token一起传递。 | ||
token | 字符串 | 可选 | 公共参数 当前登录会员的会话凭证,可通过会员登录接口获得。uuid需要和token一起传递。 | ||
return_data | 字符串 | 可选 | 0 | 公共参数 数据返回结构,其中:
|
在线测试
参数 | 是否必填 | 值 |
---|---|---|
s | 固定 | |
uuid | 可选 | |
token | 可选 | |
return_data | 可选 |
客户端请求示例
查看我的接口域名、app_key和app_secrect 客户端接入指南(如何生成签名) 开启/关闭签名
{
"ret": 200,
"data": {
"rates": {
"USD": 0.14085,
"AED": 0.5169,
"ARS": 9.07183,
"AUD": 0.22958,
"BGN": 0.2507,
"BRL": 0.73099,
"BSD": 0.14085,
"CAD": 0.2,
"CHF": 0.13577,
"CLP": 120.1169,
"CNY": 1,
"COP": 567.60563,
"CZK": 3.50563,
"DKK": 0.95775,
"DOP": 7.56338,
"EGP": 2.21408,
"EUR": 0.12817,
"FJD": 0.32113,
"GBP": 0.1138,
"GTQ": 1.08592,
"HKD": 1.09155,
"HRK": 0.97887,
"HUF": 46.12817,
"IDR": 2312.60563,
"ILS": 0.50141,
"INR": 10.64085,
"ISK": 19.94507,
"JPY": 15.23099,
"KRW": 172.28592,
"KZT": 63.06761,
"MXN": 3.36338,
"MYR": 0.60845,
"NOK": 1.47746,
"NZD": 0.23662,
"PAB": 0.14085,
"PEN": 0.48451,
"PHP": 7.17887,
"PKR": 23.23521,
"PLN": 0.5831,
"PYG": 916.90141,
"RON": 0.61972,
"RUB": 11.07887,
"SAR": 0.52958,
"SEK": 1.41268,
"SGD": 0.20141,
"THB": 4.61408,
"TRY": 0.92817,
"TWD": 4.26197,
"UAH": 3.9,
"UYU": 6.14085,
"ZAR": 2.52113
},
"err_code": 0,
"err_msg": ""
},
"msg": "V2.1.0 果创云开放接口 App.Currency.ExchnageRate"
}
货币代码 代币名称 国家
AED UAE Dirham United Arab Emirates
ARS Argentine Peso Argentina
AUD Australian Dollar Australia
BGN Bulgarian Lev Bulgaria
BRL Brazilian Real Brazil
BSD Bahamian Dollar Bahamas
CAD Canadian Dollar Canada
CHF Swiss Franc Switzerland
CLP Chilean Peso Chile
CNY 人民币 中国
COP Colombian Peso Colombia
CZK Czech Koruna Czech Republic
DKK Danish Krone Denmark
DOP Dominican Peso Dominican Republic
EGP Egyptian Pound Egypt
EUR Euro Germany
EUR Euro Austria
EUR Euro Belgium
EUR Euro Cyprus
EUR Euro Estonia
EUR Euro Finland
EUR Euro France
EUR Euro Greece
EUR Euro Ireland
EUR Euro Italy
EUR Euro Latvia
EUR Euro Lithuania
EUR Euro Luxembourg
EUR Euro Malta
EUR Euro Netherlands
EUR Euro Portugal
EUR Euro Slovakia
EUR Euro Slovenia
EUR Euro Spain
FJD Fiji Dollar Fiji
GBP Pound Sterling United Kingdom
GTQ Guatemalan Quetzal Guatemala
HKD 港币 中国香港
HRK Croatian Kuna Croatia
HUF Hungarian Forint Hungary
IDR Indonesian Rupiah Indonesia
ILS Israeli New Shekel Israel
INR Indian Rupee India
ISK Icelandic Krona Iceland
JPY 日元 日本
KRW South Korean Won 韩国
KZT Kazakhstani Tenge Kazakhstan
MXN Mexican Peso Mexico
MYR Malaysian Ringgit Malaysia
NOK Norwegian Krone Norway
NZD New Zealand Dollar New Zealand
PAB Panamanian Balboa Panama
PEN Peruvian Sol Peru
PHP Philippine Peso Philippines
PKR Pakistani Rupee Pakistan
PLN Polish Zloty Poland
PYG Paraguayan Guarani Paraguay
RON Romanian Leu Romania
RUB Russian Ruble Russia
SAR Saudi Riyal Saudi Arabia
SEK Swedish Krona Sweden
SGD Singapore Dollar 新加坡
THB 泰铢 泰国
TRY Turkish Lira Turkey
TWD New Taiwan Dollar Taiwan
UAH Ukrainian Hryvnia Ukraine
USD 美元 美国
UYU Uruguayan Peso Uruguay
ZAR South African Rand South Africa
接口使用帮助说明
接口返回及数据结构
返回字段 | 类型 | 说明 |
---|---|---|
ret | 整型 | 接口状态码,200表示成功,4xx表示客户端非法请求,5xx表示服务端异常,查看异常错误码 |
data | object/array/混合 | 接口返回的业务数据,由不同的API接口决定不同的数据返回字段和结构。当return_data=1时,接口只会返回此data字段。 |
msg | 字符串 | 提示信息,面向技术人员的帮助或错误提示信息 |
_t | 整数 | 服务器当时Unix时间戳,例如:1657513450 |
_auth | 字符串 | 反向数字签名,可用于客户端进行反向验证,防止数据篡改,例如:9bcd54ff53e71a1d80d37c52bdfabf76。验证算法:_auth = md5(data返回的JSON字符串 + _t当前时间戳字符串 + APP_SECRECT密钥字符串) |
ret异常错误码
错误码 | 错误类型 | 错误描述信息 | 解决方法 |
---|---|---|---|
ret = 200 | 成功 | 请求成功 | |
ret = 400 | 客户端非法请求 | 表示客户端参数错误 | 1、根据接口文档的接口参数,提供正确的参数 |
ret = 404 | 客户端非法请求 | 表示接口服务不存在 | 1、查看小白接口大全,确保接口服务名称拼写正确 |
ret = 500 | 小白接口异常 | 表示服务端内部错误 | 1、进入QQ交流群897815708,反馈问题;2、或者提交工单,一天内回复 |
常见问题FAQ
Q1 问:出现 414 Request-URI Too Large 时怎么解决?答:对于全部参数,改用POST方式传递,并且从GET链接里面去掉。
Q2 问:浏览器请求和在线测试接口正常,但本地程序无法正常获取接口结果。答:需要注意UTF编码,以及存在中文和特殊字符时的URL编码。GET请求参数应统一进行URL编码后再请求,POST表单数据正常传递即可。
Q3 问:请求接口时提示JSON格式错误。答:请先阅读,然后检测本地传递的参数是否符合JSON格式,使用JSON在线工具辅助检测,注意双引号和特殊符号。确认无误后再重新请求API接口。
Q4 问:出现 405 不允许跨域请求 时怎么办?答:可以追加GET参数 &yesapi_allow_origin=1
,或参考用反向代理解决跨域问题等3种解决方案。
Q4 问:在wx内无法访问yesapi.cn或okayapi.com域名,怎么办?答:由于曾经短链跳转使用被wx误封域名,可以帮忙进行申诉。申诉后截图联系我们,获取15万次接口流量奖励。