二维码(QRCode)生成 API 接口
由万码云开发平台提供的二维码生成(QRCode)API 接口,支持生成链接、文本等多种类型的二维码,参数可灵活配置。接口设计简单,易于集成和调用,适用于多种应用场景,帮助开发者轻松实现二维码生成相关功能。
接口地址(免费版)
POST https://wcode.net/api/qrcode/v5/generate/free
注:免费版接口限制并发为 12 QPM(Query Per Minute,每分钟处理请求数)
接口地址(付费版)
付费版价格:0.002 元/次(即调用 500 次生成二维码接口的费用为 1 元),费用充值:https://wcode.net/apikey-recharge,费用发票:https://wcode.net/get-fapiao
POST https://wcode.net/api/qrcode/v5/generate
请求方法
POST
快速开始(请求示例)
(注:以下请求示例中的 API_KEY
需要替换后再发起请求。 获取 API_KEY
入口:https://wcode.net/get-apikey)
curl --request POST 'https://wcode.net/api/qrcode/v5/generate' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer API_KEY' \
--data '{
"content": "https://www.example.com"
}'
请求头(Request Headers)
Header | 值 | 备注 | 示例 | 相关链接 |
---|---|---|---|---|
Authorization | Bearer API_KEY |
格式:Bearer + 空格 + API_KEY | Bearer sk-..... |
获取 API_KEY 入口:https://wcode.net/get-apikey |
Content-Type | application/json |
固定为 application/json |
请求参数
参数 | 必填 | 参数类型 | 默认值 | 说明 |
---|---|---|---|---|
content | 是 | string | - | 生成二维码的内容,可以是链接(URL)、文本(字符串)等内容 |
返回参数
返回参数 | 数据类型 | 说明 |
---|---|---|
status | string | 请求成功返回success ,失败返回failed |
error_message | string | 接口返回的错误消息。当status 为success 时,error_message 为空字符串 |
error_code | int 或 null | 接口返回的错误码。当status 为success 时,error_code 为 null |
data | object 或 null | 接口返回的数据。当status 为failed 时,data 为 null |
data.temp_url | string | 生成的二维码图片的临时 URL,有效期3分钟,开发者应在调用接口后尽快下载保存至本地 |
data.mime_type | string | 生成的二维码图片的 MIME 类型 |
data.base64_data_uri | string | 生成的二维码图片的 base64 dataURI |
响应头(Response Headers)
Header | 说明 | 示例 | 相关链接 |
---|---|---|---|
X-Account-Balance | API_KEY 余额(元) | 123.0165 |
API_KEY 费用充值入口:https://wcode.net/apikey-recharge |
请求示例 1(生成内容为链接的二维码)
curl --request POST 'https://wcode.net/api/qrcode/v5/generate' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer API_KEY' \
--data '{
"content": "https://www.example.com"
}'
响应示例 1(生成内容为链接的二维码)
{
"status": "success",
"error_message": "",
"error_code": null,
"data": {
"temp_url": "https://wcode.net/tmp/qrcode-1733745935-VlBCgQmDiBLIouFo.png", // 有效期 3 分钟,开发者需尽快下载保存至本地
"mime_type": "image/png",
"base64_data_uri": "data:image/png;base64,iVBORw0KGgoAAAANS......"
}
}
请求示例 2(生成内容为任意文本的二维码)
curl --request POST 'https://wcode.net/api/qrcode/v5/generate' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer API_KEY' \
--data '{
"content": "ccbc6e6a6303efed0027b59aa037fc9d"
}'
响应示例 2(生成内容为任意文本的二维码)
{
"status": "success",
"error_message": "",
"error_code": null,
"data": {
"temp_url": "https://wcode.net/tmp/qrcode-1733748186-9sm8oCuG2V3Kqk3T.png", // 有效期 3 分钟,开发者需尽快下载保存至本地
"mime_type": "image/png",
"base64_data_uri": "data:image/png;base64,iVBORw0KGgoAAAANS......"
}
}
异常响应示例
{
"status": "failed",
"error_message": "content 不能为空。",
"error_code": 400,
"data": null
}