PARTNERINTEGRATION MED CR80

Integrér CR80 på dit websted

Tilslut CR80-editoren til dit websted med en iframe. Her finder du konfiguration, JavaScript-eksempler og API'er til at modtage og bruge CR80-design i dit system.

HTTP-vejledning til AI-agenter (på engelsk) · JSON Schema v1 · Exempeldesign

  1. Når din ansøgning er godkendt, skal du åbne partnerportalen og logge ind med den verificerede e-mailadresse fra ansøgningen. Aktivér din invitation dér.
  2. Åbn partnerindstillingerne. Angiv dit brand, de præcise tilladte HTTPS-origins og dit sortiment af fysiske kort. Hvert materiale og hver teknologi har sit eget varenummer (SKU).
  3. Erstat YOUR_PARTNER_ID i eksemplerne med partner-ID'et fra indstillingerne. Det er en offentlig identifikator. Licensnøgler og API-hemmeligheder bruges kun på serveren.
  4. I testtilstand mærkes forhåndsvisninger med PROVPERIOD, og editoren sender cr80-test-design. Produktions-API'erne bliver tilgængelige, når partnerens produktionsadgang er aktiveret.

Indlejr editoren

Tilføj dit websteds origin i partnerindstillingerne, inklusive protokol og en eventuel port, der afviger fra standard. Siden, som indlejrer editoren, skal matche en godkendt origin. Brug HTTPS i produktion.

<iframe id="cr80-editor"
  src="https://cr80.se/editor?partner=YOUR_PARTNER_ID&embed=1"
  title="Card editor"
  style="width:100%;height:760px;border:0"
></iframe>

Partneren vælger brand, sortiment og tilgængelige funktioner. Indlejring i browseren giver ikke adgang til konti. CR80-konti og partnerens kundekonti er fortsat adskilte.

Modtag et design sikkert

Editoren sender designet til værtsiden via postMessage. Eksemplet filtrerer efter CR80's origin, iframe-vinduet, partner-ID og meddelelsestype. Meddelelsen indeholder name og design. Testtilstand bruger cr80-test-design med test: true; aktiv produktionsadgang bruger cr80-design med test: false.

const frame = document.getElementById("cr80-editor");
const partnerId = "YOUR_PARTNER_ID";
window.addEventListener("message", (event) => {
  if (event.origin !== "https://cr80.se") return;
  if (event.source !== frame.contentWindow) return;
  const message = event.data;
  if (!message || message.partner !== partnerId) return;
  if (message.type === "cr80-test-design" && message.test === true) {
    // Test-mode completion uses a separate message type.
    document.getElementById("result").textContent = "Test design received";
    return;
  }
  if (message.type !== "cr80-design" || message.test !== false) return;
  // message.design contains the versioned CR80 design document.
  // Pass it to your backend to continue your integration.
  document.getElementById("result").textContent = message.name;
});

JavaScript-eksemplet gælder kun kommunikationen mellem iframe og værtssiden i browseren. Server-API'erne nedenfor bruger almindelige HTTP-kald og JSON og er uafhængige af programmeringssprog.

Opret et resultatelement på siden: <p id="result" role="status"></p>. Eksemplet viser designets navn i elementet. Meddelelsen overfører et design og opretter ikke en ordre. Validering og eventuel ordrebehandling sker i din serverintegration.

API'er og designkontrakten

Offentlige partner-API'er til læsning
API-adresseFormål
GET /api/partner/config?id=IDBrand, godkendte origins, funktioner og adgangstilstand.
GET /api/partner/catalog?id=IDVarenumre for fysiske kort og offentlig tilgængelighed.

Designformatet er versionsstyret JSON. Når et design gemmes og genåbnes, bruges hele dokumentet, inklusive version og eventuelle udvidelsesfelter. Mål angives i millimeter og beløb som heltalsøre. Det valgte varenummer (SKU) forbinder designet med partnerens materiale, teknologi og efterbehandling.

CR80 bruger det samme designformat til forhåndsvisninger og produktionsfiler. Produktionsgengivelse indgår i serverintegrationen.

Signerede starter, administrerede kundeidentiteter, produktionsgengivelse og SPI bruger serverautentisering med afgrænsede rettigheder. De er adskilt fra iframe-integrationen og aktiveres for den enkelte partner. Partner-ID'et bruges til identifikation, ikke autentisering.

Gengiv en designfil via API

En eksporteret .cr80.json-fil er designobjektet, som sendes i feltet design. API'erne modtager JSON, ikke multipart-upload. Du behøver hverken en åben editor eller en lokal printer til PNG-forhåndsvisning eller PDF-eksport.

Serverautentisering

API'erne bruger HTTPS og JSON og kan kaldes fra et hvilket som helst serversprog. Eksemplerne viser metode, sti, headers og JSON direkte, uden SDK eller et særligt runtime-miljø. CR80 aktiverer maskinadgang for en aktiv partnerorganisation med en produktionskontrakt i version 1. Dette er adskilt fra den offentlige iframe-konfiguration.

Vælg X-CR80-Contract for hvert API som vist i tabellen. Maskinadgangsnøglen skal blive på serveren. Godkendte iframe-origins giver ikke browseren adgang til disse server-API'er.

Endpoints til gengivelse og eksport
API-adresseX-CR80-ContractSvar
POST /api/production/previewprint-station-v1PNG-billede
GET /api/production/export-profilesprint-export-v1JSON med profiles
POST /api/production/exportsprint-export-v1JSON med download-URL
GET /api/production/exports/{id}print-export-v1ZIP med PDF og produktionsdata

Autentiseringsheaders

Basisadressen er https://cr80.se. Erstat YOUR_PARTNER_ID og YOUR_MACHINE_CREDENTIAL med dine serveroplysninger. Send hele designfilens JSON-objekt i design. Eksemplerne bruger et lille navnekort; erstat også white-pvc med dit korts SKU. Din HTTP-klient serialiserer JSON og håndterer transportheaders som Content-Length. Tillad op til 180 sekunder til gengivelse.

X-CR80-Contract: print-station-v1
X-CR80-Partner: YOUR_PARTNER_ID
X-License-Key: YOUR_MACHINE_CREDENTIAL

PNG-forhåndsvisning

POST /api/production/preview returnerer image/png med HTTP 200. Forhåndsvisningen gengives ved 100 dpi med CR80's fælles renderingsmotor. Svaret cachelagres ikke, og anmodningen gemmer ikke et design. Testtilstand tilføjer vandmærket PROVPERIOD.

Anmodningsfelter til forhåndsvisning
FeltBeskrivelse
schemaVersionPåkrævet. API-kontraktets version, altid 1. Designets eget versionsnummer findes i design.version.
designPåkrævet. Hele JSON-objektet fra designfilen.
renderedAtPåkrævet. Et ISO 8601-tidspunkt i UTC, f.eks. 2026-09-21T12:00:00.000Z. Fastlåser tidsafhængige felter under gengivelsen.
sideValgfrit: front eller back. Standard er front.
rowValgfrit objekt med kolonnenavne og strengværdier for kortet, der vises. Brug de samme kolonnenavne som designets datafelter.
rowIndex / rowCountValgfrit: nulbaseret rækkeindeks og samlet antal rækker. Standardværdierne er 0 og 1. Send den aktuelle række separat i row.
POST /api/production/preview HTTP/1.1
Host: cr80.se
X-CR80-Contract: print-station-v1
X-CR80-Partner: YOUR_PARTNER_ID
X-License-Key: YOUR_MACHINE_CREDENTIAL
Content-Type: application/json

{
  "schemaVersion": 1,
  "design": {
    "version": 1,
    "name": "Example card",
    "orientation": "portrait",
    "baseCardSku": "white-pvc",
    "front": {
      "background": "#ffffff",
      "layers": [
        {
          "id": "name",
          "type": "text",
          "x": 6,
          "y": 15,
          "widthMm": 42,
          "fontSizeMm": 4,
          "text": "{name}"
        }
      ]
    }
  },
  "side": "front",
  "row": {
    "name": "Sample Person"
  },
  "rowIndex": 0,
  "rowCount": 2,
  "renderedAt": "2026-09-21T12:00:00.000Z"
}

Svar

HTTP/1.1 200 OK
Content-Type: image/png
Cache-Control: private, no-store

[binary PNG body]

Gem svarets binære indhold som en PNG-fil. Sæt side til back for bagsiden. Ved flere kort sendes én anmodning pr. side og række; tilpas row, rowIndex og rowCount til din datatabel.

PDF-eksport

1. Hent en eksportprofil

Partnerens eksportprofil angiver PDF/X-4 eller PDF/X-1a:2001, CMYK/ICC-profilen, beskæringstillæg, skæremærker og siderækkefølge. Konfigurér den under Partnerportalen → Trykfiler. GET /api/production/export-profiles returnerer kun den autentiserede partners aktive profiler.

GET /api/production/export-profiles HTTP/1.1
Host: cr80.se
X-CR80-Contract: print-export-v1
X-CR80-Partner: YOUR_PARTNER_ID
X-License-Key: YOUR_MACHINE_CREDENTIAL

Svaret er et objekt med profiles. Hver post indeholder bl.a. id, revision, profile, iccSha256 og card. Objektet profile indeholder bl.a. sku, standard og pageOrder. Uden profileId vælger eksporten den aktive profil for design.baseCardSku. Med profileId låses valget til en bestemt profilrevision; en forældet revision giver 409.

2. Forbered eksportens JSON

Feltet rows indeholder præcis de kort, der skal med, ét objekt pr. kort. Værdierne er strenge, og nøglerne svarer til designets datafelter. Brug [{}, {}] til to identiske kort uden datafelter. API'et vælger ikke automatisk rækker fra designfilens indbyggede datatabel.

[
  {
    "name": "Sample Person"
  },
  {
    "name": "Another Person"
  }
]
Anmodningsfelter til PDF-eksport
FeltBeskrivelse
schemaVersionPåkrævet. API-kontraktets version, altid 1. Designets eget versionsnummer findes i design.version.
designPåkrævet. Hele JSON-objektet fra designfilen.
requestKeyPåkrævet UUID, der identificerer eksporten. Brug samme nøgle og JSON ved genforsøg.
rowsPåkrævet: 1–100 objekter med strengværdier. Hvert objekt giver ét kort; eksportprofilen bestemmer, hvilke sider der indgår.
profileIdValgfrit UUID fra profilens id. Udelad det for automatisk valg ud fra design.baseCardSku.
renderedAtPåkrævet. Et ISO 8601-tidspunkt i UTC, f.eks. 2026-09-21T12:00:00.000Z. Fastlåser tidsafhængige felter under gengivelsen.

Opret et nyt UUID i requestKey for hver ny eksport, og angiv gengivelsestidspunktet i renderedAt. Erstat eksempelværdierne nedenfor ved en ny eksport. Gem anmodningen i dit system, så hele JSON-indholdet, inklusive nøgle og tidspunkt, kan genbruges ved genforsøg.

3. Opret og hent trykfilen

POST /api/production/exports returnerer HTTP 200 med id, downloadUrl, ticket og expiresAt, når eksporten er klar. Eksporten starter ikke udskrivning og opretter ikke en ordre.

POST /api/production/exports HTTP/1.1
Host: cr80.se
X-CR80-Contract: print-export-v1
X-CR80-Partner: YOUR_PARTNER_ID
X-License-Key: YOUR_MACHINE_CREDENTIAL
Content-Type: application/json

{
  "schemaVersion": 1,
  "requestKey": "5dc49711-acb9-4a92-8ed6-b6f9d0617625",
  "design": {
    "version": 1,
    "name": "Example card",
    "orientation": "portrait",
    "baseCardSku": "white-pvc",
    "front": {
      "background": "#ffffff",
      "layers": [
        {
          "id": "name",
          "type": "text",
          "x": 6,
          "y": 15,
          "widthMm": 42,
          "fontSizeMm": 4,
          "text": "{name}"
        }
      ]
    }
  },
  "rows": [
    {
      "name": "Sample Person"
    },
    {
      "name": "Another Person"
    }
  ],
  "renderedAt": "2026-09-21T12:00:00.000Z"
}

Eksempelsvar (udvalgte felter; ticket udeladt)

HTTP/1.1 200 OK
Content-Type: application/json
Cache-Control: private, no-store

{
  "id": "export-aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "downloadUrl": "/api/production/exports/export-aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "expiresAt": "2026-09-22T12:00:00.000Z"
}

Hent ZIP-filen

Brug stien i svarets downloadUrl til det næste GET-kald til https://cr80.se med samme print-export-v1-autentisering. Gem svarets binære indhold som en ZIP-fil, og læs print.pdf fra den.

GET /api/production/exports/export-aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa HTTP/1.1
Host: cr80.se
X-CR80-Contract: print-export-v1
X-CR80-Partner: YOUR_PARTNER_ID
X-License-Key: YOUR_MACHINE_CREDENTIAL
HTTP/1.1 200 OK
Content-Type: application/zip
Cache-Control: private, no-store

[binary ZIP body]

ZIP-filen indeholder print.pdf, production.json og LAS-MIG.txt. Ticket og production.json beskriver bl.a. den fastlåste profilrevision, sidernes kobling til datarækker, geometri og filhashes. Downloadadressen er privat, kræver autentisering og gælder i 24 timer som angivet i expiresAt.

Genforsøg og grænser

Ved timeout eller midlertidig fejl skal den samme POST-anmodning sendes igen med uændret JSON-indhold. Et identisk genforsøg returnerer den oprindelige eksport, selv hvis profilen senere er ændret. Ændret JSON med samme requestKey giver 409. En udløbet eksport giver 410 og kræver en ny anmodning med en ny nøgle.

Maksimal anmodningsstørrelse er 32 MB. PDF-eksport tillader højst 100 kort og en PDF på 100 MB. Forhåndsvisning tillader 60 anmodninger/minut; PDF-eksport tillader 10 skrivninger og 120 læsninger/minut pr. organisation og serverproces. Kun én PDF-forberedelse kører ad gangen pr. serverproces. Ved 429 skal klienten vente, før samme anmodning sendes igen.

PDF-kontrakten understøtter ikke UV-/hologrampaneler, magnet- eller chipkodning, staffagefarver, PDF/VT eller udskydning på trykark. Sådant input afvises eller falder uden for dette API.

Svar og fejlkoder

Fejlsvar er JSON med error. Nogle indeholder også code, issues eller agreementUrl. Klienten bør bruge HTTP-status og eventuelt code i stedet for at fortolke den oversættelige fejltekst.

HTTP-statusser for gengivelses- og eksport-API'erne
StatusBeskrivelse
400Ugyldig JSON, ugyldigt design eller ugyldig anmodningsstørrelse.
401Manglende eller ugyldig autentisering, herunder forkert kontraktheader.
403Utilstrækkelig adgang, ikke-godkendt origin eller produktion, der ikke er aktiveret (PARTNER_PRODUCTION_NOT_ACTIVE).
404Eksporten findes ikke i den autentiserede organisation.
409Anmodningsnøglen er genbrugt med andet indhold, eller eksportprofilen er forældet eller mangler.
410Eksporten er udløbet eller slettet.
415POST kræver Content-Type: application/json.
422Designet kunne ikke gengives eller matcher ikke eksportprofilen. PDF-valideringsfejl kan indeholde issues.
428Organisationens gældende databehandleraftale mangler (PROCESSOR_AGREEMENT_REQUIRED). Svaret angiver agreementUrl.
429Anmodningsgrænsen er nået, eller PDF-renderingsmotoren er optaget.
503Aftaletjenesten er midlertidigt utilgængelig (PROCESSOR_AGREEMENT_UNAVAILABLE).

Eksempel på et 422-svar

{
  "error": "Designet opfylder ikke trykkeriets krav.",
  "issues": [
    "Kort 1 mangler data i kolonnerne: name."
  ]
}

Organisationseksport og skift af tjeneste

En verificeret ejer eller administrator kan hente en gratis eksport under Konto → Organisationseksport. Eksporten er også tilgængelig efter aftalens udløb eller arkivering. Du behøver ikke et nyt abonnement eller en ny aftale for at hente eksisterende data.

Design og overdragelser
Versionsstyret CR80-JSON med indlejrede billeder og skrifttyper, varianter og datarækker. Kun design, der udtrykkeligt er knyttet til organisationen, indgår. Overdragelsens oprindelige kopi tilhører den afsendende organisation; modtagne kopier tilhører modtagerens konto.
Partnerindstillinger
Branding, tilladte origins, kortsortiment, kanal-/udbyderrevisioner og PDF-eksportprofiler. ICC-data er base64-kodet med SHA-256.
Produktionshistorik
Indsendte ordredesign og datarækker, leverancer, stationsindstillinger, uforanderlige jobdata, kvitteringer pr. kort og instruktioner til gendannelse. Ordrer, der kun vedrører produktion, omfatter ikke en anden sælgers detailpriser eller fakturaer.
Fakturering og aftaler
Organisationens faktureringskonto, abonnementer, fakturalinjer, faktura-PDF som base64, partnerfakturaer og afregninger, databehandleraftalens kildedokumenter og acceptdokumentation samt det accepterede partnertilbud.

Format og afgrænsning

Nummererede ZIP-dele indeholder UTF-8 JSON-sider og et manifest med SHA-256. Mål er i millimeter, og beløb er heltalsøre. Gem alle dele. Hver side læses konsistent, men den samlede eksport er ikke et øjebliksbillede af databasen: sæt redigering på pause før en endelig overførsel. Poster oprettet efter eksportens skæringstidspunkt udelades; ændringer og sletninger kan påvirke sider, der endnu ikke er læst. Hardware-rapporter viser tilstanden ved hentning af hver side.

Udeladt: adgangskoder, API-/stations-/OAuth-adgangsoplysninger, andre organisationers data, personlige design, kundeejede modtagne kopier, CR80-software og standardskabeloner, midlertidige browsersessioner, udløbne delinger og midlertidige produktionsfiler. Eksterne URL'er forbliver referencer; filer, der kun findes i en browser, et partnersystem eller på en ekstern URL, skal overføres fra deres ejer. Eksisterende downloads af tryk-PDF'er beholder deres egen gyldighed på 24 timer. Eksport af kildedata opretter ikke nye produktionsfiler eller udskriver kort.

HTTP-grænseflade

Disse kontoendpoints kræver ejerens eller administratorens CR80-browsersession. Partnerens maskinadgang kan ikke eksportere en hel organisation. GET /api/account/organization-export viser autoriserede organisationer (også arkiverede), kategorier og skæringstidspunkt. Send følgende JSON med POST til /api/account/organizations/{organizationId}/export med Content-Type: application/json, den præcise CR80 Origin og X-CR80-Data-Action: export-organization.

{
  "action": "page",
  "category": "designs",
  "after": "",
  "cutoff": "2026-09-21T12:00:00.000Z",
  "runId": "8c987cf9-6a43-433b-9e88-c9ed0bc984f0"
}

Brug et nyt UUID og det returnerede skæringstidspunkt. Følg nextCursor som after, indtil værdien er null, for hver kategori. Svaret indeholder records, receiptId og X-Export-SHA256 for svarets præcise bytes. Sider rummer højst 50 poster/8 MiB; én større post på op til 64 MiB er tilladt. Større poster kræver assisteret eksport. Grænsen er 120 anmodninger/minut pr. konto og serverproces. Gentag med samme markør ved 429/503; sammenlign kontrolsummer, da ændringer imellem forsøg kan ændre resultatet.

Kategoriidentifikatorer og præcise felter
organization
id, name, archived_at, created_at, updated_at
members
id, user_id, role, created_at
designs
id, user_id, name, design, project_id, revision, project_metadata, created_at, updated_at
shares
id, design_id, name, design, expires_at, revoked_at, created_at
quotes
id, retail, terms_version, target_working_days, expires_at, created_at
usage
id, event, origin, created_at
handovers
id, source_design_id, source_revision, recipient_email, customer_label, name, snapshot, expires_at, revoked_at, claimed_at, created_at
partners
id, name, config_version, logo_url, theme, allowed_origins, portal_url, pricing_url, catalog_url, pricing_visibility, capabilities, production_contract, fulfillment, fulfillment_label, destination_type, order_email, pricing, terms_url, design_guide_url, active, created_at
catalogue
id, partner_id, slug, name, technology, subtype, color, color_name, surcharge_ore, stock_quantity, oversell, active, sort_order, created_at
channels
id, legacy_partner_id, enabled, current_revision, created_at, updated_at
channel_revisions
id, branded_channel_id, revision, snapshot, created_at
providers
id, visibility, current_revision, created_at, updated_at
provider_revisions
id, fulfilment_provider_id, revision, snapshot, created_at
export_profiles
id, partner_id, sku, revision, profile, icc_sha256, icc_base64, created_at
orders
id, partner_id, commercial_channel, design_name, design, data_csv, quantity, status, price_ore, partner_order_ref, partner_status, tracking_url, customer_email, customer_name, shipping_address, terms_accepted_at, terms_version, created_at
fulfilment_orders
id, design_name, design, data_csv, quantity, partner_order_ref, partner_status, tracking_url, shipping_address, created_at
stations
id, name, partner_id, service_version, last_seen_at, revoked_at, created_at, updated_at
printers
id, station_id, instance_id, display_name, configuration, report, health, last_seen_at
encoders
id, station_id, instance_id, display_name, kind, connection, health, last_seen_at
jobs
id, station_id, printer_instance_id, payload, state, created_at, updated_at
acknowledgements
id, job_id, card_id, payload, created_at
recoveries
id, job_id, card_id, payload, state, created_at, applied_at
billing_accounts
id, legal_name, organization_number, vat_number, invoice_email, invoice_reference, billing_address, currency, billing_enabled, terms_accepted_at, terms_version, created_at, updated_at
subscriptions
id, catalog_item_id, status, cadence, current_period_start, current_period_end, trial_ends_at, cancel_at_period_end, ended_at, unit_ore_snapshot, vat_basis_points_snapshot, entitlement_snapshot, created_at, updated_at
subscription_history
id, subscription_id, event_type, occurred_at, previous_status, next_status, previous_period_start, previous_period_end, next_period_start, next_period_end, cancel_at_period_end, ended_at, created_at
invoices
id, original_invoice_id, document_number, kind, state, payment_state, currency, total_ore, vat_ore, issue_date, due_date, pdf_base64, pdf_sha256, created_at
invoice_lines
id, invoice_id, position, description, quantity, unit_list_ore, list_ore, discount_ore, vat_base_ore, vat_basis_points, vat_ore, total_ore, created_at
partner_invoices
id, partner_id, month, status, editor_loads, designs_sent, order_count, order_value_ore, license_ore, commission_ore, created_at, updated_at
settlements
id, order_id, amount_ore, currency, status, provider_reference, created_at, updated_at
agreements
id, snapshot_id, legal_entity_name, organization_number, country_code, accepted_by_name, accepted_by_email, accepted_by_role, authority_confirmed, accepted_at
agreement_documents
id, document_id, version, sha256, title, markdown, source_url, captured_at
partner_acceptance
partner_id, accepted_at, pilot_ends_at, acceptance, approved_at

Når du har gemt og kontrolleret en del, skal du sende POST {action: "confirm", receipts: [{id: receiptId, sha256: responseHash}]} (højst 100 kvitteringer). CR80 gemmer kun metadata om forberedelse og bekræftelse af modtagelsen, ikke en ekstra kopi af kundens indhold. Bekræftelsen kan gentages sikkert.

Skift og ophør

Ved behov for assisteret overførsel, en stor post, et endeligt konsistent øjebliksbillede eller sletning: kontakt contact@premex.se med dit organisations-ID og ønskede resultat. CR80 verificerer din adgang og modtageren, dokumenterer omfang, tidspunkt og modtagelse og hjælper med sikker overførsel. Send ikke kortindehaverdata eller adgangsoplysninger via e-mail. Opsigelse af fakturering, dataudtræk og sletning er separate trin; arkiverede kildedata slettes ikke automatisk. Partneraftalen og databehandleraftalen regulerer frister, tilbagelevering, sletning og lovpligtig opbevaring.