/api/v2/verify-qrcode

May 21, 2026 ยท View on GitHub

The QR Code Verification API provides endpoints for validating QR codes against the manufacturing database.

/api/v2/verify-qrcode

HTTP Method: POST

Description: Verifies if a QR code value exists in the manufacturing database, typically used for device validation during scanning.

Request Format:

{
  "qrcode": "10000000abcdef"
}

Response Format:

The endpoint returns a JSON object with verification results:

{
  "success": true,
  "exists": true,
  "qrcode": "10000000abcdef"
}

Field Descriptions:

FieldDescription
successIndicates if the verification check was performed successfully
existsIndicates if the QR code value was found in the manufacturing database
qrcodeThe QR code value that was checked

Error Responses:

If using an invalid HTTP method:

{
  "error": {
    "status": 405,
    "title": "Method Error",
    "code": "METHOD_NOT_ALLOWED",
    "detail": "Only POST method is allowed"
  }
}

If QR code parameter is missing:

{
  "error": {
    "status": 400,
    "title": "Parameter Error",
    "code": "INVALID_PARAMETER",
    "detail": "Missing or invalid 'qrcode' parameter in request body"
  }
}

Notes:

  • This endpoint is particularly useful for integration with barcode scanners or mobile applications.

  • The QR code value is checked against the rpi_duid field in the manufacturing database.