API-er for utviklere

Med Customix Integrations API kan du hente de personaliserte ordrene dine inn i egne systemer – trykkfilene Customix har generert og alt kundene dine la inn under personaliseringen, for eksempel navn, egendefinert tekst, farger og valgte oppsett. Bruk det når et produksjonsverktøy, et regneark eller en automatiseringsplattform som Make trenger ordredetaljene dine uten at noen må kopiere dem for hånd.

For å få en API-nøkkel går du til Innstillinger i sidefeltet til venstre, åpner fanen Integrasjoner og klikker på Opprett nøkkel i kortet API-nøkkel. Se Slik henter du Customix API-nøkkelen for detaljer.

🔑 Autentisering

Alle forespørsler krever API-nøkkelen din i headeren:

Authorization: Bearer <your_api_key>

🌐 Basis-URL

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

📘 Endepunkter

1. Hent liste over ordrer

Endepunkt:

GET /orders

Beskrivelse: Henter de personaliserte ordrene dine, som standard med de nyeste først.

Parametere:

Headere:

Eksempelforespørsel:

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

Feilsvar:

2. Hent en bestemt ordre

Endepunkt:

GET /orders/{id}

Beskrivelse: Henter én ordre med trykkfilene og personaliseringsverdiene.

Parametere:

Headere:

Eksempelforespørsel:

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

Svar: én enkelt ordre i data, med de samme feltene som én oppføring 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 faktiske svaret inneholder alle feltene som vises i listeeksempelet.)

Feilsvar:

3. Hent tilpasningen til en bestemt ordre

Endepunkt:

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

Beskrivelse: Henter én tilpasning i en ordre.

Parametere:

Headere:

Eksempelforespørsel:

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

Svar: selve tilpasningen, ikke pakket inn 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" }
  ]
}

Feilsvar:

🖊️ Tilpasningsverdier

Hver tilpasning inneholder values – én oppføring for hvert personaliseringsfelt som er lagret med ordren, de samme detaljene som du ser som varegenskaper på ordren i Shopify. Hver oppføring har:

• key: identifikatoren til feltet i malen din. Den er den samme fra ordre til ordre for det samme feltet i den samme malen, så bruk den til å tilordne felt i integrasjonen din.
• label: alternativnavnet kundene dine så, for eksempel «Name». Den kan være tom på eldre ordrer.
• type: typen alternativ, for eksempel text-field, color-picker, font-swatch, image-swatch, layout-swatch, date-picker eller file-upload.
• value: det kunden din valgte eller skrev inn, alltid som tekst.

Slik ser value ut for hver type alternativ:

• Tekst: nøyaktig det kunden din skrev.
• Fargevelger: fargekoden kunden din valgte.
• Fargeprøver for skrift, bilde, farge og kontur: verdien til fargeprøven kunden din valgte.
• Fargeprøver for oppsett: navnet på oppsettet kunden din valgte, slik det het da kunden la inn ordren.
• Dato- og tidsvelgere: datoen eller tiden kunden din valgte.
• Fil- og vektoropplastinger: en lenke til filen kunden din lastet opp.
• Paletter og skrifter for ordskyer: fargene eller skriftene kunden din valgte, atskilt med komma.
• Alternativer som ikke har en tekstform, for eksempel kartstiler, steder eller Spotify-spor, returneres med en tom verdi – bruk trykkfilene for disse.

⚠️ Vanlige feilkoder

📌 Merknader

• Alle svar er i JSON.
• Hastighetsgrense: 2 requests/second.
• Kontakt [email protected] hvis du har spørsmål.

Oppdatert: 14.09.2026