Basics

Examples

Here’s the simplest call to our service to generate a standard QR code (not one of our higher end animated codes):

https://api.acme.codes/new?msg=myAwesomeLittleStore.com/purchasePages/redBicycle&format=png

The above call defaults to returning a low resolution image containing the scannable QR code. Here’s a call with parameters to request a code with higher resolution, and some custom colors in the registration eyes:

https://api.acme.codes/new?msg=myAwesomeLittleStore.com/purchasePages/redBicycle&format=png&xres=800&yres=800&eyeColor=0000aa

Notice full anti aliased quality, and that these calls are GET’s and easily can work in your browser directly.

These standard QR codes are created in very little time, so and actual image is directly returned. Animated QR codes require much more time to create than is acceptable for an internet query/response, so the call sequence is a few more steps to avoid unacceptably long response times.

Call Sequences

There are two call sequences: the Animated QR code sequence and the Standard QR code sequence demonstrated above.

Animated QR codes

To generate an animated QR code, the API call sequence is:

/new Initiate QR code creation with optional parameters, receive order number and location where final animation will be published
/order/#/progress Repeat progress check until animation is completed
/order/#/<mp4File> Retrieve the mp4 animation file

Some animations take a few seconds to create, while others take many minutes. This sequence supports immediate API responses and informing clients of progress without hanging or having to write code to support ‘202 - in progress` return codes.

Standard QR codes

To generate a standard QR code, the API call sequence is:

/new Initiate creation with desired parameters, receive png image response

Standard QR code creation time is less than a second, so this sequence supports direct return of requested content.