API'er til udviklere

Customix Integrations API lader dig hente dine personaliserede ordrer ind i dine egne systemer – de trykfiler, Customix har genereret, og alt, hvad dine kunder har indtastet under personaliseringen, f.eks. navne, tilpasset tekst, farver og valgte layouts. Brug det, når et produktionsværktøj, et regneark eller en automatiseringsplatform som Make har brug for dine ordreoplysninger, uden at nogen skal kopiere dem manuelt.

For at få en API-nøgle skal du gå til Indstillinger i sidepanelet til venstre, åbne fanen Integrationer og derefter klikke på Opret nøgle i kortet API-nøgle. Se Sådan får du en Customix API-nøgle for flere oplysninger.

🔑 Godkendelse

Alle forespørgsler kræver din API-nøgle i headeren:

Authorization: Bearer <your_api_key>

🌐 Basis-URL

https://app.customix.io/api/integrations/v1

📘 Endpoints

1. Hent liste over ordrer

Endpoint:

GET /orders

Beskrivelse: Hent dine personaliserede ordrer, som standard med de nyeste først.

Parametre:

Headers:

Eksempel på forespørgsel:

GET https://app.customix.io/api/integrations/v1/orders?shop=abcdef&limit=2

Svar:

{
  "data": [
    {
      "shop": "abcdef.myshopify.com",
      "order_id": 123456789,
      "order_number": "#1001",
      "currency": "USD",
      "customer": "John Doe",
      "email": "[email protected]",
      "ip": "123.123.123.123",
      "total_price": 123.45,
      "financial_status": "paid",
      "fulfillment_status": "fulfilled",
      "ordered_at": "2025-01-21 01:01:01",
      "customizations": [
        {
          "id": "01jjavmg7t7vqj5z6qvxwie14b",
          "public_customization_id": "01jjavmg7t7vqj5z6qvxwpc9kd",
          "campaign_id": "01jphjdfmtxhaio94h0wd0kv0c",
          "shopify_line_item_id": 11106133639222,
          "shopify_product_id": 11179841648222,
          "shopify_variant_id": 11191300929074,
          "platform": "shopify",
          "line_item_quantity": 1,
          "files": [
            {
              "id": "01jb3092vabc7m8qw4cdqv09we",
              "name": "default",
              "path": "https://d6opbaohxg209.cloudfront.net/temp/extracted_67d7d664c7awe/Accessory/Laptop.png"
            }
          ],
          "values": [
            { "key": "100001", "label": "Name", "type": "text-field", "value": "Emma" },
            { "key": "layout_100003", "label": "Layout", "type": "layout-swatch", "value": "Portrait" },
            { "key": "100004", "label": "Color", "type": "color-picker", "value": "#1a2b3c" }
          ]
        }
      ]
    }
  ]
}

Fejlsvar:

2. Hent en bestemt ordre

Endpoint:

GET /orders/{id}

Beskrivelse: Hent én ordre med dens trykfiler og personaliseringsværdier.

Parametre:

Headers:

Eksempel på forespørgsel:

GET https://app.customix.io/api/integrations/v1/orders/123456789?shop=abcdef

Svar: én enkelt ordre i data med de samme felter som ét element i listen ovenfor:

{
  "data": {
    "shop": "abcdef.myshopify.com",
    "order_id": 123456789,
    "order_number": "#1001",
    "customizations": [
      {
        "id": "01jjavmg7t7vqj5z6qvxwie14b",
        "public_customization_id": "01jjavmg7t7vqj5z6qvxwpc9kd",
        "line_item_quantity": 1,
        "files": [
          { "id": "01jb3092vabc7m8qw4cdqv09we", "name": "default", "path": "https://d6opbaohxg209.cloudfront.net/temp/extracted_67d7d664c7awe/Accessory/Laptop.png" }
        ],
        "values": [
          { "key": "100001", "label": "Name", "type": "text-field", "value": "Emma" }
        ]
      }
    ]
  }
}

(Forkortet her – det rigtige svar indeholder alle felter, der vises i listeeksemplet.)

Fejlsvar:

3. Hent en bestemt ordres tilpasning

Endpoint:

GET /orders/{order_id}/customizations/{public_customization_id}

Beskrivelse: Hent én tilpasning fra en ordre.

Parametre:

Headers:

Eksempel på forespørgsel:

GET https://app.customix.io/api/integrations/v1/orders/123456789/customizations/01jjavmg7t7vqj5z6qvxwpc9kd?shop=abcdef

Svar: selve tilpasningen, ikke pakket ind i data:

{
  "id": "01jjavmg7t7vqj5z6qvxwie14b",
  "public_customization_id": "01jjavmg7t7vqj5z6qvxwpc9kd",
  "campaign_id": "01jphjdfmtxhaio94h0wd0kv0c",
  "shopify_line_item_id": 11106133639222,
  "shopify_product_id": 11179841648222,
  "shopify_variant_id": 11191300929074,
  "platform": "shopify",
  "line_item_quantity": 1,
  "files": [
    {
      "id": "01jb3092vabc7m8qw4cdqv09we",
      "name": "default",
      "path": "https://d6opbaohxg209.cloudfront.net/temp/extracted_67d7d664c7awe/Accessory/Laptop.png"
    }
  ],
  "values": [
    { "key": "100001", "label": "Name", "type": "text-field", "value": "Emma" },
    { "key": "layout_100003", "label": "Layout", "type": "layout-swatch", "value": "Portrait" }
  ]
}

Fejlsvar:

🖊️ Tilpasningsværdier

Hver tilpasning indeholder values – ét element for hvert personaliseringsfelt, der er gemt sammen med ordren, de samme oplysninger, som du ser som varegenskaber på ordren i Shopify. Hvert element har:

• key: feltets identifikator i din skabelon. Den er den samme fra ordre til ordre for det samme felt i den samme skabelon, så brug den til at kortlægge felter i din integration.
• label: det navn på valgmuligheden, som dine kunder så, f.eks. "Name". Det kan være tomt på ældre ordrer.
• type: valgmulighedens art, f.eks. text-field, color-picker, font-swatch, image-swatch, layout-swatch, date-picker eller file-upload.
• value: det, din kunde har valgt eller indtastet, altid som tekst.

Sådan læses value for hver type valgmulighed:

• Tekst: præcis det, din kunde skrev.
• Farvevælger: den farvekode, din kunde valgte.
• Farveprøver for skrifttype, billede, farve og streg: værdien af den farveprøve, din kunde valgte.
• Layoutfarveprøver: navnet på det layout, din kunde valgte, som det hed, da ordren blev afgivet.
• Dato- og tidsvælgere: den dato eller det tidspunkt, din kunde valgte.
• Fil- og vektoruploads: et link til den fil, din kunde uploadede.
• Paletter og skrifttyper til ordskyer: de farver eller skrifttyper, din kunde valgte, adskilt af kommaer.
• Valgmuligheder uden en tekstform, f.eks. kortstile, steder eller Spotify-numre, returneres med en tom værdi – brug trykfilerne til dem.

⚠️ Almindelige fejlkoder

📌 Bemærkninger

• Alle svar er i JSON.
• Hastighedsgrænse: 2 requests/second.
• Kontakt [email protected] ved spørgsmål.

Opdateret den: 14/09/2026