PRODUKTINFORMASJON OG LAGERBEHOLDNING
Hadde det ikke vært fint å ha en datamodell med informasjon om alle produktene og deres lagerstatus på Vinmonopolet.
Tenk deg mulighetene! Du kunne bli varslet når en ny årgang av din favoritt vin kom inn på lager eller når vinmonopolet reduserte prisen.
Hvis du er en norsk siderprodusent så kunne du følge med på hvilke norske sidere er på markedet, deres karakteristikker (syre, sødme, alkoholprosent) og hvor mye de solgte. Videre kunne du se utviklingen overtid. Når kom produktene inn på polet og når ble de utsolgt.
Dette er fullt mulig å lage en løsning for med Vinmonopolets åpent tilgjengelige API som i tillegg er gratis!
Vinmonopolet har en egen portal for sitt API.
Det finnes en egen ISO-standard for språkkoder. Ikke bruk landkoder for å angi språk! «Er'e så nøye 'a?» tenker du. Jeg har sett utviklere bruke landets retningsnummer. Dette bryter fort sammen. Et land kan ha flere språk (bokmål og nynorsk). Flere land kan snakke samme språk (fransk i Canada og Sveits). Et språk kan variere i ulike land (amerikansk engelsk og britisk engelsk). Disse detaljene har du ikke tid å tenke på når det går raskt i svingene. Lever heller kvalitet i tide med en standardtabell for språkkoder :-)
Tenk deg mulighetene! Du kunne bli varslet når en ny årgang av din favoritt vin kom inn på lager eller når vinmonopolet reduserte prisen.
Hvis du er en norsk siderprodusent så kunne du følge med på hvilke norske sidere er på markedet, deres karakteristikker (syre, sødme, alkoholprosent) og hvor mye de solgte. Videre kunne du se utviklingen overtid. Når kom produktene inn på polet og når ble de utsolgt.
Dette er fullt mulig å lage en løsning for med Vinmonopolets åpent tilgjengelige API som i tillegg er gratis!
Vinmonopolet har en egen portal for sitt API.
Det finnes en egen ISO-standard for språkkoder. Ikke bruk landkoder for å angi språk! «Er'e så nøye 'a?» tenker du. Jeg har sett utviklere bruke landets retningsnummer. Dette bryter fort sammen. Et land kan ha flere språk (bokmål og nynorsk). Flere land kan snakke samme språk (fransk i Canada og Sveits). Et språk kan variere i ulike land (amerikansk engelsk og britisk engelsk). Disse detaljene har du ikke tid å tenke på når det går raskt i svingene. Lever heller kvalitet i tide med en standardtabell for språkkoder :-)
VINMONOPOLET API PORTAL
DE NORDISKE SPRÅKENE
For å komme i gang må du først opprette en brukerprofil hos Vinmonopolet.
Norden er et geografisk område som består av de nordeuropeiske landene Norge, Sverige, Finland, Danmark og Island. Dette inkluderer de danske selvstyrte områdene Grønland og Færøyene samt det finske selvstyrte området Åland.
Vi har også tatt med engelsk som språk fordi IT-løsninger ofte utvikles med engelsk som standardspråk.
Norden er et geografisk område som består av de nordeuropeiske landene Norge, Sverige, Finland, Danmark og Island. Dette inkluderer de danske selvstyrte områdene Grønland og Færøyene samt det finske selvstyrte området Åland.
Vi har også tatt med engelsk som språk fordi IT-løsninger ofte utvikles med engelsk som standardspråk.
|
|
|
|
Last ned datasettet for Norden som et Excel-dokument eller en CSV-fil i ANSI/Windows-format:
|
|
| ||||
|
|
PRODUKTER
Returnerer informasjon om Vinmonopolets produkter i basisutvalget, testutvalget, partiutvalget eller bestillingsutvalget.
Informasjonen blir oppdatert kl 05:45 CET hver dag. Bruk parameteren changedSince for å få kun oppdaterte produkter, inkludert produkter som er fjernet fra basisutvalget, testutvalget, partiutvalget eller bestillingsutvalget siden leveringsdato. Maks 60 kall per minutt. Maks 4000 kall per dag.
Informasjonen blir oppdatert kl 05:45 CET hver dag. Bruk parameteren changedSince for å få kun oppdaterte produkter, inkludert produkter som er fjernet fra basisutvalget, testutvalget, partiutvalget eller bestillingsutvalget siden leveringsdato. Maks 60 kall per minutt. Maks 4000 kall per dag.
https://apis.vinmonopolet.no/products/v0/details-normal[?productId][&vendorId][&manufacturerId][&wholesalerId][&changedSince][&productShortNameContains][&maxResults][&start]
Request header |
Obligatorisk |
Datatype |
Beskrivelse |
Ocp-Apim-Subscription-Key |
Ja |
String |
Abonnementsnøkkel i profilen din som gir tilgang til API-et. |
Request parameter |
Obligatorisk |
Datatype |
Beskrivelse |
productId |
Nei |
Integer |
Returnerer detaljert informasjon om alle produktene som samsvarer med angitt productId. |
vendorId |
Nei |
Integer |
Returnerer detaljert informasjon om alle produktene som samsvarer med angitt vendorId. |
manufacturerId |
Nei |
Integer |
Returnerer detaljert informasjon om alle produktene som samsvarer med angitt manufacturerId. |
wholesalerId |
Nei |
Integer |
Returnerer detaljert informasjon om alle produktene som samsvarer med angitt wholesalerId. |
changedSince |
Nei |
String |
Returnerer detaljert informasjon om alle produktene som er oppdatert etter den angitt datoen (yyyy-MM-dd). |
productShortNameContains |
Nei |
String |
Returnerer detaljert informasjon om alle produkter hvor productShortName inneholder den angitte teksten |
maxResults |
Nei |
Integer |
Begrenser maksimalt antall produkter som returneres i hver forespørsel. |
start |
Nei |
Integer |
Utelukker antall leverte produkter, sortert etter produktID. |
Response header |
Obligatorisk |
Datatype |
Beskrivelse |
x-total-count |
Nei |
Integer |
Totalt antall poster som tilfredsstiller forespørselskriteriene. |
link |
Nei |
String |
Lenker til forrige/neste side. |
Response status |
Beskrivelse |
200 OK |
Vellykket operasjon. |
400 Bad Request |
Ugyldig forespørsel (feil parameterverdier angitt). |
500 Internal Server Error |
Feil. |
|
Last ned datasettet for Norden som et Excel-dokument eller en CSV-fil i ANSI/Windows-format:
|
|
| ||||
LAGERBEHOLDNING
Returnerer daglig akkumulert lagerbeholdning for basisutvalget, testutvalget, partiutvalget eller bestillingsutvalget.
Lagerbeholdningen oppdateres klokka 08:30 CET hver dag. Maks. 20 kall per minutt. Maks 400 kall per dag.
Lagerbeholdningen oppdateres klokka 08:30 CET hver dag. Maks. 20 kall per minutt. Maks 400 kall per dag.
https://apis.vinmonopolet.no/products/v0/accumulated-stock[?productId][&changedSince][&includeZeroStock][&maxResults][&start]
Request header |
Obligatorisk |
Datatype |
Beskrivelse |
Ocp-Apim-Subscription-Key |
Ja |
String |
Abonnementsnøkkel i profilen din som gir tilgang til API-et. |
Request parameter |
Obligatorisk |
Datatype |
Beskrivelse |
productId |
Nei |
Integer |
Returnerer lagerbeholdning på produkter med angitt productId. |
changedSince |
Nei |
String |
Returnerer lagerbeholdning på produkter som er oppdatert etter den angitt datoen (yyyy-MM-dd). |
includeZeroStock |
Nei |
Boolean |
Inkluder produkter som selges hvor lagerbeholdningen er 0 (null). |
maxResults |
Nei |
Integer |
Begrenser maksimalt antall produkter som returneres i hver forespørsel. |
start |
Nei |
Integer |
Utelukk antall leverte produkter, sortert etter produktID. |
Response header |
Obligatorisk |
Datatype |
Beskrivelse |
x-total-count |
Nei |
Integer |
Totalt antall poster som tilfredsstiller forespørselskriteriene. |
link |
Nei |
String |
Lenker til forrige/neste side. |
Response status |
Beskrivelse |
200 OK |
Vellykket operasjon. |
|
Last ned datasettet for Norden som et Excel-dokument eller en CSV-fil i ANSI/Windows-format:
|
|
| ||||
ISO 639 LANGUAGE CODES
ISO 639 definerer internasjonalt anerkjente koder for representasjon av mer enn 500 språk og språkfamilier.
Codes for the Representation of Names of Languages
Part 5: Alpha-3 code for language families and groups
Codes for the Representation of Names of Languages
Part 5: Alpha-3 code for language families and groups
- ISO 639-1: Alpha-2 code
- ISO 639-2: Alpha-3 code - https://www.loc.gov/standards/iso639-2/php/code_list.php
- ISO 639-3: Alpha-3 code for comprehensive coverage of languages
- ISO 639-4: Implementation guidelines and general principles for language coding
- ISO 639-5: Alpha-3 code for language families and groups - https://www.loc.gov/standards/iso639-5/id.php
- ISO 639-6: Alpha-4 code for comprehensive coverage of language variants
ISO 639 er en av flere internasjonale standarder for språkkoder. Den består av flere deler, hvorav tre, ISO 639-1, ISO 639-2 og ISO 639-3 er i bruk, mens de andre er under utarbeidelse. I Norge anbefaler staten å bruke ISO 639 for deklarering av språkkoder for offentlige nettsider (i HTML).
De eksisterende standardene er:
Øvrige deler av ISO 639 er:
https://no.wikipedia.org/wiki/ISO_639
De eksisterende standardene er:
- ISO 639-1: Koder for navn på språk, alfa-2-kode (to bokstaver), nåværende liste publisert 2002
- se = Davvisámegiella (Nordsamisk)
- nn = Nynorsk,
- nb = Norsk bokmål,
- ISO 639-2: Koder for navn på språk, alfa-3-kode (tre bokstaver), nåværende liste publisert 1998
- sme = Davvisámegiella (Nordsamisk)
- nno = Nynorsk,
- nob = Norsk bokmål,
- ISO 639-3: Koder for navn på språk, mer omfattende dekning (publisert 2007)
- nob = Norsk bokmål
Øvrige deler av ISO 639 er:
- ISO 639-4: Retningslinjer for implementering og generelle prinsipper for språkkoding (publisert 2010).
- ISO 639-5: Koder for språkfamilier og -grupper (publisert 2008).
- ISO 639-6: Koder for navn på språk, alfa-4-kode, omfattende dekning av språkvariasjoner (publisert 2009), som senere er trukket tilbake.
https://no.wikipedia.org/wiki/ISO_639
http://www.iso.org/iso/country_codes
http://unstats.un.org/unsd/methods/m49/m49alpha.htm
http://gis.stackexchange.com/questions/1047/full-list-of-iso-alpha-2-and...
http://unstats.un.org/unsd/methods/m49/m49alpha.htm
http://gis.stackexchange.com/questions/1047/full-list-of-iso-alpha-2-and...
Internasjonal Standard for landskoder og koder for sine regioner
Land og landkoder
Datasettet inneholder en to-bokstavs landkode og norsk navn på landet. Kodene følger den internasjonale standarden ISO-3166. Datasettet er hentet fra Statistisk sentralbyrås System for klassifikasjoner og kodelister.
