Publikt API för tryckfiler

Base URL: https://app.customix.io/api

Autentisering: Så hämtar du din Customix API Key

Authorization: Bearer {your-api-token}

Hastighetsbegränsning (rate limit): 100 anrop per minut (per användare)

Översikt

Skicka in en produktanpassning som vanlig flerradig text och få tillbaka en lista med
URL:er till tryckfilerna för den inskickningen.

Skapa tryckfiler

POST /print-files

Request body

FältTypObligatoriskBeskrivning
shop_namestringJaDitt butiksnamn (t.ex. my-etsy-shop)
namestringJaNamnet på en mall som du äger i den här butiken. Den första mallen som matchar namnet används.
contentstringJaFlerradig anpassning. Varje rad är <option name>: <value>. Inledande - är valfritt.

Innehållsformat

Varje rad kopplar ett anpassningsbart alternativ i mallen till ett värde.

  • Alternativnamn matchas utan hänsyn till versaler och gemener, och omgivande blanksteg ignoreras.
  • Text-, färg- och datumalternativ tar värdet bokstavligt – till exempel

Harry, #ffffff, 2026-12-25.

  • Färgprovsalternativ (typsnitt, bild, färg, layout osv.) tar ett heltal som

väljer ett av de tillgängliga färgprovsvärdena. Som standard väljer 1 det första
värdet, 2 det andra och så vidare.

Exempel:

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

Svar 201

{
  "id": "01jyz5kqxz2hrcwqzdq4jdv7r9",
  "print_file_urls": [
    "https://.../1.png",
    "https://.../2.png"
  ]
}
FältTypBeskrivning
idstringIdentifierare för inskickningen
print_file_urlsstring[]En URL per tryckfil i mallen, i mallens ordning

Tryckfilerna blir tillgängliga på de returnerade URL:erna när genereringen är klar
(vanligtvis några sekunder efter svaret).

Felsvar

StatusBodyOrsak
401{"message": "Unauthenticated."}Bearer-token saknas eller är ogiltig
403{"message": "Unauthenticated"}Token är giltig men anroparen har inte åtkomst till shop_name
404{"message": "Template not found: …"}Det finns ingen mall med det name i den här butiken
422{"errors": {"shop_name": […], "name": […], "content": […]}}Obligatoriska fält saknas
422{"message": "Unknown option: <name>"}En rad refererar till ett alternativ som inte finns i mallen
422{"message": "Swatch index N is out of range for option '…' …"}Färgprovsindex ligger utanför det tillgängliga intervallet
422{"message": "Option '…' expects an integer swatch index, got …"}Ett värde som inte är ett heltal skickades till ett färgprovsalternativ

Exempelanrop

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

Uppdaterad: 20/05/2026