Decode QR Code from Image

Decode QR Code from Image
Decode QR code content from an uploaded image and return the parsed value, format, and detection points.

Method: POST
Path: /v1/barcode/qrcode/decode
Demo: https://api.gugudata.io/v1/barcode/qrcode/decode/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.
• file (file, required): Local file uploaded as multipart form data.

Response Fields:

• format (string, required): Detected code format
• parsed (string, required): Parsed QR code content
• points (array, optional): Detected corner points of the QR code
• raw (string, optional): Raw decoded string
• type (string, required): Detected payload type, such as URI, WIFI, EMAIL, or TEXT

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 Normal return: QR code successfully decoded
• 400 Parameter error: Image file is missing or does not contain a valid QR code
• 429 Request frequency limited: Cannot exceed 100 requests per second
• 403 Account in arrears: Payment required to continue using the service
• 402 APPKEY error: Please check whether the APPKEY passed is obtained from the developer center
• 500 API response error: Internal server error during QR code decoding

Key Features:

• Decode QR code values from uploaded images.
• Return the parsed content and raw decoded text.
• Include detection points for downstream visual workflows.
• Useful for ticketing, logistics, payments, and inventory apps.
• Works well for mobile uploads, scanned images, and generated QR assets.

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