V兔API开放平台

参数	类型	值	必选	描述
grant_type	string	client_credentials	是	照抄就行
scope	string		否	可以不传
client_id	string	23b9530c14856xxx	是	传入您自己的 Account
client_secret	string	c209580b23b9530c1485699d5c4b2xxx	是	传入您自己的 Accessskey

请求示例

grant_type： client_credentials
client_id：23b9530c14856xxx
client_secret：c209580b23b9530c1485699d5c4b2xxx

请求代码示例

cURL请求代码示例


curl --location --request POST 'http://api.vv-tool.com/api/proxy/oauth/token' \
--form 'grant_type=client_credentials' \
--form 'client_id=23b9530c14856xxx' \
--form 'client_secret=c209580b23b9530c1485699d5c4b2xxx'

PHP请求代码示例


<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => "http://api.vv-tool.com/api/proxy/oauth/token",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => array('grant_type' => 'client_credentials','client_id' => '23b9530c14856xxx','client_secret' => 'c209580b23b9530c1485699d5c4b2xxx'),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

JAVA请求代码示例


OkHttpClient client = new OkHttpClient().newBuilder()
  .build();
MediaType mediaType = MediaType.parse("text/plain");
RequestBody body = new MultipartBody.Builder().setType(MultipartBody.FORM)
  .addFormDataPart("grant_type", "client_credentials")
  .addFormDataPart("client_id", "23b9530c14856xxx")
  .addFormDataPart("client_secret", "c209580b23b9530c1485699d5c4b2xxx")
  .build();
Request request = new Request.Builder()
  .url("http://api.vv-tool.com/api/proxy/oauth/token")
  .method("POST", body)
  .build();
Response response = client.newCall(request).execute();

响应参数

参数	类型	描述
access_token	string	您获取到的 access_token
expires_in	int	有效时间，单位秒
token_type	string	令牌类型
scope	string	权限

如何使用

请求头中加入 Authorization:Bearer 5d34d5197d131ae0dae4a63d219516b1xxxxxxxx // Bearer 空格再连接上上一步获取的 access_token

使用上一步获得的 access_token 获取用户余额


<?php

$request = new HttpRequest();
$request->setUrl('http://api.vv-tool.com/tool/accounts/get-user-balance');
$request->setMethod(HTTP_METH_GET);

$request->setHeaders(array(
  'cache-control' => 'no-cache',
  'Connection' => 'keep-alive',
  'Accept-Encoding' => 'gzip, deflate',
  'Host' => 'api.vv-tool.com',
  'Cache-Control' => 'no-cache',
  'Accept' => '*/*',
  'Authorization' => 'Bearer 5d34d5197d131ae0dae4a63d219516b1xxxxxxxx'
));

try {
  $response = $request->send();

  echo $response->getBody();
} catch (HttpException $ex) {
  echo $ex;
}

公共错误码

代码	代码描述	解决方案
0	成功
100	请求参数错误	检查您的请求参数是否正确
101	请求超时，请重试	检查您的网络情况或者联系客服解决
200	系统错误，请联系客服	检查您的接口地址填写是否正确，其他问题联系客服解决
202	系统错误，请稍后再试	稍后重试，或者联系对接群
203	暂不支持当前接口
204	请求异常：无该接口权限，请前往官网开通正式接口。	前往官网开通该接口权限
204	请求异常：API 调用次数不足，请前往网站兑换次数。	前往官网充值该接口调用次数
204	免费次数或点券余额不足，请充值	充值点券后再来
401	身份凭证无效	在请求头中添加 access_token，重新更新 token
404	请求路径或请求方式错误	请更换请求方式或者检查路径是否正确
1001	ip 禁止访问	联系运营将 ip 加入白名单
1010	超频	token 一直有效，不可以更换 token 较频繁（新的 token 会导致老 token 失效）