Offentligt API til trykfiler

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

Godkendelse: Sådan får du en Customix API-nøgle

Authorization: Bearer {your-api-token}

Hastighedsgrænse: 100 forespørgsler pr. minut (pr. bruger)

Oversigt

Send en produkttilpasning som almindelig tekst på flere linjer, og få en liste med
URL'er til trykfiler for den pågældende indsendelse tilbage.

Opret trykfiler

POST /print-files

Forespørgselskrop

FeltTypePåkrævetBeskrivelse
shop_namestrengJaDit butiksnavn (f.eks. my-etsy-shop)
namestrengJaNavnet på en skabelon, du ejer i denne butik. Den første skabelon, der matcher navnet, bruges.
contentstrengJaTilpasning på flere linjer. Hver linje er <option name>: <value>. Et indledende - er valgfrit.

Indholdsformat

Hver linje knytter én tilpasselig valgmulighed på skabelonen til en værdi.

  • Navne på valgmuligheder matches uden hensyn til store og små bogstaver, og omgivende mellemrum ignoreres.
  • Tekst-, farve- og datovalgmuligheder tager værdien bogstaveligt – for eksempel

Harry, #ffffff, 2026-12-25.

  • Farveprøve-valgmuligheder (skrifttype, billede, farve, layout osv.) tager et heltal, der

vælger en af de tilgængelige farveprøveværdier. Som standard vælger 1 den første
værdi, 2 den anden 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
idstrengIdentifikator for indsendelsen
print_file_urlsstring[]Én URL pr. trykfil på skabelonen, i skabelonens rækkefølge

Trykfilerne bliver tilgængelige på de returnerede URL'er, når genereringen er færdig
(typisk få sekunder efter svaret).

Fejlsvar

StatusKropÅrsag
401{"message": "Unauthenticated."}Manglende eller ugyldigt bearer-token
403{"message": "Unauthenticated"}Tokenet er gyldigt, men den, der kalder, har ikke adgang til shop_name
404{"message": "Template not found: …"}Der findes ingen skabelon med det name i denne butik
422{"errors": {"shop_name": […], "name": […], "content": […]}}Påkrævede felter mangler
422{"message": "Unknown option: <name>"}En linje refererer til en valgmulighed, der ikke findes på skabelonen
422{"message": "Swatch index N is out of range for option '…' …"}Farveprøveindekset ligger uden for det tilgængelige interval
422{"message": "Option '…' expects an integer swatch index, got …"}Der er sendt en værdi, der ikke er et heltal, til en farveprøvevalgmulighed

Eksempel på forespørgsel

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"
  }'

Opdateret den: 20/05/2026