QR Code - API Documents - GuGuData | Production-Ready APIs Built for Developers

Universal QR Code Generator
Generate a QR code image from the provided content and size options.

Method: POST
Path: /v1/qrcode
Demo: https://api.gugudata.io/v1/qrcode/demo
OpenAPI: https://gugudata.io/assets/openapi/gugudata.openapi.3.1.json

Request Parameters:

appkey (string, required): Application key used for request authentication. Supply the value as a query parameter, form field, or multipart field according to the request content type.

content (string, required): Primary text content processed by the endpoint.

size (integer, optional): QR code image size in pixels, default is 200

Response Fields:

url (string, required): CDN URL of the generated QR code image. Validation failures may return a plain-text error message instead of the success payload.

HTTP Status Codes:

200: Request processed successfully. Some endpoints expose a separate application-level status field in the response body, such as dataStatus.statusCode.

400: Invalid request parameters or request format. Check required fields, data types, and request body format.

401: Missing or unknown application key. Provide a valid appkey with the request.

403: The application key is recognized but access is not allowed. The key may be expired, inactive, or not permitted for the requested API.

429: Request rate or trial usage limit exceeded. Reduce concurrency or retry after the limit window resets.

500: Internal service error. Retry later or contact support if the error persists.

503: Upstream service unavailable. Retry later; the requested upstream dependency is temporarily unavailable.

Business Status Codes:

200 Success: QR code generated successfully

400 Parameter error: Invalid or missing required parameters

401 Invalid APPKEY: Please check if the APPKEY is valid and active

429 Rate limit exceeded: Too many requests in a given time window

500 Server error: Internal server error occurred

Key Features:

Supports various content types for QR code generation.

Direct CDN storage and retrieval of generated QR codes.

Intelligent URL detection and handling.

Customizable QR code size.

Full HTTPS support (TLS v1.0 / v1.1 / v1.2 / v1.3).

Compatible with Apple ATS.

Multi-node CDN deployment.

High-speed API response with load-balanced server infrastructure.

Details:
https://gugudata.io/details/qrcode

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200成功

application/json

Bodyapplication/json

Example

{
  "dataStatus": {
    "requestParameter": "string",
    "statusCode": 0,
    "status": "string",
    "statusDescription": "string",
    "responseDateTime": "string",
    "dataTotalCount": 0
  },
  "data": {
    "url": "string"
  },
  "DataStatus": {
    "StatusCode": 100,
    "StatusDescription": "OK",
    "ResponseDateTime": "2026-01-01 00:00:00",
    "DataTotalCount": 1
  }
}