API 文档
二维码
列出、检查、创建、更新和删除您的二维码。
身份验证
每个请求都必须在 Authorization 头中发送与管理员 API 密钥匹配的 Bearer 令牌。
获取API密钥.
端点
GET https://rqrcode.com/api/qr-codes/
示例
curl --request GET \
--url 'https://rqrcode.com/api/qr-codes/' \
--header 'Authorization: Bearer {api_key}'
参数
| 参数 | 详情 | 描述 |
|---|---|---|
| page |
可选
ui.admin.api_docs.common.types.整数
|
您想要获取结果的页码。默认为1。 |
| results_per_page |
可选
ui.admin.api_docs.common.types.整数
|
每页您想要的结果数量。允许值为：10, 25, 50, 100, 250, 500, 1000。默认为25。 |
响应示例
{
"data": [
{
"id": 1,
"type": "url",
"name": "示例名称",
"qr_code": "https://rqrcode.com/uploads/qr_code/example.svg",
"qr_code_logo": null,
"qr_code_background": null,
"settings": {
"foreground_type": "color",
"foreground_color": "#000000",
"background_color": "#ffffff",
"custom_eyes_color": false,
"qr_code_logo_size": 25,
"size": 500,
"margin": 0,
"ecc": "L",
"url": "https://example.com",
"...": "..."
},
"embedded_data": "https://example.com",
"last_datetime": null,
"datetime": "2026-04-20 07:52:15"
}
],
"meta": {
"page": 1,
"results_per_page": 25,
"total": 1,
"total_pages": 1
},
"links": {
"first": "https://rqrcode.com/api/qr-codes?page=1",
"last": "https://rqrcode.com/api/qr-codes?page=1",
"next": null,
"prev": null,
"self": "https://rqrcode.com/api/qr-codes?page=1"
}
}
端点
GET https://rqrcode.com/api/qr-codes/{qr_code_id}
示例
curl --request GET \
--url 'https://rqrcode.com/api/qr-codes/{qr_code_id}' \
--header 'Authorization: Bearer {api_key}'
参数
无附加参数。
响应示例
{
"data": {
"id": 1,
"type": "url",
"name": "示例名称",
"qr_code": "https://rqrcode.com/uploads/qr_code/example.svg",
"qr_code_logo": null,
"qr_code_background": null,
"settings": {
"foreground_type": "color",
"foreground_color": "#000000",
"background_color": "#ffffff",
"custom_eyes_color": false,
"qr_code_logo_size": 25,
"size": 500,
"margin": 0,
"ecc": "L",
"url": "https://example.com",
"...": "..."
},
"embedded_data": "https://example.com",
"last_datetime": null,
"datetime": "2026-04-20 07:52:15"
}
}
端点
POST https://rqrcode.com/api/qr-codes
示例
curl --request POST \
--url 'https://rqrcode.com/api/qr-codes' \
--header 'Authorization: Bearer {api_key}' \
--header 'Content-Type: multipart/form-data' \
--form 'name=纽约' \
--form 'type=text' \
--form 'text=你好！'
参数
| 参数 | 详情 | 描述 |
|---|---|---|
| link_id |
可选
ui.admin.api_docs.common.types.整数
|
— |
| project_id |
可选
ui.admin.api_docs.common.types.整数
|
— |
| name |
必填
ui.admin.api_docs.common.types.字符串
|
— |
| type |
必填
ui.admin.api_docs.common.types.字符串
|
允许值：text, url, pdf, phone, sms, email, whatsapp, facetime, location, wifi, event, vcard, crypto, paypal, upi, epc, pix, coupon, google_review |
| is_bulk |
可选
ui.admin.api_docs.common.types.布尔值
|
可用条件：type = text |
| style |
可选
ui.admin.api_docs.common.types.字符串
|
允许值：square, dot, round, rounded, elastic_square, heart, diamond, star, triangle, hexagon, spaced_square, octagon, cross_x, curvy_x, rounded_cross, ninja, sun, shine, bold_plus, teardrop, corner_cut, randomized_square, bold_x |
| inner_eye_style |
可选
ui.admin.api_docs.common.types.字符串
|
允许值：square, dot, rounded, diamond, flower, leaf |
| outer_eye_style |
可选
ui.admin.api_docs.common.types.字符串
|
允许值：square, circle, rounded, flower, leaf |
| foreground_type |
可选
ui.admin.api_docs.common.types.字符串
|
允许值：color, gradient |
| foreground_color |
可选
ui.admin.api_docs.common.types.字符串
|
可用条件：foreground_type = color |
| foreground_gradient_style |
可选
ui.admin.api_docs.common.types.字符串
|
允许值：vertical, horizontal, diagonal, inverse_diagonal, radial |
| foreground_gradient_one |
可选
ui.admin.api_docs.common.types.字符串
|
可用条件：foreground_type = gradient |
| foreground_gradient_two |
可选
ui.admin.api_docs.common.types.字符串
|
可用条件：foreground_type = gradient |
| background_color |
可选
ui.admin.api_docs.common.types.字符串
|
— |
| background_color_transparency |
可选
ui.admin.api_docs.common.types.整数
|
— |
| custom_eyes_color |
可选
ui.admin.api_docs.common.types.布尔值
|
— |
| eyes_inner_color |
可选
ui.admin.api_docs.common.types.字符串
|
可用条件：custom_eyes_color = 1 |
| eyes_outer_color |
可选
ui.admin.api_docs.common.types.字符串
|
可用条件：custom_eyes_color = 1 |
| qr_code_logo |
可选
ui.admin.api_docs.common.types.文件
|
— |
| qr_code_logo_size |
可选
ui.admin.api_docs.common.types.整数
|
5-35 |
| qr_code_background |
可选
ui.admin.api_docs.common.types.文件
|
— |
| qr_code_background_transparency |
可选
ui.admin.api_docs.common.types.整数
|
0-100 |
| qr_code_foreground |
可选
ui.admin.api_docs.common.types.文件
|
— |
| qr_code_foreground_transparency |
可选
ui.admin.api_docs.common.types.整数
|
0-100 |
| frame |
可选
ui.admin.api_docs.common.types.字符串
|
允许值：circle_simple_bottom_text, round_simple_bottom_text, straight_simple_bottom_text, round_card_bottom_text, straight_bottom_text, straight_top_text, round_bottom_text, round_top_text, tooltip_bottom_text, tooltip_top_text, ribbon_bottom_text, ribbon_top_text, tooltip_snap_top_text, tooltip_snap_bottom_text, straight_semi_bordered_bottom_text, round_semi_bordered_bottom_text, hand_arrows_bottom_text, broken_ticket_bottom_text, smooth_ribbon_bottom_text |
| frame_text |
可选
ui.admin.api_docs.common.types.字符串
|
— |
| frame_text_size |
可选
ui.admin.api_docs.common.types.整数
|
-5 - 5 |
| frame_text_font |
可选
ui.admin.api_docs.common.types.字符串
|
允许值：times_new_roman, georgia, courier, arial, helvetica, verdana, tahoma, trebuchet_ms, courier_new, monaco, comic_sans_ms, impact, luminari, baskerville, papyrus, brush_script_mt |
| frame_custom_colors |
可选
ui.admin.api_docs.common.types.布尔值
|
— |
| frame_color |
可选
ui.admin.api_docs.common.types.字符串
|
可用条件：frame_custom_colors = 1 |
| frame_text_color |
可选
ui.admin.api_docs.common.types.字符串
|
可用条件：frame_custom_colors = 1 |
| size |
可选
ui.admin.api_docs.common.types.整数
|
50-2000 |
| margin |
可选
ui.admin.api_docs.common.types.整数
|
0-25 |
| ecc |
可选
ui.admin.api_docs.common.types.字符串
|
允许值：L, M, Q, H |
| text |
可选
ui.admin.api_docs.common.types.字符串
|
可用条件：type = text |
| url |
可选
ui.admin.api_docs.common.types.字符串
|
可用条件：type = url |
| phone |
可选
ui.admin.api_docs.common.types.字符串
|
可用条件：type = phone |
| sms |
可选
ui.admin.api_docs.common.types.字符串
|
可用条件：type = sms |
|
可选
ui.admin.api_docs.common.types.字符串
|
可用条件：type = email | |
|
可选
ui.admin.api_docs.common.types.字符串
|
可用条件：type = whatsapp | |
| facetime |
可选
ui.admin.api_docs.common.types.字符串
|
可用条件：type = facetime |
| event |
可选
ui.admin.api_docs.common.types.字符串
|
可用条件：type = event |
| location |
可选
ui.admin.api_docs.common.types.对象
|
— |
| wifi |
可选
ui.admin.api_docs.common.types.对象
|
— |
| crypto |
可选
ui.admin.api_docs.common.types.对象
|
— |
| vcard |
可选
ui.admin.api_docs.common.types.对象
|
— |
| paypal |
可选
ui.admin.api_docs.common.types.对象
|
— |
| upi |
可选
ui.admin.api_docs.common.types.对象
|
— |
| epc |
可选
ui.admin.api_docs.common.types.对象
|
— |
| pix |
可选
ui.admin.api_docs.common.types.对象
|
— |
| coupon |
可选
ui.admin.api_docs.common.types.对象
|
— |
| google_review |
可选
ui.admin.api_docs.common.types.对象
|
— |
响应示例
{
"data": {
"id": 1
}
}
端点
POST https://rqrcode.com/api/qr-codes/{qr_code_id}
示例
curl --request POST \
--url 'https://rqrcode.com/api/qr-codes/{qr_code_id}' \
--header 'Authorization: Bearer {api_key}' \
--header 'Content-Type: multipart/form-data' \
--form 'name=拉斯维加斯'
参数
| 参数 | 详情 | 描述 |
|---|---|---|
| link_id |
可选
ui.admin.api_docs.common.types.整数
|
— |
| project_id |
可选
ui.admin.api_docs.common.types.字符串
|
— |
| name |
可选
ui.admin.api_docs.common.types.字符串
|
— |
| type |
可选
ui.admin.api_docs.common.types.字符串
|
允许值：text, url, pdf, phone, sms, email, whatsapp, facetime, location, wifi, event, vcard, crypto, paypal, upi, epc, pix, coupon, google_review |
| style |
可选
ui.admin.api_docs.common.types.字符串
|
允许值：square, dot, round, rounded, elastic_square, heart, diamond, star, triangle, hexagon, spaced_square, octagon, cross_x, curvy_x, rounded_cross, ninja, sun, shine, bold_plus, teardrop, corner_cut, randomized_square, bold_x |
| inner_eye_style |
可选
ui.admin.api_docs.common.types.字符串
|
允许值：square, dot, rounded, diamond, flower, leaf |
| outer_eye_style |
可选
ui.admin.api_docs.common.types.字符串
|
允许值：square, circle, rounded, flower, leaf |
| foreground_type |
可选
ui.admin.api_docs.common.types.字符串
|
允许值：color, gradient |
| foreground_color |
可选
ui.admin.api_docs.common.types.字符串
|
可用条件：foreground_type = color |
| foreground_gradient_style |
可选
ui.admin.api_docs.common.types.字符串
|
允许值：vertical, horizontal, diagonal, inverse_diagonal, radial |
| foreground_gradient_one |
可选
ui.admin.api_docs.common.types.字符串
|
可用条件：foreground_type = gradient |
| foreground_gradient_two |
可选
ui.admin.api_docs.common.types.字符串
|
可用条件：foreground_type = gradient |
| background_color |
可选
ui.admin.api_docs.common.types.字符串
|
— |
| background_color_transparency |
可选
ui.admin.api_docs.common.types.整数
|
0 - 100 |
| custom_eyes_color |
可选
ui.admin.api_docs.common.types.布尔值
|
— |
| eyes_inner_color |
可选
ui.admin.api_docs.common.types.字符串
|
可用条件：custom_eyes_color = 1 |
| eyes_outer_color |
可选
ui.admin.api_docs.common.types.字符串
|
可用条件：custom_eyes_color = 1 |
| qr_code_logo |
可选
ui.admin.api_docs.common.types.文件
|
— |
| qr_code_logo_size |
可选
ui.admin.api_docs.common.types.整数
|
5-35 |
| qr_code_background |
可选
ui.admin.api_docs.common.types.文件
|
— |
| qr_code_background_transparency |
可选
ui.admin.api_docs.common.types.整数
|
0-100 |
| qr_code_foreground |
可选
ui.admin.api_docs.common.types.文件
|
— |
| qr_code_foreground_transparency |
可选
ui.admin.api_docs.common.types.整数
|
0-100 |
| frame |
可选
ui.admin.api_docs.common.types.字符串
|
允许值：circle_simple_bottom_text, round_simple_bottom_text, straight_simple_bottom_text, round_card_bottom_text, straight_bottom_text, straight_top_text, round_bottom_text, round_top_text, tooltip_bottom_text, tooltip_top_text, ribbon_bottom_text, ribbon_top_text, tooltip_snap_top_text, tooltip_snap_bottom_text, straight_semi_bordered_bottom_text, round_semi_bordered_bottom_text, hand_arrows_bottom_text, broken_ticket_bottom_text, smooth_ribbon_bottom_text |
| frame_text |
可选
ui.admin.api_docs.common.types.字符串
|
— |
| frame_text_size |
可选
ui.admin.api_docs.common.types.整数
|
-5 -> 5 |
| frame_text_font |
可选
ui.admin.api_docs.common.types.字符串
|
允许值：times_new_roman, georgia, courier, arial, helvetica, verdana, tahoma, trebuchet_ms, courier_new, monaco, comic_sans_ms, impact, luminari, baskerville, papyrus, brush_script_mt |
| frame_custom_colors |
可选
ui.admin.api_docs.common.types.布尔值
|
— |
| frame_color |
可选
ui.admin.api_docs.common.types.字符串
|
可用条件：frame_custom_colors = 1 |
| frame_text_color |
可选
ui.admin.api_docs.common.types.字符串
|
可用条件：frame_custom_colors = 1 |
| size |
可选
ui.admin.api_docs.common.types.整数
|
50-2000 |
| margin |
可选
ui.admin.api_docs.common.types.整数
|
0-25 |
| ecc |
可选
ui.admin.api_docs.common.types.字符串
|
允许值：L, M, Q, H |
| text |
可选
ui.admin.api_docs.common.types.字符串
|
可用条件：type = text |
| url |
可选
ui.admin.api_docs.common.types.字符串
|
可用条件：type = url |
| phone |
可选
ui.admin.api_docs.common.types.字符串
|
可用条件：type = phone |
| sms |
可选
ui.admin.api_docs.common.types.字符串
|
可用条件：type = sms |
|
可选
ui.admin.api_docs.common.types.字符串
|
可用条件：type = email | |
|
可选
ui.admin.api_docs.common.types.字符串
|
可用条件：type = whatsapp | |
| facetime |
可选
ui.admin.api_docs.common.types.字符串
|
可用条件：type = facetime |
| event |
可选
ui.admin.api_docs.common.types.字符串
|
可用条件：type = event |
| location |
可选
ui.admin.api_docs.common.types.对象
|
— |
| wifi |
可选
ui.admin.api_docs.common.types.对象
|
— |
| crypto |
可选
ui.admin.api_docs.common.types.对象
|
— |
| vcard |
可选
ui.admin.api_docs.common.types.对象
|
— |
| paypal |
可选
ui.admin.api_docs.common.types.对象
|
— |
| upi |
可选
ui.admin.api_docs.common.types.对象
|
— |
| epc |
可选
ui.admin.api_docs.common.types.对象
|
— |
| pix |
可选
ui.admin.api_docs.common.types.对象
|
— |
| coupon |
可选
ui.admin.api_docs.common.types.对象
|
— |
| google_review |
可选
ui.admin.api_docs.common.types.对象
|
— |
响应示例
{
"data": {
"id": 1
}
}
端点
DELETE https://rqrcode.com/api/qr-codes/{qr_code_id}
示例
curl --request DELETE \
--url 'https://rqrcode.com/api/qr-codes/{qr_code_id}' \
--header 'Authorization: Bearer {api_key}'
参数
无附加参数。
响应示例
成功时返回空的 200 响应体。