Dokumentation
Hem API integration Product

Product

Skapad 6 år sedan, uppdaterad 3 år sedan · Läst av 3 981

GetProductsByPage

Annonser har vi benämt som produkter. Vi har alltid flera tusen aktuella produkter vilket gör att det tar mycket tid att visa alla posterna. Därför delas alltid anropen upp där man gör ett urval för hur många poster som kan hämtas upp i ett anrop. Vi har som standard 40 poster per anrop och likt paging kallat detta som sidor. Första sidan är 0 som då blir post 1-40. Andra sidan är 1 som blir post 41-80 osv. 

GEThttps://mcparken.se/api/products/getproductsbypage/{id}

För att få en access_token så behöver du skicka med 1 header och två parametrar i ditt anrop. 

För att anropa Product så finns det tre inparametrar

idnumerisktAnge sidnummer, första sidan är 0 och innehåller de senast registrerade posterna. Här visas inte de poster som är sålda eller markerade som dolda
access_token(header) strängAnge access token för att få tillgång att göra ett anrop till databasen

Exempel på anrop

När du skickar anropet så är det en parameter som skall läggas till, pageid. Den första och senast tillagda posten visas överst. Pageid börjar med 0 sedan vidare till slutet. 

var myHeaders = new Headers();
myHeaders.append("access_token", "yoursecretapikey");

var requestOptions = {
  method: 'GET',
  headers: myHeaders,
  redirect: 'follow'
};

fetch("https://mcparken.se/api/products/getproductbypage/0", requestOptions)
  .then(response => response.text())
  .then(result => console.log(result))
  .catch(error => console.log('error', error));

Exempel på resultat

Det finns en mängd data på varje post.

{
        "productid": 31450,
        "createdbyid": 1767,
        "transactiontypeid": 1,
        "categoryid": 2,
        "companyid": 29,
        "strregnr": "SGH87A",
        "strchassinummer": "ZAPMD310000003396",
        "märkeid": 75,
        "strmodell": "Vespa GTS 300 Racing Sixties",
        "strmodellbeteckning": "",
        "dteförstregistrerad": "2021-02-23T00:00:00",
        "strmodellår": "2021",
        "lngmätarställning": 325,
        "strfärg": "Vit",
        "lngtjänstevikt": 160,
        "lngmotoreffekt": 24,
        "lngtoppfart": 120,
        "karossid": 1,
        "växellådaid": 2,
        "drivmedelid": 1,
        "fordonstypid": 4,
        "lngmotorvolym": 278,
        "kubikid": 17,
        "däckfram": "120/70 12 51P",
        "däckbak": "130/70 12 62P",
        "lngförsäljningspris": 59900,
        "lngnyttpris": 0,
        "lngrestvärde": 0,
        "dteprisförändringsdatum": "1900-01-01T00:00:00",
        "privatleasing": 0,
        "avdragbarmoms": 0,
        "lngshoworiginalprice": 0,
        "preregistered": 0,
        "hideregnr": 0,
        "hidephonenr": 0,
        "försäkringsklassid": 0,
        "dtenästabesiktning": "2025-03-31T00:00:00",
        "intwarrentyearleft": 0,
        "lngservicekostnad": 0,
        "strexternlänk": "https://www.blocket.se/annons/stockholm/piaggio_vespa_gts_300_racing_sixties/98739302",
        "a2": -1,
        "bkort": 0,
        "forsaljningsuppdrag": 0,
        "blocketid": "98739302",
        "lngpublishblocket": 0,
        "publishfacebookwall": 1,
        "sitthöjdid": 2,
        "lnginköpspris": 0,
        "lngförsäljningsmarginal": 0,
        "lnglägstapris": 0,
        "beskrivning": "Piaggio Vespa GTS 300 Racing Sixties\r\r\nMätarställning: 325 mil\r\r\nFärg: Bianco Innocenza\r\r\nTyp: Scooter\r\r\nVespa GTS  300 HPE Racing Sixties ,  Reg nr:  SGH87A.   Demoex!   Besiktigad t.o.m.2025-03-31.   Max effekt:  24 Hk,5 L.  Vi hjälper dig att finansiera ditt mc köp via Santander Consumer Bank. Med ProBikes märkesförsäkring via Svedea (https://www.svedea.se) så får du marknadens bästa premier och villkor. Välkomna till Probike Sthm  Syd.",
        "metadata": "",
        "verkstadsinfo": "Tjänstevikt: 160 Kg\r\nSitthöjd: 790 mm\r\nTankvolym: 8\r\n",
        "leveranstid": "",
        "anteckningar": "",
        "lngpublic": 1,
        "lngregionid": 0,
        "lngmiljöfordon": 0,
        "dtecreated": "2021-12-12T22:23:03.797",
        "dtepublishdate": "2021-12-12T00:00:00",
        "soldatid": 0,
        "sellerid": 1767,
        "readcount": 1,
        "phonecount": 0,
        "messagecount": 0,
        "nyränta": 0.0000,
        "nyavbetalningsperiod": 0,
        "imagelist": "1000028994.jpg,1000028995.jpg,1000028996.jpg,1000028997.jpg,1000028998.jpg,1000028999.jpg",
        "märke": [
            {
                "märkeid": 75,
                "strmärke": "Piaggio",
                "company": [
                    {
                        "companyid": 29,
                        "companyname": "PROBIKE STHLM SYD SKÄRHOLMEN",
                        "orgnumber": "556095-7689",
                        "address": "Murmästarvägen 25",
                        "postal": "127 35",
                        "homepage": "www.probike.se",
                        "email": "verkstadsyd@probike.se",
                        "invoiceemail": "verkstadsyd@probike.se",
                        "openinghour": "11:00,18:00,11:00,18:00,11:00,18:00,11:00,18:00,11:00,18:00,11:00,15:00",
                        "phone": "08-522 255 00",
                        "city": "Skärholmen",
                        "inriktning": "1,2,",
                        "description": "Vår butik har ett unikt läge utmed Sveriges mest trafikerade väg. Vi är en fullservice-anläggning för alla befintliga och blivande mopedister och motorcyklister. Vi säljer nya Harley-Davidson, Piaggio, Vespa, Gilera, Aprilia, Moto Guzzi, Kawasaki och Derbi, men vi har också ett riktigt stort utbud av begagnade fordon av alla märken samt ett lika stort urval delar, tillbehör och personlig utrustning. \r\n\r\nKom in så bjuder vi på en kaffe och berättar mer om oss och våra produkter!",
                        "yearlypayment": 5,
                        "ränta": 0.0000,
                        "regionid": 7,
                        "latitude": 5.927550000000000e+001,
                        "longitude": 1.790200000000000e+001,
                        "loanpartner": "0",
                        "arrangementcost": 0,
                        "avicost": 0,
                        "header": "Sveriges förmodligen största MC-butik",
                        "started": "2010",
                        "inriktning2": "1,",
                        "dtecreated": "2020-01-27T22:57:45.653",
                        "dteupdated": "2021-06-02T00:27:40.280",
                        "blocketlink": "https://www.blocket.se/butik/probike-sthlm-syd",
                        "companykey": "M3gxV1RVSDhGZklIUHdCUWRmM3Vmdz09",
                        "companykeyexpires": "2022-06-02T00:00:00",
                        "åf": "",
                        "verkstad": "",
                        "readcount": 331,
                        "watchagreement": -1,
                        "barter": 0,
                        "premiumcustomer": -1,
                        "kvittoslack": -1,
                        "annonsbekräftelse": 0,
                        "publicerafacebook": -1,
                        "blocketusername": "",
                        "blocketcompanyname": "",
                        "contactaction": 0,
                        "contactdate": "1900-01-01T00:00:00",
                        "contactreminder": "1900-01-01T00:00:00",
                        "contactperson": "",
                        "contactprofession": "",
                        "contactemail": "",
                        "contactphone": "",
                        "contactresponsible": 0,
                        "prisskylt_totalkostnad": 0,
                        "contentpriority": 0,
                        "comments": "",
                        "usr": [
                            {
                                "lnguserid": 1767,
                                "strfirstname": "Christoffer",
                                "strlastname": "Lindroth",
                                "strmobile": "1",
                                "stremail": "pelle@mcparken.se",
                                "strusername": "probike",
                                "strmemberid": "vPelNrzLabeGOYF6LMYvZA==",
                                "strssn": "",
                                "strabout": "testkonto",
                                "strcomment": "",
                                "dtecreated": "2021-06-01T16:16:35.517",
                                "dtelastaccessed": "2021-11-12T21:11:20.357",
                                "dtelockeduntil": "1900-01-01T00:00:00",
                                "lngcompanyid": 29,
                                "lngcompanyroles": 2,
                                "lngrights": 7,
                                "lngsystems": 1,
                                "lngtotalaccess": 4,
                                "preferredlanguageid": 1,
                                "latitude": 0.000000000000000e+000,
                                "longitude": 0.000000000000000e+000,
                                "clientconnectionid": "f2aeadf6-fef9-4541-955a-17dffb42bb51",
                                "allowmail": 1,
                                "sendmailonnewproducts": 1,
                                "sendmailonmessage": 1,
                                "sendmailonpricechanges": 1,
                                "sendmailonlike": 1,
                                "sendsmsonevent": 0,
                                "deleted": 0,
                                "totalrows": 2094,
                                "pris": 59900,
                                "ägare": 2
                            }
                        ]
                    }
                ]
            }
        ]
    }

Regelverk

AnnonsprisPå varje post finns det logik för priset. Normalt sett är lngförsäljningspris värdet för vad produkten kostar. Men, om fältet lngnyttpris innehåller ett värde, oavsett om det är lägre eller högre så är det detta pris som gäller. Så fort ett pris på en annons ändras så är det fältet lngnyttpris som uppdateras. lngförsäljningspris är alltid ursprungspriset och ändras inte. Om dteprisförändringsdatum som är senare än nu, så skall inte lngnyttpris visas och användas förrän datum och tid har passerat. På sajten används skillnaden mellan försäljnings- och nytt pris för att markera prishöjning eller sänkning, samt att maila ut vilka poster som bytt pris det innevarande dygnet.



Bildhantering

En annons kan innehålla både bilder och video. Bilderna görs om till 3 format. Dels original men även en för medium och en för small för att minska laddtider när många annonser visas samtidigt. För filmerna skapas också två mindre bilder som kan användas. Sökvägen fungerar på följande sätt. Productid används för att separera bilderna per annons. Observera att normalbild för video inte finns utan endast medium och small-bilder.

Originalbilder och video: https://mcparken.se/upload/{productid}/bild.webp - för video gäller motsvarande  https://mcparken.se/upload/{productid}/film.mp4. Motsvarande logik i sökvägen är det för medium och small-bilderna. https://mcparken.se/upload/{productid}/m/bild.webp samt https://mcparken.se/upload/{productid}/s/bild.webp. 

Innehåll