全部
在线测试

公共 API(新接口用新的生成 token 接口老的可能无效)


接口地址: http://api.vv-tool.com/api/proxy/oauth/token


接口介绍: 获取用户 access_token,请求接口的身份识别 点击查看详情


请求方式: POST


传参方式: form-data


返回格式: JSON


请求参数

参数 类型 必选 描述
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 失效)