Media v2.2 | Dokumentation

Allmän information

Denna endpoint låter dig hämta media kopplat till en artikel. Den är designad för att vara flexibel och stödja olika sökparametrar för att förfina din sökning.

Skillnader mellan v2.0/media och v2.1/media

I version v2.1/media har vi introducerat ett nytt objekt som heter identifiers för varje artikel i articleList. Detta objekt innehåller ytterligare identifierare som gör det enklare att koppla samman data mellan olika system. Följande fält är inkluderade i identifiers:

finfoSupplierId: Ett unikt ID som identifierar leverantören i vårt system.
supplierArticleId: Leverantörens eget artikelnummer.
gtin: Global Trade Item Number, en standard för identifiering av produkter.

Exempel på data i v2.1/media

JSON

"identifiers": {
  "finfoSupplierId": "12345",
  "supplierArticleId": "67890",
  "gtin": "0123456789012"
}

Skillnader mellan v2.1/media och v2.2/media

Vi har introducerat AI-genererade alttexter för alla bilder. Så här ser det ut för heroImage

JSON

"heroImage": {
  "url": https://asset.productmarketingcloud.com/api/assetstorage/1311_65ef0247-0f10-4bf1-b128-c3064c512288/original/543787.jpg,
  "contentType": "productImageSingle",
  "altText": "Målarburk i metall med orange etikett och texten "Cuprinol Ädellasyr" synlig på framsidan.",
  "lastModified": "2025-02-27T09:51:07.0000000",
  "checksum": "46ec1a1f9700622b2288a5d48fbc776a",
  "linkIndex": 0,
  "createdDate": "2021-03-22T14:26:00.0000000"
},

Övriga bilder

JSON

"images": [
  {
    "url": https://...,
    "contentType": "...",
    "altText": "Beskrivning av bild",
    ...
  }
]

Tidsbaserad hämtning

Om inga tidsparametrar anges, beaktas endast datumet
Alla datum är inkluderande, både from och to.
Om även tid används ska den anges i UTC (t.ex. 2023-07-05T12:17:30.974Z)
Om endast from anges, antas to vara den nuvarande tiden.

finfoSupplierId utan kompletterande variabel
changed-from-date

Övriga noteringar

supplierArticleId kräver att finfoSupplierId också anges.

Om variabeln changed-from-date används kommer svaret filtreras på mottagarens specifika leverantörer.

Om andra variabler används kan svaret innehålla artiklar som inte tillhör mottagarens specifika leverantörer, matchning mot finfoArticleId kan då krävas.

Artikelinformation

Fält	Typ	Längd/Storlek	Beskrivning
`finfoArticleId`	int	9	Unikt identifieringsnummer för artikeln.
`lastModified`	datetime	-	Senaste ändringsdatum och tid för artikeln.
`model`	string	50	Modellbeteckning för artikeln.

Textfält

Fält	Typ	Längd/Storlek	Beskrivning
`webName`	string	100	En benämning som är anpassad för E-handel.
`ingress`	string	250	Sammanfattande produkttext. Kortfattad med början och slut. Skapar tillsammans med en produktbild en säljande helhet.
`complete`	string	4000	Beskrivande produkttext, komplettering till Produkttext, ingress. Skall vara fristående och kunna läsas utan Produkttext, ingress.
`bullet`	string	1000	Lista över attribut och funktioner som gör produkten unik.
`aiText`	string	4000	En produkttext genererad av Finfo, baserad på ingress och komplett produkttext. OpenAI används för att generera texten.
`aiBullet`	string	1000	USPar genererade av Finfo baserade på inskickad information i fältet bullet. Korrigeras för att inte innehålla html eller inledas med specialtecken. Varje bullet ligger på ny rad. Alla bullets översätts till svenska. Varje rad avlutas utan punkt.

AI-genererade texter

Vid utveckling av tjänster som bearbetar texter med hjälp av AI har omfattande testning av resultaten genomförts. Trots detta finns det ett oändligt antal textkombinationer, vilket innebär att det alltid finns en liten risk för oväntade beteenden från systemen. AI är programmerad att endast bearbeta befintlig text och inte lägga till ny information.

För närvarande används OpenAIs tjänster, men andra tjänster kan komma att användas i framtiden baserat på prestanda och behov. Observera att inga texter tillåts användas för träning av nya AI-modeller.

Alt-texter

För att underlätta för mottagare och bidra till ökad digital tillgänglighet genereras alt-texter automatiskt med hjälp av AI. Texterna är utformade enligt WCAG 2.1 AA, vilket är den etablerade standarden för tillgänglighetsanpassning av digitalt innehåll.

Alt-texterna är dessutom framtagna med hänsyn till kraven i European Accessibility Act (EU 2019/882), ett EU-direktiv som kommer att börja gälla i svensk lag från den 28 juni 2025. Direktivet innebär att även vissa privata aktörer, däribland e-handelsplattformar, omfattas av tillgänglighetskrav.

Länkade resurser

Alla resurser kommer med ett, för länktypen, delat linkIndex. Det innebär att alla images, oavsett contentType ligger i följd efter varandra.

Som slutanvändare är det möjligt att lagra endast en kopia av en resurs om så är önskvärt, även om Finfo hanterar det som olika filer. Mottagande import bör då först kontrollera om checksum för objektet finns i systemet och i sånt fall länka existerande objekt.

Om ingen förändring skett på resursen sedan vi började lagra lastModified och createdDate kommer dessa skickas som "1900-01-01T00:00:00.0000000"

Format på bilder

Bilder kan hämtas i olika format beroende på vilket värde som används i URL:en. När bilden hämtas som original skickas originalfilen i det filformat den är lagrad i. Följande filformat stöds:

.eps
.tif, .tiff
.jpg
.gif
.webp

Exempel på URL till originalfil:
"url": "https://asset.productmarketingcloud.com/api/assetstorage/1311_30c11dc8-bab3-4ae7-b3b2-8b3ac14a91c1/original/758989.webp"

För att hämta en komprimerad förhandsgranskning av bilden, byt ut original i URL:en enligt nedan:

preview returnerar bilden som en 1000x1000 px JPEG
ecom returnerar bilden som en 1000x1000 px WebP

För att säkerställa optimal prestanda och säkerhet, är det nödvändigt att alla resurser hämtade genom vårt API – inklusive bilder och dokument – lagras lokalt av slutanvändaren. Det är inte tillåtet att direktlänka dessa resurser i publika miljöer såsom e-handelsplattformar. Detta krav skyddar våra serverresurser från överbelastning och säkrar att vårt innehåll används på ett ansvarsfullt sätt.

heroImage

Har alltid "contentType": "productImageSingle" och "linkIndex": 0. Systemet försöker alltid berika heroImage innan den placerar productImageSingle under relationen images. Det kan inte förekomma mer än en (1) heroImage. Det finns ingen strikt begränsning gällande filformat för dessa bilder.

JSON

 "heroImage": {
        "url": "https://asset.productmarketingcloud.com/api/assetstorage/1311_6ff1cdc0-5e48-4d2b-8e65-f64fdc0881cc/original/253103.png",
        "contentType": "productImageSingle",
        "lastModified": "1900-01-01T00:00:00.0000000",
        "checksum": "fd5ed1879a6ebc8074fa1df4f3223f6d",
        "linkIndex": 0,
        "createdDate": "1900-01-01T00:00:00.0000000"
      }

images

Leverantören har möjlighet att skicka in bilder, där varje bild kan specificeras genom dess contentType. Det finns ingen strikt begränsning gällande filformat för dessa bilder, vilket ger en flexibilitet att använda olika typer av bildfiler.

contentType	Beskrivning	Rekommenderat max antal per produkt
`productImageSingle`	Produktbild, Singel	9
`inContextProductImage`	Miljöbild	9
`productInActionImage`	Actionbild	9
`productImageGroup`	Produktbild, Grupp	9
`brandLogo`	Varumärke, Logotyp	9
`lineDrawing`	Streckteckning	9
`colorSampleImage`	Kulör	9
`productSurfaceImage`	Produktyta	9

documents

Leverantören har möjlighet att överföra ett spektrum av dokumenttyper, där varje dokument tydligt definieras genom dess unika contentTyp. Observera att samtliga dokument som överförs måste vara i PDF-format.

contentType	Beskrivning	Rekommenderat max antal per produkt
`safetyDataSheet`	Säkerhetsdatablad	2
`productDataSheet`	Produktdatablad	9
`userManual`	Användarhandbok	9
`explodedView`	Sprängskiss	9
`productCatalog`	Produktkatalog	9
`performanceDeclaration`	Prestandadeklaration (CE-märkning)	1
`installationInstructions`	Monteringsanvisningar	9
`environmentalProductDeclaration`	Miljövarudeklaration (EPD)	1
`constructionProductDeclaration`	Byggvarudeklaration (BVD)	1
`certificate`	Certifikat	9
`operationAndMaintenance`	Drift och skötsel	9
`disassemblyInstructions`	Demonteringsanvisning	9

designFiles

contentType	Beskrivning	Rekommenderat max antal per produkt
`cadFile`	CAD-fil	2

energyLabels

contentType	Beskrivning	Rekommenderat max antal per produkt
`energyLabelingStickerPdf`	Energimärkningsetikett (pdf)	1
`energyLabelingStickerImage`	Energimärkningsetikett (bildformat)	1
`productDataSheetEnergyLabeling`	Produktblad energimärkning / EPREL dokumentation	1

externalAssets

I dagsläget finns två externalAssets, youtubeInstallation och youtubeMarketing. Rekommendationen till leverantör är att använda en förkortad URL likt "https://youtu.be/HR-lEiGKBFs?si=hTE0FyXw_Nqo3xY1".

accessories / spareParts

Tillbehör och reservdelar kopplas till produkten via finfoArticleId

JSON

 "spareParts": [
        6753710,
        6753711,
        7494337,
        3988015,
        7655013
      ],
 "accessories": [
        6753710,
        6753711,
        7494337,
        7655012
      ]

Exempel på ett API-svar

JSON

{
  "pagination": {
    "offset": 0,
    "limit": 0,
    "totalCount": 1
  },
  "articleList": [
    {
      "finfoArticleId": 5061033,
      "identifiers": {
        "finfoSupplierId": 40,
        "supplierArticleId": "123456789012345678"
      },
      "lastModified": "2025-03-31T14:35:08.0000000",
      "model": "INSPEKTIONSLUCKA STÅL",
      "text": {
        "webName": "INSPEKTIONSLUCKA STÅL VIT 150X150",
        "ingress": "Inspektionslucka i vitlackerat stål med låsbar lucka för montering i vägg och tak inomhus. ",
        "complete": "Inspektionslucka i vit- eller svartlackerat stål med låsbar lucka för montering i vägg och tak inomhus. Med integrerade beslag för montering. Dörren är avtagbar vilket underlättar installation. Med 7 mm fyrkantlås och nyckel.",
        "bullet": "Pulverlackerad galvaniserad stål\nAvtagbar dörr\nMed monteringskonsoller\nMed lås och nyckel",
        "aiText": "Inspektionslucka i vit- eller svartlackerat stål med låsbar lucka för montering i vägg och tak inomhus. Med integrerade beslag för montering. Dörren är avtagbar vilket underlättar installation. Med 7 mm fyrkantlås och nyckel.",
        "aiBullet": "Pulverlackerad galvaniserad stål\nAvtagbar dörr\nMed monteringskonsoller\nMed lås och nyckel"
      },
      "heroImage": {
        "url": "https://asset.productmarketingcloud.com/api/assetstorage/1311_319f6aaf-44fa-4abc-81a5-81bef3c47f7e/original/758988.jpg",
        "contentType": "productImageSingle",
        "lastModified": "2025-03-28T12:56:00.0000000",
        "checksum": "92d583e72d27490245ee8df8b7e9f1b2",
        "linkIndex": 0,
        "createdDate": "2025-03-28T10:10:45.0000000",
        "altText": "Vit kvadratisk panel ovanför en blå kvadratisk yta, i en delvis isärmonterad position."
      },
      "images": [
        {
          "url": "https://asset.productmarketingcloud.com/api/assetstorage/1311_30c11dc8-bab3-4ae7-b3b2-8b3ac14a91c1/original/758989.webp",
          "contentType": "productImageGroup",
          "lastModified": "2025-03-28T12:56:13.0000000",
          "checksum": "8ce8ca0eecaf09418f3855167cf0b5fd",
          "linkIndex": 0,
          "createdDate": "2025-03-28T10:10:45.0000000",
          "altText": "Tre runda transparenta plastlock med två små trekantiga öppningar på varje lock."
        },
        {
          "url": "https://asset.productmarketingcloud.com/api/assetstorage/1311_cfac7b3b-d4df-4048-b3f1-36909a23da81/original/758990.jpg",
          "contentType": "inContextProductImage",
          "lastModified": "2025-03-28T12:56:14.0000000",
          "checksum": "8090344e2778ac0e6f7b1b9e10c05b0c",
          "linkIndex": 1,
          "createdDate": "2025-03-28T10:10:46.0000000",
          "altText": "Öppet tak med lucka som visar rörsystem med röda och blå ventiler i taket."
        },
        {
          "url": "https://asset.productmarketingcloud.com/api/assetstorage/1311_96fca36e-8cd0-48ee-bed4-7e36223aa68e/original/758991.jpg",
          "contentType": "productInActionImage",
          "lastModified": "2025-03-28T12:56:14.0000000",
          "checksum": "cab332a85fcda6eba27a383079940d5e",
          "linkIndex": 2,
          "createdDate": "2025-03-28T10:10:47.0000000",
          "altText": "Två armar i skjortärmar skriver med pennor på ett vitt papper på ett bord."
        },
        {
          "url": "https://asset.productmarketingcloud.com/api/assetstorage/1311_b491dc9b-08f8-46fc-a16f-5e43edc5b63d/original/758992.png",
          "contentType": "lineDrawing",
          "lastModified": "2025-03-28T12:56:15.0000000",
          "checksum": "a659bb87aaa19b09ac1255e028f2f856",
          "linkIndex": 3,
          "createdDate": "2025-03-28T10:10:48.0000000",
          "altText": "Tvärsnitt av ett tak med flera lager, inkluderar isolering och strukturella element. Numrerade etiketter visar olika delar av konstruktionen."
        },
        {
          "url": "https://asset.productmarketingcloud.com/api/assetstorage/1311_f8d5a263-c017-4e7d-b10e-03a0b12609fd/original/758993.png",
          "contentType": "brandLogo",
          "lastModified": "2025-03-28T12:56:16.0000000",
          "checksum": "87ace2bfb15d9da9e172570d72500b2b",
          "linkIndex": 4,
          "createdDate": "2025-03-28T10:10:48.0000000",
          "altText": "Svart logotyp med texten \"LOGIQ\" bredvid en kvadratisk ikon snedställd som en romb."
        },
        {
          "url": "https://asset.productmarketingcloud.com/api/assetstorage/1311_41359c8f-297a-44dd-9e87-10e44681cf98/original/758994.jpg",
          "contentType": "productSurfaceImage",
          "lastModified": "2025-03-28T12:56:17.0000000",
          "checksum": "99c6a421436b747e4b926f01027cbdcc",
          "linkIndex": 5,
          "createdDate": "2025-03-28T10:10:49.0000000",
          "altText": "Vit och något texturerad yta med en svag ljusglans i hörnet."
        },
        {
          "url": "https://asset.productmarketingcloud.com/api/assetstorage/1311_86de45e7-9212-4ef6-9961-551015738822/original/758995.webp",
          "contentType": "colorSampleImage",
          "lastModified": "2025-03-28T12:56:18.0000000",
          "checksum": "a489a38afb3d00ee9adf943801bdf6de",
          "linkIndex": 6,
          "createdDate": "2025-03-28T10:10:50.0000000",
          "altText": "Vit kräm eller lotion smetad i en cirkel mot en vit bakgrund."
        }
      ],
      "documents": [
        {
          "url": "https://asset.productmarketingcloud.com/api/assetstorage/1311_c7acd6bc-224f-4413-84fa-38e4c1d00180/original/758996.pdf",
          "contentType": "productDataSheet",
          "lastModified": "2025-03-28T12:56:35.0000000",
          "checksum": "8e55bc4304ae618b0853031832b256f9",
          "linkIndex": 0,
          "createdDate": "2025-03-28T10:11:07.0000000",
          "altText": ""
        },
        {
          "url": "https://asset.productmarketingcloud.com/api/assetstorage/1311_e710cfea-d1d8-44ea-b481-7e3d038d108e/original/758997.pdf",
          "contentType": "safetyDataSheet",
          "lastModified": "2025-03-28T12:56:36.0000000",
          "checksum": "6daee30fb8727814ff0af630c6f9798f",
          "linkIndex": 1,
          "createdDate": "2025-03-28T10:11:08.0000000",
          "altText": ""
        },
        {
          "url": "https://asset.productmarketingcloud.com/api/assetstorage/1311_722d1201-e1ea-488f-9da7-204053d25eb9/original/758998.pdf",
          "contentType": "constructionProductDeclaration",
          "lastModified": "2025-03-28T12:56:37.0000000",
          "checksum": "7bb87594bd429524ed2e11a947eb6ee4",
          "linkIndex": 2,
          "createdDate": "2025-03-28T10:11:08.0000000",
          "altText": ""
        },
        {
          "url": "https://asset.productmarketingcloud.com/api/assetstorage/1311_d425a6d8-bd73-433d-928c-3f2ccd35ff63/original/758999.pdf",
          "contentType": "environmentalProductDeclaration",
          "lastModified": "2025-03-28T12:56:38.0000000",
          "checksum": "fc43498903678cb132acaa657d6c1a7e",
          "linkIndex": 3,
          "createdDate": "2025-03-28T10:11:11.0000000",
          "altText": ""
        },
        {
          "url": "https://asset.productmarketingcloud.com/api/assetstorage/1311_4ce40b2b-3809-4d69-91a7-f46b3edc99bb/original/759000.pdf",
          "contentType": "userManual",
          "lastModified": "2025-03-28T12:56:40.0000000",
          "checksum": "f3b8179431bf114225d2a76fd96bf070",
          "linkIndex": 4,
          "createdDate": "2025-03-28T10:11:12.0000000",
          "altText": ""
        },
        {
          "url": "https://asset.productmarketingcloud.com/api/assetstorage/1311_46cce9e5-2e06-4b9d-90c2-dd0cabb7a09a/original/759001.pdf",
          "contentType": "installationInstructions",
          "lastModified": "2025-03-28T12:56:41.0000000",
          "checksum": "54fdc52492d257ecceb6088bbbfef872",
          "linkIndex": 5,
          "createdDate": "2025-03-28T10:11:12.0000000",
          "altText": ""
        },
        {
          "url": "https://asset.productmarketingcloud.com/api/assetstorage/1311_84f6eeb1-78a2-4fb8-baa6-e4938152a757/original/759002.pdf",
          "contentType": "explodedView",
          "lastModified": "2025-03-28T12:56:42.0000000",
          "checksum": "b2006303629bc85e76a4e4ca10d20894",
          "linkIndex": 6,
          "createdDate": "2025-03-28T10:11:14.0000000",
          "altText": ""
        },
        {
          "url": "https://asset.productmarketingcloud.com/api/assetstorage/1311_54364669-a7f6-4ae6-aeec-e02d45cd2233/original/759003.pdf",
          "contentType": "performanceDeclaration",
          "lastModified": "2025-03-28T12:56:42.0000000",
          "checksum": "1e3542e19f050e842f782ec119e1b576",
          "linkIndex": 7,
          "createdDate": "2025-03-28T10:11:15.0000000",
          "altText": ""
        },
        {
          "url": "https://asset.productmarketingcloud.com/api/assetstorage/1311_f6d7058e-0580-4e81-b9df-585f59d94217/original/759004.pdf",
          "contentType": "operationAndMaintenance",
          "lastModified": "2025-03-28T12:56:44.0000000",
          "checksum": "24e43183ada90cd6e0fa9d65187b66bd",
          "linkIndex": 8,
          "createdDate": "2025-03-28T10:11:16.0000000",
          "altText": ""
        },
        {
          "url": "https://asset.productmarketingcloud.com/api/assetstorage/1311_45140c1c-66b3-4f14-bc11-dd9115851c00/original/759005.pdf",
          "contentType": "certificate",
          "lastModified": "2025-03-28T12:56:45.0000000",
          "checksum": "4fd7ad945554ce16ee68b98a25ddf7bd",
          "linkIndex": 9,
          "createdDate": "2025-03-28T10:11:16.0000000",
          "altText": ""
        },
        {
          "url": "https://asset.productmarketingcloud.com/api/assetstorage/1311_1bca7850-a1f3-47dd-a678-250b0f1d84b9/original/759006.pdf",
          "contentType": "disassemblyInstructions",
          "lastModified": "2025-03-28T12:56:47.0000000",
          "checksum": "d680c54f69e95b501c76ac2f92faf90a",
          "linkIndex": 10,
          "createdDate": "2025-03-28T10:11:17.0000000",
          "altText": ""
        }
      ],
      "energyLabels": [
        {
          "url": "https://asset.productmarketingcloud.com/api/assetstorage/1311_ec2458d2-7b03-40fb-84b1-4f2a75e2d48c/original/759007.pdf",
          "contentType": "energyLabelingStickerPdf",
          "lastModified": "2025-03-28T12:57:52.0000000",
          "checksum": "b86bdc6942e0422d5bc6dc53e45e405f",
          "linkIndex": 0,
          "createdDate": "2025-03-28T10:11:25.0000000",
          "altText": ""
        },
        {
          "url": "https://asset.productmarketingcloud.com/api/assetstorage/1311_42e3e585-b875-47cc-82da-455f78d3480a/original/759008.png",
          "contentType": "energyLabelingStickerImage",
          "lastModified": "2025-03-28T12:57:52.0000000",
          "checksum": "922a335942d848d850574aa5cfeafa85",
          "linkIndex": 1,
          "createdDate": "2025-03-28T10:11:25.0000000",
          "altText": ""
        },
        {
          "url": "https://asset.productmarketingcloud.com/api/assetstorage/1311_fd75e766-cd16-46de-bb64-6ebff46f3964/original/759009.pdf",
          "contentType": "productDataSheetEnergyLabeling",
          "lastModified": "2025-03-28T12:57:53.0000000",
          "checksum": "e994aa1bb84bf127e9606a0227a16345",
          "linkIndex": 2,
          "createdDate": "2025-03-28T10:11:26.0000000",
          "altText": ""
        }
      ],
      "designFiles": [
        {
          "url": "https://asset.productmarketingcloud.com/api/assetstorage/1311_9ea76412-b21a-4fad-aa87-c0ce6814ad92/original/759010.dwg",
          "contentType": "cadFile",
          "lastModified": "2025-03-28T12:57:35.0000000",
          "checksum": "9d585313457056bbe38959731638fc9f",
          "linkIndex": 0,
          "createdDate": "2025-03-28T10:11:29.0000000",
          "altText": ""
        }
      ],
      "externalAssets": {
        "youtubeInstallation": "https://youtu.be/u_i0zRzBPOQ?si=L3HSmF0sqh1zCFW7",
        "youtubeMarketing": "https://youtu.be/u_i0zRzBPOQ?si=L3HSmF0sqh1zCFW7"
      },
      "spareParts": [
        6364041
      ],
      "accessories": [
        4197202
      ]
    }
  ]
}

Allmän information

Skillnader mellan v2.0/media och v2.1/media

Exempel på data i v2.1/media

Skillnader mellan v2.1/media och v2.2/media

Tidsbaserad hämtning

Pagination - begränsning/förskjutning krävs om följande variabler används

Övriga noteringar

Artikelinformation

Textfält

AI-genererade texter

Alt-texter

Länkade resurser

Format på bilder

heroImage

images

documents

designFiles

energyLabels

externalAssets

accessories / spareParts

Exempel på ett API-svar