Gå til innhold
ShopentlyLearn

Dataskjemaer: Produkter

Dataskjemaer: Produkter. Felter, typer og begrensninger for data som API-et mottar eller returnerer.

Dataskjemaer

ApiResponse_ProductFileListData_

ApiResponse_ProductFileListData_ · Felter, typer og begrensninger for data som API-et mottar eller returnerer. Last opp filer som multipart/form-data etter at upload_id er opprettet, og knytt dem til produktet. Nedlasting krever et Bearer-token og tilgang til category; svaret inneholder filens byte uten offentlig adresse eller passord. For mode=period velges days (1–3650) eller eksisterende months, aldri begge. Vilkårene lagres ved kjøpet; refusjon fjerner bare tilgang for den refunderte ordrelinjen.
dataProductFileListData Obligatorisk

Innholdet i et vellykket svar.

Eksempel: {"files":[{"category":"digital","created_at":"2026-01-01T12:00:00Z","current_version_id":"00000000-0000-4000-8000-000000000001","file_id":"00000000-0000-4000-8000-000000000001","filename":"manual.pdf","id":"00000000-0000-4000-8000-000000000001","label":"Manual","mime_type":"application/pdf","sha256":"5cd2f1cb0e5532b397e7ab1887baf6000c49450fd80ae279eb047c06e4545ecd","size_bytes":46,"state":"active","version_number":1}],"product_version":2}
metaContextPageMeta ContextMeta PageMeta RequestMeta Obligatorisk

Svarmetadata.

Eksempel: {"pagination":{"has_more":false,"limit":50,"next_cursor":null},"request_id":"example"}

Ytterligere felt: Nei

ApiResponse_ReleaseListData_

ApiResponse_ReleaseListData_ · Felter, typer og begrensninger for data som API-et mottar eller returnerer. Last opp filer som multipart/form-data etter at upload_id er opprettet, og knytt dem til produktet. Nedlasting krever et Bearer-token og tilgang til category; svaret inneholder filens byte uten offentlig adresse eller passord. For mode=period velges days (1–3650) eller eksisterende months, aldri begge. Vilkårene lagres ved kjøpet; refusjon fjerner bare tilgang for den refunderte ordrelinjen.
dataReleaseListData Obligatorisk

Innholdet i et vellykket svar.

Eksempel: {"current_release_id":"00000000-0000-4000-8000-000000000001","product_version":2,"releases":[{"changelog":"Manual update","files":[{"file_id":"00000000-0000-4000-8000-000000000001","sort_order":0,"version_id":"00000000-0000-4000-8000-000000000001"}],"id":"00000000-0000-4000-8000-000000000001","manifest_sha256":"1111111111111111111111111111111111111111111111111111111111111111","published_at":null,"release_sequence":null,"state":"active","version_label":"1.0","withdrawn_at":null}],"update_days":365,"update_mode":"period","update_months":null}
metaContextPageMeta ContextMeta PageMeta RequestMeta Obligatorisk

Svarmetadata.

Eksempel: {"pagination":{"has_more":false,"limit":50,"next_cursor":null},"request_id":"example"}

Ytterligere felt: Nei

ApiResponse_UploadData_

ApiResponse_UploadData_ · Felter, typer og begrensninger for data som API-et mottar eller returnerer. Last opp filer som multipart/form-data etter at upload_id er opprettet, og knytt dem til produktet. Nedlasting krever et Bearer-token og tilgang til category; svaret inneholder filens byte uten offentlig adresse eller passord. For mode=period velges days (1–3650) eller eksisterende months, aldri begge. Vilkårene lagres ved kjøpet; refusjon fjerner bare tilgang for den refunderte ordrelinjen.
dataUploadData Obligatorisk

Innholdet i et vellykket svar.

Eksempel: {"category":"digital","expires_at":"2026-01-01T12:00:00Z","filename":"manual.pdf","id":"00000000-0000-4000-8000-000000000001","product_id":"example","received_bytes":46,"sha256":"5cd2f1cb0e5532b397e7ab1887baf6000c49450fd80ae279eb047c06e4545ecd","size_bytes":46,"status":"ready"}
metaContextPageMeta ContextMeta PageMeta RequestMeta Obligatorisk

Svarmetadata.

Eksempel: {"request_id":"example"}

Ytterligere felt: Nei

ApiResponse[AudienceData]

ApiResponse_AudienceData_ · Les tilgangsregelen og produktversjonen. Første publisering er fortsatt tidsgrunnlaget.
dataAudienceData Obligatorisk

Innholdet i et vellykket svar.

Eksempel: {"anchor_at":"2026-11-03T12:00:00Z","effective_at":"2026-11-03T12:00:00Z","file_id":"00000000-0000-4000-8000-000000000007","file_version_id":"00000000-0000-4000-8000-000000000010","historical_access_preserved":true,"id":"00000000-0000-4000-8000-000000000009","lookback_days":null,"mode":"all_purchasers","next_cursor":null,"order_ids":[],"product_version":3,"revision":1}
metaContextPageMeta ContextMeta PageMeta RequestMeta Obligatorisk

Svarmetadata.

Eksempel: {"request_id":"example-request"}

Ytterligere felt: Nei

Vis liste — Produkter — Svar

ApiResponse_list_ProductSummaryData__ · Felter, typer og begrensninger for data som API-et mottar eller returnerer.
dataArray <ProductSummaryData > Obligatorisk

Eksempel på svar · ApiResponse_list_ProductSummaryData__.

Eksempel: [{"availability":{"available_from":null,"available_until":null,"is_available":true},"brand_id":null,"condition":"new","created_at":"2026-01-01T12:00:00Z","id":"example","name":"Example","number":"example","price":{"amount":"0.00","currency":"PLN","minor_units":2,"tax_included":true},"price_version":1,"primary_category_id":"example","primary_media_id":"example","published":false,"sku":"example","slug":"example","tax_category_id":"example","updated_at":"2026-01-01T12:00:00Z","variants_enabled":false,"version":1}]
metaContextPageMeta ContextMeta PageMeta RequestMeta Obligatorisk

Svarmetadata.

Eksempel: {"locale":"en","market_code":"PL","market_id":"example","pagination":{"has_more":false,"limit":20,"next_cursor":null},"request_id":"example"}

Ytterligere felt: Nei

Hent — Produkter — Svar

ApiResponse_ProductDetailData_ · Felter, typer og begrensninger for data som API-et mottar eller returnerer.
dataProductDetailData Obligatorisk

Eksempel på svar · ProductDetailData.

Eksempel: {"availability":{"available_from":null,"available_until":null,"is_available":true},"brand_id":null,"condition":"new","created_at":"2026-01-01T12:00:00Z","description":"example","features":[{"feature_id":"example","feature_name":"example","value":"example","value_id":"example"}],"id":"example","identifiers":{},"media":[{"alt_text":"example","id":"example","is_primary":true,"kind":"image","mime_type":"image/jpeg","position":1,"url":"https://example.invalid/product.jpg"}],"meta_description":"example","meta_keywords":["example"],"meta_title":"example","name":"Example","number":"example","price":{"amount":"0.00","currency":"PLN","minor_units":2,"tax_included":true},"price_version":1,"primary_category_id":"example","primary_media_id":"example","published":false,"sku":"example","slug":"example","tax_category_id":"example","updated_at":"2026-01-01T12:00:00Z","variants_enabled":false,"version":1}
metaContextPageMeta ContextMeta PageMeta RequestMeta Obligatorisk

Svarmetadata.

Eksempel: {"locale":"en","market_code":"PL","market_id":"example","request_id":"example"}

Ytterligere felt: Nei

AudienceChange

AudienceChange · Velg berettigede kjøp. Valgte bestillinger må inneholde dette produktet som betalt og ikke refundert.
audienceAudienceSelection Obligatorisk

Uttrykkelig tilgangsregel for den felles filen.

Eksempel: {"mode":"all_purchasers"}
expected_versionHeltallObligatorisk

Versjon lest før skriveoperasjonen; et avvik avviser oppdateringen.

minimum: 1maximum: 9223372036854775807
Eksempel: 1

Ytterligere felt: Nei

AudienceData

AudienceData · Les tilgangsregelen og produktversjonen. Første publisering er fortsatt tidsgrunnlaget.
anchor_atStrengObligatorisk

Første publisering; endres ikke ved en ny regel.

format: "date-time"
Eksempel: "2026-11-03T12:00:00Z"
effective_atStrengObligatorisk

Publiseringstidspunkt for tilgangsregelen.

format: "date-time"
Eksempel: "2026-11-03T12:00:00Z"
file_idStrengObligatorisk

Ressursidentifikator; behold den slik den returneres. · file_id

Eksempel: "00000000-0000-4000-8000-000000000007"
file_version_idStrengObligatorisk

ID for en uforanderlig filversjon.

Eksempel: "00000000-0000-4000-8000-000000000010"
historical_access_preservedBoolsk verdiValgfritt

Tidligere tildelte rettigheter bevares når regelen begrenses.

Standard: trueEksempel: true
idStrengObligatorisk

Ressursidentifikator; behold den slik den returneres.

Eksempel: "00000000-0000-4000-8000-000000000009"
lookback_daysHeltall nullObligatorisk

1–3650 dager før første publisering; bare recent_and_new.

Eksempel: null
modeStrengObligatorisk

Uttrykkelig tilgangsregel for den felles filen. new_purchases / recent_and_new / selected / all_purchasers.

Eksempel: "all_purchasers"
next_cursorStreng nullObligatorisk

Fortsettelsesverdi for neste side, eller null.

Eksempel: null
order_idsArray <Streng> Obligatorisk

Bestillinger med dette betalte, ikke refunderte produktet.

Eksempel: []
product_versionHeltallObligatorisk

Gjeldende produktversjon for samtidighetskontroll.

Eksempel: 3
revisionHeltallObligatorisk

Fortløpende revisjon av tilgangsregelen.

Eksempel: 1

Ytterligere felt: Nei

AudienceSelection

AudienceSelection · Velg berettigede kjøp. Valgte bestillinger må inneholde dette produktet som betalt og ikke refundert.
lookback_daysHeltall nullValgfritt

1–3650 dager før første publisering; bare recent_and_new.

Heltall:minimum: 1maximum: 3650
modeStrengObligatorisk

Uttrykkelig tilgangsregel for den felles filen. new_purchases / recent_and_new / selected / all_purchasers.

Begrensninger
enum
["new_purchases", "recent_and_new", "selected", "all_purchasers"]
Eksempel: "new_purchases"
order_idsArray <Streng> Valgfritt

Bestillinger med dette betalte, ikke refunderte produktet.

maxItems: 1000
Begrensninger · Array 1
pattern
"^[a-z0-9][a-z0-9_-]{0,62}$"
Standard: []

Ytterligere felt: Nei

Tilgjengelighetsinformasjon for valgt kontekst

AvailabilityData · Skjema · Dataskjemaer: Produkter
available_fromStreng nullObligatorisk

Start på tilgjengelighetsperioden.

Streng:format: "date-time"
Eksempel: null
available_untilStreng nullObligatorisk

Slutt på tilgjengelighetsperioden.

Streng:format: "date-time"
Eksempel: null
is_availableBoolsk verdiObligatorisk

Om varen er tilgjengelig i denne konteksten.

Eksempel: true

Ytterligere felt: Nei

FileAssign

FileAssign · Felter, typer og begrensninger for data som API-et mottar eller returnerer. Last opp filer som multipart/form-data etter at upload_id er opprettet, og knytt dem til produktet. Nedlasting krever et Bearer-token og tilgang til category; svaret inneholder filens byte uten offentlig adresse eller passord. For mode=period velges days (1–3650) eller eksisterende months, aldri begge. Vilkårene lagres ved kjøpet; refusjon fjerner bare tilgang for den refunderte ordrelinjen.
audienceAudienceSelection nullValgfritt

Uttrykkelig tilgangsregel for den felles filen.

Eksempel: {"mode":"new_purchases"}
expected_versionHeltallObligatorisk

Versjon lest før skriveoperasjonen; et avvik avviser oppdateringen.

minimum: 1maximum: 9223372036854775807
Eksempel: 1
labelStrengValgfritt

Ressursens navn i den relevante konteksten.

maxLength: 300
Standard: ""
upload_idStrengObligatorisk

Ressursidentifikator; behold den slik den returneres. · upload_id

format: "uuid"
Eksempel: "00000000-0000-4000-8000-000000000001"

Ytterligere felt: Nei

FileCategory

FileCategory · Felter, typer og begrensninger for data som API-et mottar eller returnerer. Last opp filer som multipart/form-data etter at upload_id er opprettet, og knytt dem til produktet. Nedlasting krever et Bearer-token og tilgang til category; svaret inneholder filens byte uten offentlig adresse eller passord. For mode=period velges days (1–3650) eller eksisterende months, aldri begge. Vilkårene lagres ved kjøpet; refusjon fjerner bare tilgang for den refunderte ordrelinjen.
Streng
Begrensninger
enum
["internal", "customer_document", "digital"]

Ytterligere felt: Ja

Prisinformasjon i valgt kontekst

PriceData · Skjema · Dataskjemaer: Produkter
amountStrengObligatorisk

Desimalbeløp kodet som en JSON-streng; null bare der det er tillatt.

Eksempel: "0.00"
currencyStrengObligatorisk

Valutakode for beløpet.

Begrensninger
pattern
"^[A-Z]{3}$"
Eksempel: "PLN"
minor_unitsHeltallObligatorisk

Antall desimalsifre valutaen bruker.

minimum: 0maximum: 4
Eksempel: 2
tax_includedBoolsk verdiObligatorisk

Om innsendt pris inkluderer avgifter.

Eksempel: true

Ytterligere felt: Nei

Prislisteinformasjon

PriceListData · Skjema · Dataskjemaer: Produkter
currencyStrengObligatorisk

Valutakode for beløpet.

idStrengObligatorisk

Ressursidentifikator; behold den slik den returneres. (PriceListData).

tax_includedBoolsk verdiObligatorisk

Om innsendt pris inkluderer avgifter.

versionHeltallObligatorisk

Ressursversjon brukt til samtidighetskontroll.

Ytterligere felt: Nei

Opprett — Produkter — Forespørselsinnhold

ProductCreate · Felter, typer og begrensninger for data som API-et mottar eller returnerer.
brand_idStreng nullValgfritt

Merkeidentifikator.

Streng:minLength: 1maxLength: 63
conditionStrengValgfritt

Produktets tilstand.

Begrensninger
enum
["new", "refurbished", "used", "returned", "display", "damaged"]
Standard: "new"
descriptionStreng nullValgfritt

Beskrivelse på valgt språk.

Streng:maxLength: 100000
feature_value_idsArray <Streng> Valgfritt

Identifikatorer for valgte egenskapsverdier.

maxItems: 1000
Array:minLength: 1maxLength: 63
identifiersProductIdentifiers nullValgfritt

Produktidentifikasjonskoder.

market_idsArray <Streng> Valgfritt

Identifikatorer for valgte markeder.

maxItems: 1000
Array:minLength: 1maxLength: 63
media_idsArray <Streng> Valgfritt

Identifikatorer for medier som allerede finnes.

maxItems: 30
Array:minLength: 1maxLength: 63
meta_descriptionStreng nullValgfritt

Søkemotorbeskrivelse på valgt språk.

Streng:maxLength: 160
meta_keywordsArray <Streng> nullValgfritt

Søkemotornøkkelord på valgt språk.

Array:maxItems: 20
Array / Array:maxLength: 50
meta_titleStreng nullValgfritt

Søkemotortittel på valgt språk.

Streng:maxLength: 70
nameStrengObligatorisk

Ressursens navn i den relevante konteksten.

minLength: 1maxLength: 300
Eksempel: "Example"
pricingProductPrice Valgfritt

Priskonfigurasjon og versjonene for samtidighetskontroll.

primary_category_idStreng nullValgfritt

Identifikator for primærkategori.

Streng:minLength: 1maxLength: 63
publishedBoolsk verdiValgfritt

Om ressursen er publisert.

Standard: false
skuStrengObligatorisk

SKU-varekode.

minLength: 1maxLength: 100
Begrensninger
pattern
"^\\S+$"
Eksempel: "example"
slugStreng nullValgfritt

URL-stisegment på valgt språk.

Streng:maxLength: 160
tax_category_idStreng nullValgfritt

Identifikator for avgiftskategori.

Streng:minLength: 1maxLength: 63
variant_value_idsArray <Streng> Valgfritt

Identifikatorer for valgte variantverdier.

maxItems: 250
Array:minLength: 1maxLength: 63
variants_enabledBoolsk verdiValgfritt

Om produktet bruker varianter.

Standard: false

Ytterligere felt: Nei

Hent — Produkter — Svar

ProductDetailData · Felter, typer og begrensninger for data som API-et mottar eller returnerer.
availabilityAvailabilityData Obligatorisk

Tilgjengelighetsinformasjon for valgt kontekst.

Eksempel: {"available_from":null,"available_until":null,"is_available":true}
brand_idStreng nullObligatorisk

Merkeidentifikator.

Eksempel: null
conditionStrengObligatorisk

Produktets tilstand.

Begrensninger
enum
["new", "refurbished", "used", "returned", "display", "damaged"]
Eksempel: "new"
created_atStrengObligatorisk

Opprettelsestidspunkt.

format: "date-time"
Eksempel: "2026-01-01T12:00:00Z"
descriptionStreng nullObligatorisk

Beskrivelse på valgt språk.

Eksempel: "example"
featuresArray <FeatureSelectionData > Obligatorisk

Produktegenskaper.

Eksempel: [{"feature_id":"example","feature_name":"example","value":"example","value_id":"example"}]
idStrengObligatorisk

Ressursidentifikator; behold den slik den returneres. (ProductDetailData).

Eksempel: "example"
identifiersObjektYtterligere felt: StrengObligatorisk

Produktidentifikasjonskoder.

Eksempel: {}
mediaArray <ProductMediaData > Obligatorisk

Informasjon om tilknyttede medier.

Eksempel: [{"alt_text":"example","id":"example","is_primary":true,"kind":"image","mime_type":"image/jpeg","position":1,"url":"https://example.invalid/product.jpg"}]
meta_descriptionStreng nullObligatorisk

Søkemotorbeskrivelse på valgt språk.

Eksempel: "example"
meta_keywordsArray <Streng> nullObligatorisk

Søkemotornøkkelord på valgt språk.

Eksempel: ["example"]
meta_titleStreng nullObligatorisk

Søkemotortittel på valgt språk.

Eksempel: "example"
nameStreng nullObligatorisk

Ressursens navn i den relevante konteksten.

Eksempel: "Example"
numberStrengObligatorisk

Ordre- eller saksnummer beregnet på mennesker.

Eksempel: "example"
pricePriceData nullObligatorisk

Prisinformasjon i valgt kontekst.

Eksempel: {"amount":"0.00","currency":"PLN","minor_units":2,"tax_included":true}
price_versionHeltallObligatorisk

Gjeldende prisversjon for samtidighetskontroll.

Eksempel: 1
primary_category_idStreng nullObligatorisk

Identifikator for primærkategori.

Eksempel: "example"
primary_media_idStreng nullObligatorisk

Identifikator for primærmediet.

Eksempel: "example"
publishedBoolsk verdiObligatorisk

Om ressursen er publisert.

Eksempel: false
skuStrengObligatorisk

SKU-varekode.

Eksempel: "example"
slugStreng nullObligatorisk

URL-stisegment på valgt språk.

Eksempel: "example"
tax_category_idStrengObligatorisk

Identifikator for avgiftskategori.

Eksempel: "example"
updated_atStrengObligatorisk

Tidspunkt for siste oppdatering.

format: "date-time"
Eksempel: "2026-01-01T12:00:00Z"
variants_enabledBoolsk verdiObligatorisk

Om produktet bruker varianter.

Eksempel: false
versionHeltallObligatorisk

Ressursversjon brukt til samtidighetskontroll.

Eksempel: 1

Ytterligere felt: Nei

ProductFileData

ProductFileData · Felter, typer og begrensninger for data som API-et mottar eller returnerer. Last opp filer som multipart/form-data etter at upload_id er opprettet, og knytt dem til produktet. Nedlasting krever et Bearer-token og tilgang til category; svaret inneholder filens byte uten offentlig adresse eller passord. For mode=period velges days (1–3650) eller eksisterende months, aldri begge. Vilkårene lagres ved kjøpet; refusjon fjerner bare tilgang for den refunderte ordrelinjen.
categoryFileCategory Obligatorisk

Filkategori: internal / customer_document / digital

Eksempel: "digital"
created_atStrengObligatorisk

Opprettelsestidspunkt.

format: "date-time"
Eksempel: "2026-01-01T12:00:00Z"
current_version_idStrengObligatorisk

Ressursidentifikator; behold den slik den returneres. · current_version_id

format: "uuid"
Eksempel: "00000000-0000-4000-8000-000000000001"
file_idStrengObligatorisk

Ressursidentifikator; behold den slik den returneres. · file_id

format: "uuid"
Eksempel: "00000000-0000-4000-8000-000000000001"
filenameStrengObligatorisk

Fil

Eksempel: "manual.pdf"
idStrengObligatorisk

Ressursidentifikator; behold den slik den returneres.

format: "uuid"
Eksempel: "00000000-0000-4000-8000-000000000001"
labelStrengObligatorisk

Ressursens navn i den relevante konteksten.

Eksempel: "Manual"
mime_typeStrengObligatorisk

Mediets innholdstype.

Eksempel: "application/pdf"
sha256StrengObligatorisk

SHA-256 (hex, 64)

Eksempel: "5cd2f1cb0e5532b397e7ab1887baf6000c49450fd80ae279eb047c06e4545ecd"
size_bytesHeltallObligatorisk

Størrelse i byte

Eksempel: 46
stateStrengObligatorisk

Status

Eksempel: "active"
version_numberHeltallObligatorisk

Versjon

Eksempel: 1

Ytterligere felt: Nei

ProductFileListData

ProductFileListData · Felter, typer og begrensninger for data som API-et mottar eller returnerer. Last opp filer som multipart/form-data etter at upload_id er opprettet, og knytt dem til produktet. Nedlasting krever et Bearer-token og tilgang til category; svaret inneholder filens byte uten offentlig adresse eller passord. For mode=period velges days (1–3650) eller eksisterende months, aldri begge. Vilkårene lagres ved kjøpet; refusjon fjerner bare tilgang for den refunderte ordrelinjen.
filesArray <ProductFileData > Obligatorisk

Produktfiler

Eksempel: [{"category":"digital","created_at":"2026-01-01T12:00:00Z","current_version_id":"00000000-0000-4000-8000-000000000001","file_id":"00000000-0000-4000-8000-000000000001","filename":"manual.pdf","id":"00000000-0000-4000-8000-000000000001","label":"Manual","mime_type":"application/pdf","sha256":"5cd2f1cb0e5532b397e7ab1887baf6000c49450fd80ae279eb047c06e4545ecd","size_bytes":46,"state":"active","version_number":1}]
product_versionHeltallObligatorisk

Gjeldende produktversjon for samtidighetskontroll.

Eksempel: 2

Ytterligere felt: Nei

Produktidentifikasjonskoder

ProductIdentifiers · Skjema · Dataskjemaer: Produkter
eanStreng nullValgfritt

Produktets EAN-identifikator.

Streng:minLength: 1maxLength: 100
isbnStreng nullValgfritt

ISBN-identifikator.

Streng:minLength: 1maxLength: 100
mpnStreng nullValgfritt

Produsentens delenummer.

Streng:minLength: 1maxLength: 100
upcStreng nullValgfritt

Produktets UPC-identifikator.

Streng:minLength: 1maxLength: 100

Ytterligere felt: Nei

Informasjon om tilknyttede medier

ProductMediaData · Skjema · Dataskjemaer: Produkter
alt_textStreng nullObligatorisk

Alternativ tekst for et bilde.

Eksempel: "example"
idStrengObligatorisk

Ressursidentifikator; behold den slik den returneres. (ProductMediaData).

Eksempel: "example"
is_primaryBoolsk verdiObligatorisk

Om dette er det primære elementet.

Eksempel: true
kindStrengObligatorisk

Variant av datastrukturen beskrevet av de tillatte verdiene.

Begrensninger
enum
["image", "video", "model_3d"]
Eksempel: "image"
mime_typeStrengObligatorisk

Mediets innholdstype.

Eksempel: "image/jpeg"
positionHeltallObligatorisk

Plassering i den sorterte samlingen.

Eksempel: 1
urlStreng nullObligatorisk

Ressursens URL.

Eksempel: "https://example.invalid/product.jpg"

Ytterligere felt: Nei

Priskonfigurasjon og versjonene for samtidighetskontroll

ProductPrice · Skjema · Dataskjemaer: Produkter
amountStreng nullObligatorisk

Desimalbeløp kodet som en JSON-streng; null bare der det er tillatt.

Streng:maxLength: 19
Begrensninger · Streng 1
pattern
"^(0|[1-9][0-9]{0,13})(\\.[0-9]{1,4})?$"
Eksempel: "0.00"
currencyStrengObligatorisk

Valutakode for beløpet.

Begrensninger
pattern
"^[A-Z]{3}$"
Eksempel: "PLN"
expected_price_list_versionHeltallObligatorisk

Tidligere lest prislisteversjon som kreves for denne skriveoperasjonen.

minimum: 1maximum: 9223372036854775807
Eksempel: 1
expected_versionHeltallObligatorisk

Versjon lest før skriveoperasjonen; et avvik avviser oppdateringen.

minimum: 0maximum: 9223372036854775807
Eksempel: 0
kindStrengObligatorisk

Variant av datastrukturen beskrevet av de tillatte verdiene.

Begrensninger
enum
["base", "market_fixed"]
Eksempel: "base"
price_list_idStrengObligatorisk

Prislisteidentifikator.

minLength: 1maxLength: 63
Eksempel: "example"
tax_includedBoolsk verdiObligatorisk

Om innsendt pris inkluderer avgifter.

Eksempel: true

Ytterligere felt: Nei

Vis liste — Produkter — Svar

ProductSummaryData · Felter, typer og begrensninger for data som API-et mottar eller returnerer.
availabilityAvailabilityData Obligatorisk

Tilgjengelighetsinformasjon for valgt kontekst.

Eksempel: {"available_from":null,"available_until":null,"is_available":true}
brand_idStreng nullObligatorisk

Merkeidentifikator.

Eksempel: null
conditionStrengObligatorisk

Produktets tilstand.

Begrensninger
enum
["new", "refurbished", "used", "returned", "display", "damaged"]
Eksempel: "new"
created_atStrengObligatorisk

Opprettelsestidspunkt.

format: "date-time"
Eksempel: "2026-01-01T12:00:00Z"
idStrengObligatorisk

Ressursidentifikator; behold den slik den returneres. (ProductSummaryData).

Eksempel: "example"
nameStreng nullObligatorisk

Ressursens navn i den relevante konteksten.

Eksempel: "Example"
numberStrengObligatorisk

Ordre- eller saksnummer beregnet på mennesker.

Eksempel: "example"
pricePriceData nullObligatorisk

Prisinformasjon i valgt kontekst.

Eksempel: {"amount":"0.00","currency":"PLN","minor_units":2,"tax_included":true}
price_versionHeltallObligatorisk

Gjeldende prisversjon for samtidighetskontroll.

Eksempel: 1
primary_category_idStreng nullObligatorisk

Identifikator for primærkategori.

Eksempel: "example"
primary_media_idStreng nullObligatorisk

Identifikator for primærmediet.

Eksempel: "example"
publishedBoolsk verdiObligatorisk

Om ressursen er publisert.

Eksempel: false
skuStrengObligatorisk

SKU-varekode.

Eksempel: "example"
slugStreng nullObligatorisk

URL-stisegment på valgt språk.

Eksempel: "example"
tax_category_idStrengObligatorisk

Identifikator for avgiftskategori.

Eksempel: "example"
updated_atStrengObligatorisk

Tidspunkt for siste oppdatering.

format: "date-time"
Eksempel: "2026-01-01T12:00:00Z"
variants_enabledBoolsk verdiObligatorisk

Om produktet bruker varianter.

Eksempel: false
versionHeltallObligatorisk

Ressursversjon brukt til samtidighetskontroll.

Eksempel: 1

Ytterligere felt: Nei

Oppdater — Produkter — Forespørselsinnhold

ProductUpdate · Felter, typer og begrensninger for data som API-et mottar eller returnerer.
brand_idStreng nullValgfritt

Merkeidentifikator.

Streng:minLength: 1maxLength: 63
conditionStrengValgfritt

Produktets tilstand.

Begrensninger
enum
["new", "refurbished", "used", "returned", "display", "damaged"]
descriptionStreng nullValgfritt

Beskrivelse på valgt språk.

Streng:maxLength: 100000
Eksempel: null
expected_variant_price_versionsObjektYtterligere felt: Heltall
minimum: 0maximum: 9223372036854775807
Valgfritt

Tidligere leste prisversjoner med variantidentifikator som nøkkel.

maxProperties: 250
Begrensninger
propertyNames
{"maxLength": 63, "minLength": 1}
expected_versionHeltallObligatorisk

Versjon lest før skriveoperasjonen; et avvik avviser oppdateringen.

minimum: 1maximum: 9223372036854775807
Eksempel: 1
feature_value_idsArray <Streng> Valgfritt

Identifikatorer for valgte egenskapsverdier.

maxItems: 1000
Array:minLength: 1maxLength: 63
identifiersProductIdentifiers nullValgfritt

Produktidentifikasjonskoder.

market_idsArray <Streng> Valgfritt

Identifikatorer for valgte markeder.

maxItems: 1000
Array:minLength: 1maxLength: 63
media_idsArray <Streng> Valgfritt

Identifikatorer for medier som allerede finnes.

maxItems: 30
Array:minLength: 1maxLength: 63
meta_descriptionStreng nullValgfritt

Søkemotorbeskrivelse på valgt språk.

Streng:maxLength: 160
meta_keywordsArray <Streng> nullValgfritt

Søkemotornøkkelord på valgt språk.

Array:maxItems: 20
Array / Array:maxLength: 50
meta_titleStreng nullValgfritt

Søkemotortittel på valgt språk.

Streng:maxLength: 70
nameStreng nullValgfritt

Ressursens navn i den relevante konteksten.

Streng:maxLength: 300
pricingProductPrice Valgfritt

Priskonfigurasjon og versjonene for samtidighetskontroll.

Eksempel: {"amount":"0.00","currency":"PLN","expected_price_list_version":1,"expected_version":0,"kind":"base","price_list_id":"example","tax_included":true}
primary_category_idStreng nullValgfritt

Identifikator for primærkategori.

Streng:minLength: 1maxLength: 63
publishedBoolsk verdiValgfritt

Om ressursen er publisert.

skuStrengValgfritt

SKU-varekode.

minLength: 1maxLength: 100
Begrensninger
pattern
"^\\S+$"
Eksempel: "example"
slugStreng nullValgfritt

URL-stisegment på valgt språk.

Streng:maxLength: 160
tax_category_idStreng nullValgfritt

Identifikator for avgiftskategori.

Streng:minLength: 1maxLength: 63
variant_value_idsArray <Streng> Valgfritt

Identifikatorer for valgte variantverdier.

maxItems: 250
Array:minLength: 1maxLength: 63
variants_enabledBoolsk verdiValgfritt

Om produktet bruker varianter.

Ytterligere felt: Nei

ProductVersion

ProductVersion · Denne handlingen er avviklet og gir 409 uten å endre data. Angi tilgang for hver digital fil gjennom valg av mottakere.
expected_versionHeltallObligatorisk

Versjon lest før skriveoperasjonen; et avvik avviser oppdateringen.

minimum: 1maximum: 9223372036854775807
Eksempel: 1

Ytterligere felt: Nei

ReleaseData

ReleaseData · Felter, typer og begrensninger for data som API-et mottar eller returnerer. Last opp filer som multipart/form-data etter at upload_id er opprettet, og knytt dem til produktet. Nedlasting krever et Bearer-token og tilgang til category; svaret inneholder filens byte uten offentlig adresse eller passord. For mode=period velges days (1–3650) eller eksisterende months, aldri begge. Vilkårene lagres ved kjøpet; refusjon fjerner bare tilgang for den refunderte ordrelinjen.
changelogStrengObligatorisk

Beskrivelse av endringer

Eksempel: "Manual update"
filesArray <ReleaseFileData > Obligatorisk

Produktfiler

Eksempel: [{"file_id":"00000000-0000-4000-8000-000000000001","sort_order":0,"version_id":"00000000-0000-4000-8000-000000000001"}]
idStrengObligatorisk

Ressursidentifikator; behold den slik den returneres.

format: "uuid"
Eksempel: "00000000-0000-4000-8000-000000000001"
manifest_sha256Streng nullObligatorisk

Digitale utgaver · SHA-256

Eksempel: "1111111111111111111111111111111111111111111111111111111111111111"
published_atStreng nullObligatorisk

Publiser utgave · UTC

Streng:format: "date-time"
Eksempel: null
release_sequenceHeltall nullObligatorisk

Digitale utgaver · Plassering i den sorterte samlingen.

Eksempel: null
stateStrengObligatorisk

Status

Eksempel: "active"
version_labelStrengObligatorisk

Versjon

Eksempel: "1.0"
withdrawn_atStreng nullObligatorisk

Trekk tilbudet tilbake · UTC

Streng:format: "date-time"
Eksempel: null

Ytterligere felt: Nei

ReleaseDraft

ReleaseDraft · Denne handlingen er avviklet og gir 409 uten å endre data. Angi tilgang for hver digital fil gjennom valg av mottakere.
changelogStrengValgfritt

Beskrivelse av endringer

maxLength: 20000
Standard: ""
expected_versionHeltallObligatorisk

Versjon lest før skriveoperasjonen; et avvik avviser oppdateringen.

minimum: 1maximum: 9223372036854775807
Eksempel: 1
version_idsArray <Streng> Obligatorisk

Versjon · UUID[]

minItems: 1maxItems: 20
Array:format: "uuid"
Eksempel: ["00000000-0000-4000-8000-000000000001"]
version_labelStrengObligatorisk

Versjon

minLength: 1maxLength: 64
Eksempel: "1.0"

Ytterligere felt: Nei

ReleaseFileData

ReleaseFileData · Felter, typer og begrensninger for data som API-et mottar eller returnerer. Last opp filer som multipart/form-data etter at upload_id er opprettet, og knytt dem til produktet. Nedlasting krever et Bearer-token og tilgang til category; svaret inneholder filens byte uten offentlig adresse eller passord. For mode=period velges days (1–3650) eller eksisterende months, aldri begge. Vilkårene lagres ved kjøpet; refusjon fjerner bare tilgang for den refunderte ordrelinjen.
file_idStrengObligatorisk

Ressursidentifikator; behold den slik den returneres. · file_id

format: "uuid"
Eksempel: "00000000-0000-4000-8000-000000000001"
sort_orderHeltallObligatorisk

Plassering i den sorterte samlingen.

Eksempel: 0
version_idStrengObligatorisk

Ressursidentifikator; behold den slik den returneres. · version_id

format: "uuid"
Eksempel: "00000000-0000-4000-8000-000000000001"

Ytterligere felt: Nei

ReleaseListData

ReleaseListData · Felter, typer og begrensninger for data som API-et mottar eller returnerer. Last opp filer som multipart/form-data etter at upload_id er opprettet, og knytt dem til produktet. Nedlasting krever et Bearer-token og tilgang til category; svaret inneholder filens byte uten offentlig adresse eller passord. For mode=period velges days (1–3650) eller eksisterende months, aldri begge. Vilkårene lagres ved kjøpet; refusjon fjerner bare tilgang for den refunderte ordrelinjen.
current_release_idStreng nullObligatorisk

Ressursidentifikator; behold den slik den returneres. · current_release_id

Streng:format: "uuid"
Eksempel: "00000000-0000-4000-8000-000000000001"
product_versionHeltallObligatorisk

Gjeldende produktversjon for samtidighetskontroll.

Eksempel: 2
releasesArray <ReleaseData > Obligatorisk

Digitale utgaver

Eksempel: [{"changelog":"Manual update","files":[{"file_id":"00000000-0000-4000-8000-000000000001","sort_order":0,"version_id":"00000000-0000-4000-8000-000000000001"}],"id":"00000000-0000-4000-8000-000000000001","manifest_sha256":"1111111111111111111111111111111111111111111111111111111111111111","published_at":null,"release_sequence":null,"state":"active","version_label":"1.0","withdrawn_at":null}]
update_daysHeltall nullObligatorisk

Antall dager (days; null)

Eksempel: 365
update_modeStrengObligatorisk

Tilgang til fremtidige filer etter kjøp: none / period / unlimited

Eksempel: "period"
update_monthsHeltall nullObligatorisk

Måneder (months; null)

Eksempel: null

Ytterligere felt: Nei

UpdatePolicy

UpdatePolicy · Denne handlingen er avviklet og gir 409 uten å endre data. Angi tilgang for hver digital fil gjennom valg av mottakere.
daysHeltall nullValgfritt

Antall dager (1–3650; mode=period; months=null)

Heltall:minimum: 1maximum: 3650
Eksempel: 365
expected_versionHeltallObligatorisk

Versjon lest før skriveoperasjonen; et avvik avviser oppdateringen.

minimum: 1maximum: 9223372036854775807
Eksempel: 1
modeStrengObligatorisk

Tilgang til fremtidige filer etter kjøp: none / period / unlimited

Begrensninger
enum
["none", "period", "unlimited"]
Eksempel: "period"
monthsHeltall nullValgfritt

Måneder (1–120; mode=period; days=null)

Heltall:minimum: 1maximum: 120
Eksempel: null

Ytterligere felt: Nei

UploadCreate

UploadCreate · Felter, typer og begrensninger for data som API-et mottar eller returnerer. Last opp filer som multipart/form-data etter at upload_id er opprettet, og knytt dem til produktet. Nedlasting krever et Bearer-token og tilgang til category; svaret inneholder filens byte uten offentlig adresse eller passord. For mode=period velges days (1–3650) eller eksisterende months, aldri begge. Vilkårene lagres ved kjøpet; refusjon fjerner bare tilgang for den refunderte ordrelinjen.
filenameStrengObligatorisk

Fil

minLength: 1maxLength: 255
Eksempel: "manual.pdf"
product_idStreng nullValgfritt

Produktidentifikator.

Begrensninger · Streng 1
pattern
"^[a-z0-9][a-z0-9_-]{0,62}$"
Eksempel: "example"
sha256StrengObligatorisk

SHA-256 (hex, 64)

Begrensninger
pattern
"^[0-9a-f]{64}$"
Eksempel: "5cd2f1cb0e5532b397e7ab1887baf6000c49450fd80ae279eb047c06e4545ecd"
size_bytesHeltallObligatorisk

Størrelse i byte

minimum: 1maximum: 262144000
Eksempel: 46

Ytterligere felt: Nei

UploadData

UploadData · Felter, typer og begrensninger for data som API-et mottar eller returnerer. Last opp filer som multipart/form-data etter at upload_id er opprettet, og knytt dem til produktet. Nedlasting krever et Bearer-token og tilgang til category; svaret inneholder filens byte uten offentlig adresse eller passord. For mode=period velges days (1–3650) eller eksisterende months, aldri begge. Vilkårene lagres ved kjøpet; refusjon fjerner bare tilgang for den refunderte ordrelinjen.
categoryFileCategory Obligatorisk

Filkategori: internal / customer_document / digital

Eksempel: "digital"
expires_atStrengObligatorisk

Dato og tidspunkt da legitimasjonen utløper.

format: "date-time"
Eksempel: "2026-01-01T12:00:00Z"
filenameStrengObligatorisk

Fil

Eksempel: "manual.pdf"
idStrengObligatorisk

Ressursidentifikator; behold den slik den returneres.

format: "uuid"
Eksempel: "00000000-0000-4000-8000-000000000001"
product_idStreng nullObligatorisk

Produktidentifikator.

Eksempel: "example"
received_bytesHeltallObligatorisk

Laster opp… · Størrelse i byte

Eksempel: 46
sha256StrengObligatorisk

SHA-256 (hex, 64)

Eksempel: "5cd2f1cb0e5532b397e7ab1887baf6000c49450fd80ae279eb047c06e4545ecd"
size_bytesHeltallObligatorisk

Størrelse i byte

Eksempel: 46
statusStrengObligatorisk

Status som godtas av denne bestemte operasjonen.

Eksempel: "ready"

Ytterligere felt: Nei