Offentlig API for trykkfiler

Basis-URL: https://app.customix.io/api

Autentisering: Slik henter du Customix API-nøkkelen

Authorization: Bearer {your-api-token}

Hastighetsgrense: 100 forespørsler per minutt (per bruker)

Oversikt

Send inn en produkttilpasning som ren tekst over flere linjer, og få tilbake en liste over
URL-er til trykkfilene for den innsendingen.

Opprett trykkfiler

POST /print-files

Forespørselsinnhold

FeltTypePåkrevdBeskrivelse
shop_namestringJaButikknavnet ditt (f.eks. my-etsy-shop)
namestringJaNavnet på en mal du eier i denne butikken. Den første malen som samsvarer med navnet, brukes.
contentstringJaTilpasning over flere linjer. Hver linje er <option name>: <value>. Innledende - er valgfritt.

Innholdsformat

Hver linje tilordner ett tilpassbart alternativ i malen til en verdi.

  • Alternativnavn sammenlignes uten hensyn til store og små bokstaver, og omkringliggende mellomrom ignoreres.
  • Tekst-, farge- og datoalternativer tar verdien bokstavelig – for eksempel

Harry, #ffffff, 2026-12-25.

  • Fargeprøvealternativer (skrift, bilde, farge, oppsett osv.) tar et heltall som

velger én av de tilgjengelige fargeprøveverdiene. Som standard velger 1 den første
verdien, 2 den andre, og så videre.

Eksempel:

- Enter your name: Harry
- Text color: #ffffff
- Font: 1

Svar 201

{
  "id": "01jyz5kqxz2hrcwqzdq4jdv7r9",
  "print_file_urls": [
    "https://.../1.png",
    "https://.../2.png"
  ]
}
FeltTypeBeskrivelse
idstringIdentifikator for innsendingen
print_file_urlsstring[]Én URL per trykkfil i malen, i malens rekkefølge

Trykkfilene blir tilgjengelige på de returnerte URL-ene når genereringen er ferdig
(vanligvis noen sekunder etter svaret).

Feilsvar

StatusInnholdÅrsak
401{"message": "Unauthenticated."}Manglende eller ugyldig bearer-token
403{"message": "Unauthenticated"}Tokenet er gyldig, men den som sender forespørselen har ikke tilgang til shop_name
404{"message": "Template not found: …"}Det finnes ingen mal med dette name i denne butikken
422{"errors": {"shop_name": […], "name": […], "content": […]}}Manglende påkrevde felt
422{"message": "Unknown option: <name>"}En linje refererer til et alternativ som ikke finnes i malen
422{"message": "Swatch index N is out of range for option '…' …"}Fargeprøveindeksen er utenfor det tilgjengelige området
422{"message": "Option '…' expects an integer swatch index, got …"}En verdi som ikke er et heltall, ble sendt til et fargeprøvealternativ

Eksempelforespørsel

curl -X POST 'https://app.customix.io/api/print-files' \
  -H 'Authorization: Bearer 01jyz0z…|abc…' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  -d '{
    "shop_name": "my-etsy-shop",
    "name": "My Template",
    "content": "- Enter your name: Harry\n- Text color: #ffffff\n- Font: 1"
  }'

Oppdatert: 20.05.2026