二维码接口API & SDK使用教程

1. 获取 Bearer Token / API Key ： https://www.2weima.com/user/api_tokens/index.html
2. 下载SDK，复制SDK代码：https://www.2weima.com/static/api_sdk/api_sdk-1.2.5.zip
3. 完成

点击播放：视频教程

下载SDK包已提供语言：Jquery、Node.js、PHP、Go、Python、C#、Java、Dart、Swift、Shell

注意：文章最后列出详细参数说明

二维码生成：

JSSDK

在你的网站中要显示二维码的位置上插入以下代码，自动显示当前网址的二维码。

<!-- 注意：删除 script 前空格 -->
<空格script type="text/javascript">
var _templateId = '490';//模板ID
var _apiKey='5|ciJvXPLTGboqFEnmymdMrmFqBMeSqFgkRMYLmzvM';// Bearer Token / API Key 注意替换为你自己的
var _qrContent='';//二维码内容，不输入自动获取当前网址
if(_qrContent==''){_qrContent = encodeURIComponent(document.location.href);}document.write('<img src="https://api.2weima.com/api/qrimage?qr_content='+ _qrContent +'&template_id='+_templateId+'&api_key='+_apiKey+'" alt="2weima.com api"/>');
</script>

PHP

//当使用模板 template_id 时，只需要传 qr_content 和 template_id 两个参数就可以了
$curl = curl_init();
curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://api.2weima.com/api/qrencode',
  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('qr_content' => 'test qr_content','qr_size' => '350','qr_margin' => '10','qr_level' => 'M','qr_version' => '0','qr_shape' => '0','qr_mark_shape' => '0','template_id' => '490'),
  CURLOPT_HTTPHEADER => array(
    'Accept: application/json',
    'Authorization: Bearer 3|5bY28HQSW2Ada9eFyg1pTmoA2rSEgTBjNBuP074N' //注意替换为你自己的
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

node.js Axios

//当使用模板 template_id 时，只需要传 qr_content 和 template_id 两个参数就可以了
var axios = require('axios');
var FormData = require('form-data');
var data = new FormData();
data.append('qr_content', 'test qr_content');
data.append('qr_size', '350');
data.append('qr_margin', '10');
data.append('qr_level', 'M');
data.append('qr_version', '0');
data.append('qr_shape', '0');
data.append('qr_mark_shape', '0');
data.append('template_id', '490');

var config = {
  method: 'post',
  url: 'https://api.2weima.com/api/qrencode',
  headers: { 
    'Accept': 'application/json', 
    'Authorization': 'Bearer 3|5bY28HQSW2Ada9eFyg1pTmoA2rSEgTBjNBuP074N', //注意替换为你自己的
    ...data.getHeaders()
  },
  data : data
};

axios(config)
.then(function (response) {
  console.log(JSON.stringify(response.data));
})
.catch(function (error) {
  console.log(error);
});

二维码解码：

PHP

$curl = curl_init();
curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://api.2weima.com/api/qrdecode',
  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('qr_image' => 'https://img.2weima.com/qr_template/2021/6/26/8857784941a0f2d2a024044f414c69f9.jpg'),
  CURLOPT_HTTPHEADER => array(
    'Accept: application/json',
    'Authorization: Bearer 3|5bY28HQSW2Ada9eFyg1pTmoA2rSEgTBjNBuP074N'//注意替换为你自己的
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

node.js Axios

var axios = require('axios');
var FormData = require('form-data');
var data = new FormData();
data.append('qr_image', 'https://img.2weima.com/qr_template/2021/6/26/8857784941a0f2d2a024044f414c69f9.jpg');

var config = {
  method: 'post',
  url: 'https://api.2weima.com/api/qrdecode',
  headers: { 
    'Accept': 'application/json', 
    'Authorization': 'Bearer 3|5bY28HQSW2Ada9eFyg1pTmoA2rSEgTBjNBuP074N', //注意替换为你自己的
    ...data.getHeaders()
  },
  data : data
};

axios(config)
.then(function (response) {
  console.log(JSON.stringify(response.data));
})
.catch(function (error) {
  console.log(error);
});

二维码接口参数详情说明

响应状态说明：

{
"status": 200, 状态：{200 正常}，{ 400参数错误，422参数验证错误 429 Token错误 }，  {500处理失败}
"message": "success",//错误时返回错误处理
"qr_image": "https://img.2weima.com/qr_text/2021/9/11/07f1d0521a68c22c4c5f81f67f4c0ca0.png" //生成成功时返回二维码图片
"qr_content": "二维码解码后内容" //解码成功时返回二维码内容
}

二维码生成：

二维码解码：

JSSDK

传参数时注意格式，如：api_key=3|5bY28HQSW2Ada9eFyg1pTmoA2rSEgTBjNBuP074N

接口请求限制

为防止恶意使用，限制每分钟请求量，以下限制足以满足80%以上企业使用，如有更高要求需要定制处理。

用户	每分钟请求量
免费	5
基础版	70
高级版	140
旗舰版	300