Download a QR code

Méthode GET {API_BASE}/v2.1/client/{key}/{crid}/qrcode

Return a PNG QR code that encodes the reading URL https://{domain}/{urid}. The QR code never targets the preview or overwrite URL.

Autorisation

Scope requis client_v2

The API key is intentionally kept in the path for V2 compatibility: /v2.1/client/{key}/{crid}/... or /v2.1/user/{key}/{crid}/.... Client routes require the client_v2 scope. User routes require the user_v2 scope. Unknown, expired, revoked, malformed, or wrong-scope keys return the legacy JSON error envelope.

Paramètres

Nom	Emplacement	Type	Requis	Contraintes	Description
`key`	Chemin	`string`	Requis		API key kept in the URL for V2 compatibility. Requires `client_v2` or `user_v2` depending on the route.
`crid`	Chemin	`string`	Requis		Client reference ID, usually an order or campaign reference.
`dark`	Paramètre de requête	`string`	Facultatif	pattern ^#?[0-9a-fA-F]{3}([0-9a-fA-F]{3})?$	Hex color for dark QR pixels.
`light`	Paramètre de requête	`string`	Facultatif	pattern ^#?[0-9a-fA-F]{3}([0-9a-fA-F]{3})?$	Hex color for light QR pixels.
`extension`	Paramètre de requête	`string`	Facultatif		Legacy filename extension hint. The response body is always PNG. Par défaut `png`
`size`	Paramètre de requête	`integer`	Facultatif	min 64	QR image size in pixels. Par défaut `256`

Réponses

200 image/png

PNG QR code image.

400 application/json Schéma LegacyError

Invalid key, CRID, payload, message state or business precondition.

403 application/json Schéma LegacyError

Key is authenticated but scope or platform constraints are invalid.

json 403

{
  "status": 1,
  "error": "forbidden"
}

forbidden

json 403

{
  "status": 1,
  "error": "forbidden"
}

invalidPlatformConstraint

json 403

{
  "status": 1,
  "error": "key_invalid"
}

503 application/json Schéma LegacyError

API key backend is temporarily unavailable.

json 503

{
  "status": 1,
  "error": "auth_unavailable"
}