OpenAPI学习

最新推荐文章于 2024-08-07 02:32:48 发布
最新推荐文章于 2024-08-07 02:32:48 发布
阅读量4.1k 收藏 2
点赞数

QQ开放平台代码示例

 

腾讯开放平台

http://open.qq.com/tools?act=openapi_debug

 

测试类：

TestOpenApiV3

 

package demo;

import java.util.*;
import com.qq.open.OpenApiV3;
import com.qq.open.ErrorCode;
import com.qq.open.OpensnsException;

/**
 * OpenAPI V3 SDK 示例代码
 *
 * @version 3.0.0
 * @since jdk1.5
 * @author open.qq.com
 * @copyright © 2012, Tencent Corporation. All rights reserved.
 * @History:
 *               3.0.0 | nemozhang | 2012-03-21 12:01:05 | initialization
 *
 */
 
public class TestOpenApiV3
{
    public static void main(String args[])
    {
        // 应用基本信息
        String appid = "1101765412";
        String appkey = "ed4GFNj3nqLjNJF8";

        // 用户的OpenID/OpenKey
        String openid = "9B754E88EBEA9E906D6F496FCEBB4F76";
        String openkey = "40CA7FAA1DF69E87B28AB5798BFC45B6";
        
        //oauth_consumer_key=100330589&access_token=F9F6F34B8C5763E82A018F0208139913&openid=D8A612468696091AFB5C17F494FE456E&format=json
        // OpenAPI的服务器IP 
        // 最新的API服务器地址请参考wiki文档: http://wiki.open.qq.com/wiki/API3.0%E6%96%87%E6%A1%A3 
        String serverName = "119.147.19.43";

        // 所要访问的平台, pf的其他取值参考wiki文档: http://wiki.open.qq.com/wiki/API3.0%E6%96%87%E6%A1%A3
        String pf = "qzone";

        OpenApiV3 sdk = new OpenApiV3(appid, appkey);
        sdk.setServerName(serverName);

        System.out.println("===========test GetUserInfo===========");
        testGetUserInfo(sdk, openid, openkey, pf);
    }

    /**
     * 测试调用UserInfo接口
     *
     */
    public static void testGetUserInfo(OpenApiV3 sdk, String openid, String openkey, String pf)
    {
        // 指定OpenApi Cgi名字 
        String scriptName = "/v3/user/get_info";

        // 指定HTTP请求协议类型
        String protocol = "http";

        // 填充URL请求参数
        HashMap<String,String> params = new HashMap<String, String>();
        params.put("openid", openid);
        params.put("openkey", openkey);
        params.put("pf", pf);

        try
        {
            String resp = sdk.api(scriptName, params, protocol);
            System.out.println(resp);
        }
        catch (OpensnsException e)
        {
            System.out.printf("Request Failed. code:%d, msg:%s\n", e.getErrorCode(), e.getMessage());
            e.printStackTrace();
        }
    }
}


OpenApiV3

package com.qq.open;

import java.util.*;
import java.net.URLEncoder;
import java.io.UnsupportedEncodingException;
import java.net.*;
import com.qq.open.SnsNetwork;
import com.qq.open.SnsSigCheck;
import com.qq.open.SnsStat;
import org.json.JSONObject;
import org.json.JSONException;
import org.apache.commons.httpclient.methods.multipart.FilePart;
 /**
 * 提供访问腾讯开放平台 OpenApiV3 的接口
 *
 * @version 3.0.2
 * @since jdk1.5
 * @author open.qq.com
 * @copyright © 2012, Tencent Corporation. All rights reserved.
 * @History:
 *				 3.0.3 | coolinchen| 2012-11-07 11:20:12 | support POST request in  "multipart/form-data" format
 *               3.0.2 | coolinchen| 2012-10-08 11:20:12 | support printing request string and result
 *				 3.0.1 | nemozhang | 2012-08-28 16:40:20 | support cpay callback sig verifictaion
 *               3.0.0 | nemozhang | 2012-03-21 12:01:05 | initialization
 *
 */
 
public class OpenApiV3
{

    /**
     * 构造函数
     *
     * @param appid 应用的ID
     * @param appkey 应用的密钥
     */
    public OpenApiV3(String appid, String appkey)
    {
        this.appid = appid;
        this.appkey = appkey;

    }
    
    /**
     * 设置OpenApi服务器的地址
     *
     * @param serverName OpenApi服务器的地址
     */
    public void setServerName(String serverName)
    {
        this.serverName = serverName;
    }

    /**
     * 执行API调用
     * 
     * @param scriptName OpenApi CGI名字 ,如/v3/user/get_info
     * @param params OpenApi的参数列表
     * @param protocol HTTP请求协议 "http" / "https"
     * @return 返回服务器响应内容
     */
    public String api(String scriptName, HashMap<String, String> params, String protocol) throws OpensnsException
    {
        // 检查openid openkey等参数
        if (params.get("openid") == null)
        {
            throw new OpensnsException(ErrorCode.PARAMETER_EMPTY, "openid is empty");
        }

        if (!isOpenid(params.get("openid")))
        {
            throw new OpensnsException(ErrorCode.PARAMETER_INVALID, "openid is invalid");
        }

        // 无需传sig,会自动生成
        params.remove("sig");

        // 添加固定参数
        params.put("appid", this.appid);

        // 请求方法
        String method = "post";
        
        // 签名密钥
        String secret = this.appkey + "&";
        
        // 计算签名
        String sig = SnsSigCheck.makeSig(method, scriptName, params, secret);
        
        params.put("sig", sig);

        StringBuilder sb = new StringBuilder(64);
        sb.append(protocol).append("://").append(this.serverName).append(scriptName);
        String url = sb.toString(); 

        // cookie
        HashMap<String, String> cookies = null;

        long startTime = System.currentTimeMillis();
		
		//通过调用以下方法，可以打印出最终发送到openapi服务器的请求参数以及url，默认注释
		//printRequest(url,method,params);
		
        // 发送请求
        String resp = SnsNetwork.postRequest(url, params, cookies, protocol);

        // 解码JSON
        JSONObject jo = null;
        try 
        {
            jo = new JSONObject(resp);
        } 
        catch (JSONException e) 
        {
            throw new OpensnsException(ErrorCode.RESPONSE_DATA_INVALID, e); 
        } 

        // 检测ret值
        int rc = jo.optInt("ret", 0);

        // 统计上报
        SnsStat.statReport(startTime, serverName, params, method, protocol, rc,scriptName);

		
		//通过调用以下方法，可以打印出调用openapi请求的返回码以及错误信息，默认注释
		//printRespond(resp);
		
        return resp;
    }
	
	
	/**
     * 执行API调用
     * 
     * @param scriptName OpenApi CGI名字 ,如/v3/user/get_info
     * @param params OpenApi的参数列表
	 * @param fp 上传的文件 
     * @param protocol HTTP请求协议 "http" / "https"
     * @return 返回服务器响应内容
     */
    public String apiUploadFile(String scriptName, HashMap<String, String> params, FilePart fp,String protocol) throws OpensnsException
    {
        // 检查openid openkey等参数
        if (params.get("openid") == null)
        {
            throw new OpensnsException(ErrorCode.PARAMETER_EMPTY, "openid is empty");
        }
        if (!isOpenid(params.get("openid")))
        {
            throw new OpensnsException(ErrorCode.PARAMETER_INVALID, "openid is invalid");
        }

        // 无需传sig,会自动生成
        params.remove("sig");

        // 添加固定参数
        params.put("appid", this.appid);

        // 请求方法
        String method = "post";
        
        // 签名密钥
        String secret = this.appkey + "&";
        
        // 计算签名
        String sig = SnsSigCheck.makeSig(method, scriptName, params, secret);
        
        params.put("sig", sig);

        StringBuilder sb = new StringBuilder(64);
        sb.append(protocol).append("://").append(this.serverName).append(scriptName);
        String url = sb.toString(); 

        // cookie
        HashMap<String, String> cookies = null;

        long startTime = System.currentTimeMillis();
		
		//通过调用以下方法，可以打印出最终发送到openapi服务器的请求参数以及url，默认注释
		//printRequest(url,method,params);
		
        // 发送请求
        String resp = SnsNetwork.postRequestWithFile(url, params, cookies, fp,protocol);

        // 解码JSON
        JSONObject jo = null;
        try 
        {
            jo = new JSONObject(resp);
        } 
        catch (JSONException e) 
        {
            throw new OpensnsException(ErrorCode.RESPONSE_DATA_INVALID, e); 
        } 

        // 检测ret值
        int rc = jo.optInt("ret", 0);

        // 统计上报
        SnsStat.statReport(startTime, serverName, params, method, protocol, rc,scriptName);

		
		//通过调用以下方法，可以打印出调用openapi请求的返回码以及错误信息，默认注释
		//printRespond(resp);
		
        return resp;
    }

	
	/**
     * 辅助函数，打印出完整的请求串内容
     * 
     * @param url 请求cgi的url
     * @param method 请求的方式 get/post
     * @param params OpenApi的参数列表
     */
	private void printRequest(String url,String method,HashMap<String, String> params) throws OpensnsException
	{
		System.out.println("==========Request Info==========\n");
		System.out.println("method:  " + method);
		System.out.println("url:  " + url);
		System.out.println("params:");
		System.out.println(params);
		System.out.println("querystring:");
		StringBuilder buffer = new StringBuilder(128);
		Iterator iter = params.entrySet().iterator();
		while (iter.hasNext())
		{
			Map.Entry entry = (Map.Entry) iter.next(); 
			try
			{	
				buffer.append(URLEncoder.encode((String)entry.getKey(), "UTF-8").replace("+", "%20").replace("*", "%2A")).append("=").append(URLEncoder.encode((String)entry.getValue(), "UTF-8").replace("+", "%20").replace("*", "%2A")).append("&");
			}
			catch(UnsupportedEncodingException e)
			{
				throw new OpensnsException(ErrorCode.MAKE_SIGNATURE_ERROR, e);
			}
		}
		String tmp = buffer.toString();
		tmp = tmp.substring(0,tmp.length()-1);
		System.out.println(tmp);
		System.out.println();
	}
	
	/**
     * 辅助函数，打印出完整的执行的返回信息
     * 
     * @return 返回服务器响应内容
     */
	private void printRespond(String resp)
	{
		System.out.println("===========Respond Info============");
		System.out.println(resp);
	}
	
    /**
     * 验证openid是否合法
     */
    private boolean isOpenid(String openid)
    {
        return (openid.length()==32) && openid.matches("^[0-9A-Fa-f]+$");
    }
    
    private String appid;;
    private String appkey;
    private String serverName;
}


SnsNetwork：发送HTTP网络请求类

package com.qq.open;

import java.util.*;

import java.io.FileOutputStream;
import java.io.IOException;
import java.io.InputStream;
import java.io.UnsupportedEncodingException;

import java.net.*;
import java.net.URI;
import java.net.URISyntaxException;

import org.apache.commons.httpclient.*;
import org.apache.commons.httpclient.methods.GetMethod;
import org.apache.commons.httpclient.methods.PostMethod;
import org.apache.commons.httpclient.params.HttpMethodParams;
import org.apache.commons.httpclient.protocol.Protocol;
import org.apache.commons.httpclient.cookie.CookiePolicy;

import org.apache.commons.httpclient.methods.multipart.FilePart;
import org.apache.commons.httpclient.methods.MultipartPostMethod;
import org.apache.commons.httpclient.methods.multipart.StringPart;

import com.qq.open.OpensnsException;
import com.qq.open.ErrorCode;
import com.qq.open.https.MySecureProtocolSocketFactory;


 /**
 * 发送HTTP网络请求类
 *
 * @version 3.0.0
 * @since jdk1.5
 * @author open.qq.com
 * @copyright © 2012, Tencent Corporation. All rights reserved.
 * @History:
 *			 	 3.0.1 | coolinchen| 2012-11-07 11:20:12 | support POST request in  "multipart/form-data" format
 *               3.0.0 | nemozhang | 2012-03-21 12:01:05 | initialization
 *
 */
 
 
public class SnsNetwork
{

    /** 
     * 发送POST请求
     * 
     * @param url 请求URL地址 
     * @param params 请求参数 
     * @param protocol 请求协议 "http" / "https"
     * @return 服务器响应的请求结果
     * @throws OpensnsException 网络故障时抛出异常。
     */
    public static String postRequest(
            String url, 
            HashMap<String, String> params, 
            HashMap<String, String> cookies, 
            String protocol) throws OpensnsException
    {
        if (protocol.equalsIgnoreCase("https"))
        {
            Protocol httpsProtocol = new Protocol("https",
                new MySecureProtocolSocketFactory(), 443);
            Protocol.registerProtocol("https", httpsProtocol);
        }

        HttpClient httpClient = new HttpClient();
        PostMethod postMethod = new PostMethod(url);


        // 设置请求参数
        if (params != null && !params.isEmpty())
        {
            NameValuePair[] data = new NameValuePair[params.size()];

            Iterator iter = params.entrySet().iterator(); 
            int i=0;
            while (iter.hasNext()) 
            { 
                Map.Entry entry = (Map.Entry) iter.next(); 
                data[i] = new NameValuePair((String)entry.getKey(), (String)entry.getValue());
                ++i;
            } 
			
            postMethod.setRequestBody(data);
        }

        // 设置cookie
        if (cookies !=null && !cookies.isEmpty())
        {
            Iterator iter = cookies.entrySet().iterator();
            StringBuilder buffer = new StringBuilder(128);
            while (iter.hasNext())
            {
                Map.Entry entry = (Map.Entry) iter.next(); 
                buffer.append((String)entry.getKey()).append("=").append((String)entry.getValue()).append("; ");
            }
            // 设置cookie策略
            postMethod.getParams().setCookiePolicy(CookiePolicy.IGNORE_COOKIES);
            
            // 设置cookie内容
            postMethod.setRequestHeader("Cookie", buffer.toString());
        }

        // 设置User-Agent
        postMethod.setRequestHeader("User-Agent", "Java OpenApiV3 SDK Client");

        // 设置建立连接超时时间
        httpClient.getHttpConnectionManager().getParams().setConnectionTimeout(CONNECTION_TIMEOUT);

        // 设置读数据超时时间
        httpClient.getHttpConnectionManager().getParams().setSoTimeout(READ_DATA_TIMEOUT);

        // 设置编码
        postMethod.getParams().setParameter(HttpMethodParams.HTTP_CONTENT_CHARSET,
                CONTENT_CHARSET); 

        //使用系统提供的默认的恢复策略
        postMethod.getParams().setParameter(HttpMethodParams.RETRY_HANDLER,
                new DefaultHttpMethodRetryHandler());

        try 
        {
            try
            {
                int statusCode = httpClient.executeMethod(postMethod);
    
                if (statusCode != HttpStatus.SC_OK) 
                {
                    throw new OpensnsException(ErrorCode.NETWORK_ERROR, "Request [" + url + "] failed:" + postMethod.getStatusLine());
                }
    
                //读取内容 
                byte[] responseBody = postMethod.getResponseBody();
    
                return new String(responseBody, CONTENT_CHARSET);
            }
            finally
            {
                //释放链接
                postMethod.releaseConnection();
            }
        } 
        catch (HttpException e) 
        {
            //发生致命的异常，可能是协议不对或者返回的内容有问题
            throw new OpensnsException(ErrorCode.NETWORK_ERROR, "Request [" + url + "] failed:" +  e.getMessage());
        } 
        catch (IOException e) 
        {
            //发生网络异常
            throw new OpensnsException(ErrorCode.NETWORK_ERROR, "Request [" + url + "] failed:" +  e.getMessage());
        } 
    }
	
	
	/** 
     * 发送POST请求
     * 
     * @param url 请求URL地址 
     * @param params 请求参数 
     * @param protocol 请求协议 "http" / "https"
	 * @param fp 上传的文件 
     * @return 服务器响应的请求结果
     * @throws OpensnsException 网络故障时抛出异常。
     */
    public static String postRequestWithFile(
            String url, 
            HashMap<String, String> params, 
            HashMap<String, String> cookies, 
			FilePart fp,
            String protocol) throws OpensnsException 
    {
        if (protocol.equalsIgnoreCase("https"))
        {
            Protocol httpsProtocol = new Protocol("https",
                new MySecureProtocolSocketFactory(), 443);
            Protocol.registerProtocol("https", httpsProtocol);
        }

        HttpClient httpClient = new HttpClient();
		//上传文件要使用MultipartPostMethod类
        MultipartPostMethod postMethod = new MultipartPostMethod(url);
		
		//将FilePart类型的文件加到参数里
		postMethod.addPart(fp);
		
        // 设置请求参数
        if (params != null && !params.isEmpty())
        {
            Iterator iter = params.entrySet().iterator(); 
            while (iter.hasNext()) 
            { 
                Map.Entry entry = (Map.Entry) iter.next();
				//设置参数为UTF-8编码集，解决中文乱码问题，并且将参数加到post中
				postMethod.addPart(new StringPart((String)entry.getKey(), (String)entry.getValue(), CONTENT_CHARSET));
            } 
        }
		
        // 设置cookie
        if (cookies !=null && !cookies.isEmpty())
        {
            Iterator iter = cookies.entrySet().iterator();
            StringBuilder buffer = new StringBuilder(128);
            while (iter.hasNext())
            {
                Map.Entry entry = (Map.Entry) iter.next(); 
                buffer.append((String)entry.getKey()).append("=").append((String)entry.getValue()).append("; ");
            }
            // 设置cookie策略
            postMethod.getParams().setCookiePolicy(CookiePolicy.IGNORE_COOKIES);
            // 设置cookie内容
            postMethod.setRequestHeader("Cookie", buffer.toString());
        }

        // 设置User-Agent
		postMethod.setRequestHeader("User-Agent", "Java OpenApiV3 SDK Client");

        // 设置建立连接超时时间
        httpClient.getHttpConnectionManager().getParams().setConnectionTimeout(CONNECTION_TIMEOUT);

        // 设置读数据超时时间
        httpClient.getHttpConnectionManager().getParams().setSoTimeout(READ_DATA_TIMEOUT);

        //使用系统提供的默认的恢复策略
		postMethod.getParams().setParameter(HttpMethodParams.RETRY_HANDLER, new DefaultHttpMethodRetryHandler());
		
		//发送请求
        try 
        {
            try
            {	
				postMethod.getParams().setContentCharset("UTF-8");   
                int statusCode = httpClient.executeMethod(postMethod);
    
                if (statusCode != HttpStatus.SC_OK) 
                {
                    throw new OpensnsException(ErrorCode.NETWORK_ERROR, "Request [" + url + "] failed:" + postMethod.getStatusLine());
                }
    
                //读取内容 
                byte[] responseBody = postMethod.getResponseBody();
    
                return new String(responseBody, CONTENT_CHARSET);
            }
            finally
            {
                //释放链接
                postMethod.releaseConnection();
            }
        } 
        catch (HttpException e) 
        {
            //发生致命的异常，可能是协议不对或者返回的内容有问题
            throw new OpensnsException(ErrorCode.NETWORK_ERROR, "Request [" + url + "] failed:" +  e.getMessage());
        } 
        catch (IOException e) 
        {
            //发生网络异常
            throw new OpensnsException(ErrorCode.NETWORK_ERROR, "Request [" + url + "] failed:" +  e.getMessage());
        } 
    }
    
    // 编码方式
    private static final String CONTENT_CHARSET = "UTF-8";

    // 连接超时时间
    private static final int CONNECTION_TIMEOUT = 3000;

    // 读数据超时时间
    private static final int READ_DATA_TIMEOUT = 3000;
}


 

这里示例的是如下接口：

 

v3/user/get_info

 

接口调用说明

 

2.1 URL

http://[域名]/v3/user/get_info 

正式环境域名或测试环境IP详见：API3.0文档#请求URL说明。

2.2 格式

json

2.3 HTTP请求方式

GET, POST

2.4 IP限制

TRUE

2.5 输入参数说明

各个参数请进行URL 编码，编码时请遵守 RFC 1738

（1）公共参数

公共参数说明



 

参数名称 是否必须 类型 描述
openid 必须 string 与APP通信的用户key。从平台跳转到应用时会调用应用的CanvasURL，平台会在CanvasURL后带上本参数。由平台直接传给应用，应用原样传给平台即可。

根据APPID以及QQ号码生成，即不同的appid下，同一个QQ号生成的OpenID是不一样的。
注：
（1）如果不知道如何解析CanvasURL以获取OpenID和Openkey，点击这里；
（2）如果解析CanvasURL时获取不到OpenID和Openkey等参数，点击这里。

openkey 必须 string session key。从平台跳转到应用时会调用应用的CanvasURL，平台会在CanvasURL后带上本参数。由平台直接传给应用，应用原样传给平台即可。

注：
（1）如果不知道如何解析CanvasURL以获取OpenID和Openkey，点击这里；
（2）如果解析CanvasURL时获取不到OpenID和Openkey等参数，点击这里；
（3）注意同一个用户如果在不同时间打开多个应用页面，页面返回的openkey是不一样的，这些openkey在各自的页面都可用。但是不要在当前页面使用另1个页面的openkey，否则会出错；
（4）Openkey长度为不固定的字符串，不能为空。建议开发者不要检查openkey的长度，也不要在后台存储openkey，否则可能会导致用户无法登录;
（5）openkey过期时间为两小时，需要用v3/user/is_login接口续期。

appid 必须 unsigned int 应用的唯一ID。可以通过appid查找APP基本信息。

sig 必须 string 请求串的签名，以appkey作为密钥，具体签名算法见腾讯开放平台第三方应用签名参数sig的说明。

pf 必须 string 应用的来源平台。从平台跳转到应用时会调用应用的CanvasURL，平台会在CanvasURL后带上本参数。由平台直接传给应用，应用原样传给平台即可。

注：
（1）由平台直接传给应用，应用原样传给平台即可。请不要应用手动构造pf值，也不需要对平台传递的pf进行有效性校验，以避免应用上线多平台时需要付出额外的修改成本，导致调用某些接口时由于参数需要根据pf值生成导致传入参数不合法。
（2）如果不知道如何解析CanvasURL以获取pf，点击这里；
（3）如果解析CanvasURL时获取不到pf，点击这里；
（4）建议应用不要在程序中对pf进行转换（例如将字符型转换为int型），避免对于值不固定的pf（例如漫游或游戏联盟的pf）支持造成障碍。 

format string 定义API返回的数据格式。

取值说明：为xml时表示返回的格式是xml；为json时表示返回的格式是json。
注意：json、xml为小写，否则将不识别。format不传或非xml，则返回json格式数据。

userip string 用户的IP。

应用服务器得到的remote_ip和x_forward_ip是10.x.x.x，由上一层腾讯路由转发。
http请求的头里有一个QVia（HTTP_QVIA值），是个40个字节的串，前8个字节是IP，后面的是校验，将字节串前8个字节，分成4段，分别由16进制转成10进制，即可得到用户最终IP。
如果应用（例如新接入的应用、已经接入TGW的应用、non-hosting应用）获取不到QVia的值，可以直接通过标准http协议获取用户IP。





 

（2）私有参数

参数名称 是否必须 类型 描述
charset string 指定请求及响应的字符集，取值为gbk或utf-8（只有pf=qqgame或pf=3366时，可以输入该参数）。

默认值为utf-8，其他非法取值也认为是utf-8。

flag unsigned int pf=qqgame时，必须输入该参数，指定需要获取QQGame中的哪些信息：

1：需要获取游戏昵称和性别；
2：需要获取蓝钻等级；
3：需要获取昵称和蓝钻等级；
4：需要获取照片秀标志。

2.6 请求示例

 

http://openapi.tencentyun.com/v3/user/get_info?
openid=B624064BA065E01CB73F835017FE96FA&
openkey=5F154D7D2751AEDC8527269006F290F70297B7E54667536C&
appid=2&
sig=VrN%2BTn5J%2Fg4IIo0egUdxq6%2B0otk%3D&
pf=qzone&
format=json&
userip=112.90.139.30

 

2.7 返回参数说明

参数名称 描述
ret 返回码。详见公共返回码说明#OpenAPI V3.0 返回码。
msg 如果错误，返回错误信息。
is_lost 判断是否有数据丢失。如果应用不使用cache，不需要关心此参数。

0或者不返回：没有数据丢失，可以缓存。
1：有部分数据丢失或错误，不要缓存。

nickname 昵称。
gender 性别。
country 国家（当pf=qzone、pengyou或qplus时返回）。
province 省（当pf=qzone、pengyou或qplus时返回）。
city 市（当pf=qzone、pengyou或qplus时返回）。
figureurl 头像URL。详见：前端页面规范#6. 关于用户头像的获取和尺寸说明。
openid 用户QQ号码转化得到的ID（当pf=qplus时返回）。
qq_level 用户QQ等级（当pf=qplus时返回）。
qq_vip_level 用户QQ会员等级（当pf=qplus时返回）。
qplus_level 用户Q+等级（当pf=qplus时返回）。
is_yellow_vip 是否为黄钻用户（0：不是； 1：是）。

（当pf=qzone、pengyou或qplus时返回）

is_yellow_year_vip 是否为年费黄钻用户（0：不是； 1：是）。

（当pf=qzone、pengyou或qplus时返回）

yellow_vip_level 黄钻等级，目前最高级别为黄钻8级（如果是黄钻用户才返回此参数）。

（当pf=qzone、pengyou或qplus时返回）

is_yellow_high_vip 是否为豪华版黄钻用户（0：不是； 1：是）。

（当pf=qzone、pengyou或qplus时返回）

is_blue_vip 是否为蓝钻用户（0：不是； 1：是）。

（当pf=qqgame或3366时返回）

is_blue_year_vip 是否为年费蓝钻用户（0：不是； 1：是）。

（当pf=qqgame或3366时返回）

blue_vip_level 蓝钻等级（如果是蓝钻用户才返回此参数）。

（当pf=qqgame或3366时返回）

3366_level 3366用户的大等级。

（当pf=3366时返回）

3366_level_name 3366用户的等级名，如小游游、小游仙。

（当pf=3366时返回）

3366_grow_level 3366用户的成长等级。

（当pf=3366时返回）

3366_grow_value 3366用户的成长值。

（当pf=3366时返回）

is_super_blue_vip 是否是豪华蓝钻。

（当pf=qqgame或3366时返回）

2.8 错误返回码说明

公共错误返回码：公共返回码说明#OpenAPI V3.0 返回码。 
本接口私有错误返回码：暂无。 

 

 

调用结果：

 

===========test GetUserInfo===========
{
    "ret": 0,
    "is_lost": 0,
    "nickname": "點球踢勺子",
    "gender": "男",
    "country": "尼加拉瓜",
    "province": "",
    "city": "埃斯特利",
    "figureurl": "http:\/\/thirdapp2.qlogo.cn\/qzopenapp\/f222d66b35733712e2fa2eba757a4520f1c85d1305ac0be31df25de8c74c46b4\/50",
    "is_yellow_vip": 0,
    "is_yellow_year_vip": 0,
    "yellow_vip_level": 0,
    "is_yellow_high_vip": 0
}

 

 

 

 

 

放心去fly
关注
SpringBoot学习之SpringBoot3集成OpenApi（三十八）
易雪寒的博客
04-24 545
Springboot升级到3以后，就彻底放弃了对之前swagger的支持，转而重新支持最新的OpenApi，今天我们通过一个实例初步看看OpenApi和Swagger之间的区别.
Kubernetes官方java客户端之六：OpenAPI基本操作
m0_63174420的博客
11-06 977
https://github.com/zq2599/blog_demos 内容：所有原创文章分类汇总及配套源码，涉及Java、Docker、Kubernetes、DevOPS等； 概览 本文是《Kubernetes官方java客户端》系列的第六篇，以下提到的java客户端都是指client-jar.jar； 前文《Kubernetes官方java客户端之五：proto基本操作 》已经提到，java客户端的基本功能由两个主要脉络组成，第一个是proto，主要功能是使用ProtoClient类提供的增删
零基础成为大师 - OpenAPI规范与Swagger工具
duoshehuan6005的博客
06-14 122
零基础成为大师 - OpenAPI规范与Swagger工具 OpenAPI Specification & Swagger Tools - Zero To Master
使用Spring Boot和OpenAPI构建RESTful API文档化系统
最新发布
weixin_40362969的博客
08-07 26
使用Spring Boot和OpenAPI构建RESTful API文档化系统大家好，我是微赚淘客系统3.0的小编，是个冬天不穿秋裤，天冷也要风度的程序猿！在当今的软件开发中，构建RESTful API是非常常见的任务。随着微服务架构的流行，API的文档化和管理变得尤为重要。本文将介绍如何利用Spring Boot和Ope...
产品经理教你写代码—用JAVA写一个阿里云VPC Open API调用程序
weixin_33827590的博客
10-18 169
引言 VPC提供了丰富的API接口，让网络工程是可以通过API调用的方式管理网络资源。用程序和软件管理自动化管理网络资源是一件显著提升运维效率和网络生产力的事情。产品经理教你写代码系列文章的目标是不懂代码的网络工程师能一步一步的学会用API管理网络。 另外通过文章标题大家也可以看出来，产品经理教你写代码肯定是一个业余班，里面的代码很多写的都不规范，可能...
腾讯开放平台V3版OpenAPI的.NET SDK
02-08
腾讯开放平台V3版OpenAPI的.NET SDK第一版发布，3.0表示OpenAPI版本，后一位0表示SDK版本。 本SDK基于V3版OpenAPI，适用于腾讯开放平台上所有应用接入时使用： -V3版OpenAPI是老OpenAPI的升级版，支持全平台统一接入，即对于同一功能（例如获取用户信息），第三方应用不再需要根据不同的平台调用不同的接口。 -V3版OpenAPI采用新的接入协议，请求中必须包含签名值，更加安全。 -V3版OpenAPI在参数和返回值上尽量和老版本OpenAPI接口兼容，开发者如果想升级到新版本OpenAPI，代码改造工作量较小。 -开发者可以自由选择是否升级到OpenAPI V3.0。由于OpenAPI V3.0的上述优点，以及后续新开放的接口都将采用OpenAPI。
OpenApi-v3 - Swagger 代码示例
分享·收获
07-31 235
openapi: 3.0.0
大数据与云计算培训学习资料 腾讯技术 开放平台中的OpenAPI设计 共64页.pptx
03-20
大数据与云计算培训学习资料 腾讯技术 开放平台中的OpenAPI设计 大数据与云计算培训学习资料是指通过大数据和云计算技术实现的数据存储、处理和分析，腾讯技术开放平台中的OpenAPI设计是指在腾讯技术开放平台中设计...
OpenAPI3
03-17
OpenAPI 3 是一个开放标准，用于描述RESTful API，其全称为OpenAPI Specification 3.0，简称OAS 3.0。该规范由OpenAPI ...通过学习和应用OpenAPI 3，开发者可以构建出更加健壮、易于理解和维护的RESTful服务。
openapi-merger-demo.zip
11-27
通过"openapi-merger-demo.zip"中的示例，开发者可以学习到如何使用工具和策略有效地合并OpenAPI规范，这对于构建和管理大型、模块化的API服务至关重要。这不仅可以提高开发效率，还能确保API的统一性和一致性。
openapi:Qwilr API的OpenAPI规范
04-16
**OpenAPI规范详解** OpenAPI规范，又称为Swagger，是一种被广泛采用的API描述语言，用于定义RESTful API...通过深入学习和应用OpenAPI规范，开发者可以确保其集成方案的稳定性和兼容性，同时提高开发效率和用户体验。
推荐HTTP方式的OpenAPI的调试、测试工具：HttpRequester
SongCdut的专栏
10-19 7366
推荐HTTP方式的OpenAPI的调试、测试工具：HttpRequester
java 调用open淘宝API
ecshop数据采集发布接口，zencart，lightinthebox，shopex 采集，快客
03-13 1583
http://wiki.isv.alisoft.com/index.php/%E6%9C%8D%E5%8A%A1%E9%9B%86%E6%88%90%E5%B9%B3%E5%8F%B0 服务集群平台就不多唠叨了，去上面的文档地址去看看。我就简要的讲讲就我所知道的一些值得注意的地方： 1.                  淘宝的Open API每分钟访问的次数是有限制的，好像是400次/分钟
第十二章 使用中的 OpenAPI 属性
yaoxin521123的博客
07-31 580
有关这些属性的详细信息，请参阅https//github.com/OAI/OpenAPI-Specification/blob/master/versions/2.0.md#parameter-object。有关标准属性的详细信息，请参阅https//github.com/OAI/OpenAPI-Specification/blob/master/versions/2.0.md#info-object。(在后端调用以服务此操作的类方法的名称；(一个标志，指示应支持对此端点/方法组合的。...
OpenApi 接口文档
myli92的博客
05-17 844
Bean.name("许可协议").description("csdn博客")@Bean.build();秒懂SpringBoot之如何集成SpringDoc（全网目前最新最系统最全面的springdoc教程） - 知乎。
.NET6之MiniAPI(十八)：OpenAPI swagger
dotNET跨平台
02-25 1491
从本篇开始，介绍一些很不错的三方库，来丰富MiniAPI的使用。在创建MiniAPI项目时，模板提供了一个是否启用OpenAPI的选项，足见这个三方库的优势和强大。OpenAPI为我们测试...
从SpringFox向SpringDoc转移（OpenAPI2向OpenAPI3转移）
m0_47333020的博客
11-18 4236
转移原因 在学习使用spring集成swagger3时查阅文档发现 SpringFox未支持 OpenAPI3 标准，而是还在支持2017年就已经停止维护的OpenAPI2了 而搜遍全网写OpenAPI3的教程少的可怜 但还是找到了与之相关的文章 文章跳转 但没有关于权限验证的相关教程，答案还得去官网找 官网链接 转移步骤 删除springfox和swagger 2依赖项。而是添加springdoc-openapi-ui依赖 2.替换注解 3.替换Docket 添加OpenAPI类型的
Springdoc使用Swagger3、OpenApi规范
HHoao的博客
04-08 4231
Springdoc、Swagger3、OpenApi规范
SpringDoc --＞ Swagger的完美替代品 使用详解【可完全匹配新版Springboot】可视化RESTful风格 Web 服务接口api文档
杨大仙
03-06 6664
使用了最新 SpringBoot 版本的朋友们在使用 swagger 时一定都碰到了很多烦恼，各种报错。废话不多说，既然你看到这里就说明你已经查阅了很多资料，对swagger有了一定的了解。话不多说，直接上菜。 造成问题的原因 当然咯，上菜之前咱还是得讲解一下，为何频频出错；原因很简单，随着时间的推移，springboot 一直在更新迭代，而 swagger 已经1年多没有再进行升级（当前时间：北京时间3月6日17：38分），因此版本已经不再兼容； 上菜 我当前所...
java openAPI
10-10
Java OpenAPI是一个开放的应用程序接口（Open Application Programming Interface），可以让Java开发者与外部的服务或库进行交互。通过使用Java OpenAPI，开发者可以利用现有的功能和服务来构建更加丰富和复杂的应用程序。 Java OpenAPI可以用于访问各种不同的服务和资源，例如社交媒体平台的API、地理位置服务、支付服务等等。通过使用Java OpenAPI，开发者可以方便地与这些服务进行通信和数据交换。 Java OpenAPI的优势之一是它提供了一种标准化的接口，使得开发者可以使用统一的方式来与各种不同的服务进行交互。这样一来，开发者无需对每个服务都学习和使用不同的API，而是可以使用Java OpenAPI提供的功能来简化开发过程。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值