OOtoto API Docs
API Reference

QR Code

Generates a QR code image for an existing car detail, optionally styled with a logo and caption text.

POST /Qr

Request

POST https://api.ototo.be/v1/Qr?subscription-key=YOUR_KEY
Content-Type: application/json

A JSON object with carDetailId plus any of the optional styling parameters below. Parameter order doesn't matter; invalid or omitted optional values fall back to their default.

ParameterDefaultDescription
carDetailIdrequiredThe car detail's unique identifier — see Car Details
logoPathOtoto_QR_CodeThe logo shown inside the QR code itself
qrCodeWidth500Width of the resulting image, in pixels
qrCodeHeight750Height of the resulting image, in pixels
captionLine1nullFirst line of caption text below the QR code
captionLine2nullSecond line of caption text. Only used if captionLine1 is also set.
captionColor000000Caption text color, as a hex value without a leading #
captionTextSize20Caption font size
topLogoPathnullAbsolute path to a logo shown above the QR code
topLogoWidth220Width the top logo is resized to. For best results, keep close to the logo's actual width.
topLogoHeight110Height the top logo is resized to. For best results, keep close to the logo's actual height.

Layout

  • qrCodeWidth × qrCodeHeight is the exact size of the resulting image. The QR code itself fills the shortest side, with a 20px margin.
  • The logo embedded inside the QR code covers about 35% of the code's area.
  • A 20px gap separates the QR code from the top logo and from the caption.
  • The top logo is resized to topLogoWidth × topLogoHeight and centered horizontally.
  • The caption is centered horizontally at captionTextSize.
  • All elements are vertically centered (and center-cropped if needed) within the final image dimensions.

Response

StatusMeaning
201A Location header containing the URI of the generated QR image
401Subscription key missing, invalid, or inactive — see Authentication
404carDetailId not found
500Something went wrong on the server. Retry later; contact Ototo if it persists.
The image is temporary

Generated QR images are only available for 24–48 hours. If you need it longer, download and store it yourself — Ototo doesn't keep it after that window.

Example

Request 
POST https://api.ototo.be/v1/Qr?subscription-key=YOUR_KEY
Content-Type: application/json

{
  "carDetailId": "12345678-1234-1234-1234-123456789abc",
  "captionLine1": "Scan for your car's tax overview",
  "captionColor": "1A56DB"
}
Response — 201 Created 
Location: https://api.ototo.be/v1/qr-images/{generated-id}.png

See also

← Public Link API Explorer →