API Description v1

Fontrocker API Documentation v1

Precondition

To interact with our API service, first grab your personal API key from your backend at https://api.fontrocker.com. This API key needs to be transferred as additional http header for every request as Authorization: Bearer <token>.

Query Parameters

Parameter Type Description Example
font STRING ID of the font to use 5bc2e50ab9f
text STRING String of the text to print Call me Superhero
align
(optional)
STRING Align text, if multiple lines left (default), center, right

Getting a preview image

The returned image of the preview service is for usage in your online creator/editor, where your customers can visualize, how their product will look like.

To prevent traffic overflow, and secure your budget, we kindly ask you, to implement a debouncing of minimum 500ms for every refresh request. Contact us, to get technical support.

Endpoint: https://api.fontrocker.com/v1/preview

The output format for the preview image is webp, which can be used directly from inside the browser.

Getting a high resolution image

The returned image can be used for printing on paper, posters, mugs, fabric of any kind (like T-Shirts or Caps). The image creation is asynchronous, which means, that you’ll get back a unique identifier, rather than the image itself.

Endpoint: https://api.fontrocker.com/v1/hires

As a result you will get an HTTP code 201 (created) with a Job-ID

Caution: These images are getting pretty big, pretty soon!

The output format for the preview image png.