一、用途(必读):

  1. 如果仅用于网站展示二维码,无需接口开发,请使用二维码自动生成
  2. 其它用途请向下阅读,目前提供(二维码生成 、 二维码解码)两个接口


二、SDK下载:

  1. php-sdk-170902.zip
  2. js-sdk-170902.zip
  3. 其它语言请下载 Hprose,并参考以上sdk
  4. 阿里云市场(传统 POST/JSON 接口)同步上线:查看文档下载SDK


三、Hprose调用方式 & 接口参数说明:

  1. 调用方式:接口采用 Hprose 实现的rpc方式调用,具有轻量级、跨语言、跨平台、无侵入式等特点。

    请求限制:

    接口 普通用户 VIP会员 无限定制
    生成二维码 10次 / 分钟 70次 / 分钟 -
    识别二维码 10次 / 分钟 70次 / 分钟 -

    声明:若存在恶意请求信息,系统将自动屏蔽api_id以及来源IP。


  2. Hprose HTTP Server :http://hprose.wwei.cn/qrcode.html
  3. 生成二维码参数说明:

    Function:

    qrencode($api_id='',$signature='',$timestamp=0,$qrdata='',$size=300,$xt=1,$level='M',$p_color='#000000',$i_color='#000000',$back_color = '#FFFFFF',$fore_color ='#000000',$logo='',$wlogo=0,$hlogo=0,$version='1.1')

    形参名称 示例值 说明
    api_id qr12345 (必须) 在会员中心 > 开放平台 > 开发配置 获取
    signature md5(ZlketERWApwbLs1504346282二维码内容) (必须) md5签名参数顺序:md5($api_key.$timestamp.$qrdata)
    其中 api_key 在会员中心 > 开放平台 > 开发配置 获取
    timestamp 1504346282 (必须) 当前请求时间截(秒)
    qrdata 二维码内容 (必须) 二维码内容(文本、网址 ...)等
    size 300 二维码最终生成的图片尺寸,单位PX,支持:300 - 1000 PX
    xt 1 形态,可选值 0-2,[ 0=液态、1=直角、2=圆圈 ]
    level M 纠错级别 ,[ L、M、Q、H ]
    p_color #000000 码眼的边框颜色 (有无 # 号都可以,下同)
    i_color #000000 码眼的颜色
    back_color #FFFFFF 背景色
    fore_color #000000 前景色
    logo http://www.wwei.cn/static/images/icon/wwei.png logo图片远程地址,图片格式 [ jpg、png ],建议大小不超过 50 KB
    wlogo 0 logo的宽度,如果为0将自动计算logo大小,适应二维码大小
    hlogo 0 logo的高度,如果为0将自动计算logo大小,适应二维码大小
    version 1.1 当前接口版本号,特殊情况下才会启用

    Function 返回数组信息:

    错误时:

    return array(
    	'status'=>0,// 0 表示有错误
    	'data'=>'',
    	'msg'=>'signature有误',//错误信息提示
    );
    

    正确时:

    return array(
    	'status'=>1,// 1 表示正常状态
    	'data'=>array(
    		'qr_filepath'=>'http://hprose.wwei.cn/uploads/xxx.png',//临时图片地址,请下载到自己服务器保存
    		'qr_data'=>qrdata,//二维码内容,开发时注意是否与你传的参数内容一样
    	),
    	'msg'=>'success',
    );
    


  4. 解码二维码参数说明:

    Function:

    qrdecode($api_id='',$signature='',$timestamp=0,$imgurl='',$imgdata='',$version='1.1')

    形参名称 示例值 说明
    api_id qr12345 (必须) 在会员中心 > 开放平台 > 开发配置 获取
    signature md5(ZlketERWApwbLs1504346282
    http://www.wwei.cn/static/images/qrcode.jpg
    data:image/jpeg;base64,/9j/...省略N个字符...V/2Q==)
    (必须) md5签名参数顺序:md5($api_key.$timestamp.$imgurl.$imgdata);
    其中 api_key 在会员中心 > 开放平台 > 开发配置 获取
    注意:imgurl 和 imgdata 也可以其中一个空值
    timestamp 1504346282 (必须) 当前请求时间截(秒)
    imgurl http://www.wwei.cn/static/images/qrcode.jpg (可选) 包含二维码的图片网址 (注意:imgurl 和 imgdata 至少其中一个不为空)
    imgdata data:image/jpeg;base64,/9j/...省略N个字符...V/2Q== (可选) Base64编码的图片内容(注意:imgurl 和 imgdata 同时有参数时,将优先使用 imgdata 的内容)
    version 1.1 当前接口版本号,特殊情况下才会启用

    Function 返回数组信息:

    错误时:

    return array(
    	'status'=>0,// 0 表示有错误
    	'data'=>'',
    	'msg'=>'signature有误',//错误信息提示
    );
    

    正确时:

    return array(
    	'status'=>1,
    	'data'=> array(
    		'raw_text'=>'二维码解码内容',//解码内容
    		'raw_type'=>'QR-Code',//类型
    	),
    	'msg'=>'success',
    );