二维码(QRCode)生成 API 接口

二维码(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 接口返回的错误消息。当statussuccess时,error_message为空字符串
error_code int 或 null 接口返回的错误码。当statussuccess时,error_codenull
data object 或 null 接口返回的数据。当statusfailed时,datanull
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......"
    }
}

https://www.example.com


请求示例 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......"
    }
}

ccbc6e6a6303efed0027b59aa037fc9d


异常响应示例

{
    "status": "failed",
    "error_message": "content 不能为空。",
    "error_code": 400,
    "data": null
}