Webperfs API
Work-in-progress
Mer information och dokumentation kommer löpande. Om inget annat anges är det JSON-format på svaren.
1. Öppna data
De data som Webperf släpper som öppna data går under licensen CC BY-SA 4.0. Det innebär att du behöver göra ett korrekt erkännande (att datakällan är Webperf) och om du delar datakällan vidare, eller bearbetar den, ska den behålla samma licens.
1.1 URL till kommuners och regioners webbplatser
De URL:ar du får ur denna API-endpoint är till startsidan för kommuners och regioners webbplatser så som det
sparats hos Webperf.se
Notera att Visby kommun i denna lista ersatts av Region Gotland.
GET
https://api.webperf.se/public-sector/
Data i svaret är följande:
- api_version är ett versionsnummer (decimal) som förklarar vilken version av API:t du nått. Bra som referens ifall du sparar ner resultatet.
- result_count heltal om hur många unika webbplatser som finns i listan med data.
- timestamp datum och klockslag (timestamp) på serversidan när resultatet senast uppdaterades.
- data lista med webbplatser, som innehåller följande data:
- category textsträng som antingen är Municipality, det vill säga en kommun, eller Region om det är en region.
- sameAs är en URI (sträng) med hänvisning till samma organisation på Wikidata.
- title textsträng med namnet på organisationen.
- uri textsträng med referens till organisationen på Webperf. Work-in-progress. Kommer URL:ar till Webperf-internt innehåll på sikt.
- url textsträng för organisationens adress till startsida på webbplats.
Poängen med URI:er till Wikidata? Länkade data!
"Länkade data är en metod för att publicera strukturerad data på ett sätt som gör det möjligt att följa kopplingar mellan informationsobjekt över flera källor. Länkade data bygger på webbstandarder som HTTP och URI:er men istället för att använda dem för att presentera information för människor är syftet att göra data läsbart för maskiner. Målet är att möjliggöra för vitt skilda aktörer att beskriva sin information på ett enhetligt sätt och därmed förenkla återanvändning och interoperabilitet."
Du kan alltså relatera information hos Webperf med Wikidata, vilket gör att du kan hämta dels ännu mer data men också koppla till olika Wikipedia-artiklar du kan vilja bearbeta. Detta gör datakällan maskinläsbar och kan bearbetas automatiserat i din egen tillämpning.
Det kan vara bra om du vill automatisera hämtningen av kommuners namn på andra språk, vilket landskap de ingår i, storlek på befolkning, deras officiell mejladress, bilder från Wikimedia och allt annat som erbjuds av Wikidata. Se exempelvis Wikidatas URI för Åmåls kommun.
Kodexempel för dig som vill komma igång med Webperfs öppna data
På Webperfs Github-konto finns kodexempel du kan återanvända eller ta inspiration ifrån.
- 01 - Kodexempel för api.webperf.se hämtar kommuner och regioner från Webperf, ansluter till respektive webbplats, kollar in sidtitlarna, hämtar befolkningsdata från Wikidata.
1.2 Beständig URI (för kommuner och regioner)
En URI är en identifierare inom (länkade) öppna data-världen. Den är tänkt att vara bestående och en unik
referens som du kan stöta på i datamängder från Webperf. Det står även utomstående parter fritt att använda
dessa URI:er.
Du hittar URI:er i respektive listning och de går också att slå upp. En URI för Webperf följer nedan syntax och ger den publika information som finns att lämna ut.
Har du Premium? Då kan du få ut din egen data och de övergripande betygen bara du anger en API-nyckel. Se mer om URI:er för Premium.
GET
https://api.webperf.se/item/nummer
Exempelvis följande för Västra Götalandsregionen:
GET
https://api.webperf.se/item/141
Data i svaret är följande:
- api_version är ett versionsnummer (decimal) som förklarar vilken version av API:t du nått. Bra som referens ifall du sparar ner resultatet.
- timestamp datum och klockslag (timestamp) på serversidan när resultatet senast uppdaterades.
- data listar information om webbplatsen:
- category textsträng som antingen är Municipality, det vill säga en kommun, eller Region om det är en region.
- sameAs är en URI (sträng) med hänvisning till organisationen på Wikidata.
- title textsträng med namnet på organisationen.
- uri textsträng med referens till organisationen på Webperf. Work-in-progress. Kommer URL:ar till Webperf-internt innehåll på sikt.
- url textsträng för organisationens adress till startsida på webbplats.
2. Webperfs premium API
Snabblänkar till premiums endpoints:
- 2.1 Hämta era senaste betyg
- 2.2 Historiska betyg
- 2.3 Testa om startsida
- 2.4 Starta privata tester
- 2.5 Hämta lista med dina privata tester
- 2.6 Hämta testresultat för ett av dina privata tester
- 2.7 Din egen URI ger dig dina senaste övergripande betyg
- 2.8 Få en texts läsbarhetsindex (LIX)
Enbart för dig med Webperf premium-konto av varianterna mellan eller stor. Några få har köpt till API för sitt konto, ifall det gäller dig ser du i menyn om du loggar in i Premium. Du behöver via ditt premium-konto hämta ut
din API-nyckel för att komma igång. Om du inte har din API-nyckel ännu loggar du in på premium.webperf.se och klickar på Min API-nyckel i menyn för att skapa en.
Läs mer om Webperfs olika premium-konton »
Premiums API:er versionshanteras för att du ska kunna lita på att dina integrationer inte plötsligt går
sönder. Respektive version stöds som minst i 6 månader och det kan komma att bli längre när API:t släpps i
nyare versioner framgent.
Dock så måste du inte välja en version i dina anrop, men om du gör det så är det ett mellanled med ett decimaltal i nedan API-endpoints. Om du inte väljer en versionshanterad endpoint får du alltid den senaste versionen.
Om du inte har premium men vill provköra kan du testa det demokonto som finns för Webperf.se som sajt. Då är det API-nyckel 989089bfe899d6992ff320a97 och webbplatsens id-nummer 3843 du använder.
Söker du kodexempel för att jobba med premium-API?
Det finns kodexempel i Python på nedan länk. Det körs i Jupyter Notebook, vilket också är kompatibelt med Google Colab som miljö om du föredrar det.
Med kodexemplet kan du interagera med premium-API:t genom att fråga vilket id-nummer din webbplats har, hämta de senaste resultaten, historiska genomsnittsbetyg samt skapa en graf över genomsnittsbetygen över tid.
Detta är just kodexempel. För att ge inspiration om vad man kan göra för att komma igång med premium-API:t. Det finns säkert andra automatiseringar och integrationer du kommer att tänka på.
- 02 - Kodexempel för premium-API (Github, uppdaterad 2023-07-24)
2.1 Hämta era senaste betyg
Här får du i JSON-format ut samma tester som du kan se på Webperf.se som testresultat.
Inledningsvis vet du kanske inte om vilket id-nummer din webbplats har. Då kan du ställa nedan API-fråga tillsammans med din API-nyckel så kommer du få reda på vilka id-nummer du har behörighet till. Detta framgår också Info-sidan om du loggar in på premium.
GET
https://api.webperf.se/stats/
https://api.webperf.se/0.1/stats/
HTTP-header
Key: api-key
Value: din-api-nyckel
När du vet om webbplatsens id-nummer så är din API-endpoint följande för att få ut statistik:
GET
https://api.webperf.se/stats/nummer
https://api.webperf.se/0.1/stats/nummer
HTTP-header
Key: api-key
Value: din-api-nyckel
Det kan se ut så här om du använder Webperf.se's demokonto:
GET
https://api.webperf.se/stats/3843
HTTP-header
Key: api-key
Value: 989089bfe899d6992ff320a97
Data i svaret är följande:
- api_version är ett versionsnummer (decimal) som förklarar vilken version av API:t du nått. Bra som referens ifall du sparar ner resultatet.
- uri textsträng med referens till vilken webbplats på Webperf testresultaten tillhör.
- result_count heltal om hur många unika tester som finns i listan med data.
- timestamp datum och klockslag (timestamp) på serversidan när resultatet senast uppdaterades.
- data listar de senaste testresultaten:
- type_of_test heltal som identifierar typ av test som utförts.
- rating decimaltal med betyget för det aktuella testet.
- test_date tidstämpel på serversidan för när testet genomfördes.
- check_report textsträng med det huvudsakliga testresultatet, i läsbar form.
- check_report_a11y textsträng med testresultatet som gäller tillgänglighet, i läsbar form.
- check_report_perf textsträng med testresultatet inom webbprestanda, i läsbar form.
- check_report_sec textsträng med testresultatet för informationssäkerhet, i läsbar form.
- check_report_stand textsträng med testresultatet när det gäller webbstandarder, i läsbar form.
- json_check_data JSON-formaterad textsträng med testresultatet. Används i ett fåtal testtyper.
2.2 Historiska betyg
Webperf har samlat in testresultat i många år för vissa webbplatser. Exempelvis månatligen för alla kommuner sedan sommaren 2018. Alla betyg ingår i en sorts "kategoribetyg" vilket är det du ser redovisas i de återkommande månadsrapporterna på Webperf.se, men det kan vara jobbigt att sammanställa sina egna data ur dessa rapporter. Därför finns den här API-endpointen.
GET
https://api.webperf.se/stats_per_month/nummer
https://api.webperf.se/0.1/stats_per_month/nummer
HTTP-header
Key: api-key
Value: din-api-nyckel
Det kan se ut så här om du använder Webperf.se's demokonto:
GET
https://api.webperf.se/stats_per_month/3843
HTTP-header
Key: api-key
Value: 989089bfe899d6992ff320a97
Data i svaret är följande:
- api_version är ett versionsnummer (decimal) som förklarar vilken version av API:t du nått. Bra som referens ifall du sparar ner resultatet.
- uri textsträng med referens till vilken webbplats på Webperf testresultaten tillhör.
- result_count heltal om hur många unika månadsbetyg som finns i listan med data. Inte att förväxla med antal månader. En och samma månad kan ha en handfull olika betyg i ditt resultat. Se type_of_score nedan.
- timestamp datum och klockslag (timestamp) på serversidan när resultatet senast uppdaterades.
- data listar de samtliga testresultats genomsnittsbetyg:
- data_id heltal som identifierar beräkningen av månadsbetyget. Främst till vid felsökning.
- score decimaltal med genomsnittsbetyget för aktuell månad och de tester som ingår i den typen av test. Se type_of_score.
- timeperiod datumangivelse i format yyyy-mm och är inom den period testerna genomfördes.
- type_of_score textsträng som identifierar vilken typ av tester som räknats samman till ett genomsnittsbetyg för månaden. Alternativen är ganska självförklarande; kat-total totalbetyg för samtliga tester, kat-infosec för informationssäkerhet/integritet, kat-a11y för tillgänglighet, kat-perf för allt inom webbprestanda och kat-webstandard för följsamhet till webbstandarder.
2.3 Testa om startsida
Vill du manuellt köra om testerna av din webbplats för att Webperf.se ska ta en ny titt? Testet gäller startsidan av din webbplats och resultatet kommer att publiceras på Webperf.se när testet är klart, samt att du via API:t kan nå de nya testerna via 2.1 Hämta era senaste betyg.
Du har ett begränsat antal krediter per 4 veckor att göra dessa omtester. Du kan inte övertrassera, det är upp till Webperf att stoppa dig. Så ös på.
Numret du anger är webbplatsens id-nummer. Om du inte känner till din webbplats id-nummer kör du API-frågan under 2.1 Hämta era senaste betyg så får du den i svaret.
POST
https://api.webperf.se/retest/
https://api.webperf.se/0.1/retest/
HTTP-header
Key: api-key
Value: din-api-nyckel
Key: site-id
Value: nummer
Valfritt – ifall du bara vill köra vissa tester:
Key: testnums
Value: [1, 2, 4, 5, 8, 9, 10, 15, 17,18, 20, 21, 22, 23, 24, 25]
Det kan se ut så här om du använder Webperf.se's demokonto:
POST
https://api.webperf.se/retest/
HTTP-header
Key: api-key
Value: 989089bfe899d6992ff320a97
Key: site-id
Value: 3843
Svaret på din POST är statuskod 200 om det gick bra och en textbekräftelse i stil med "Website with site-id 3843 will be retested in a couple of minutes". Om något gick fel i serverns ände är det error 500. Ifall du glömde posta med site-id eller api-key får du statuskod 400.
2.4 Starta privata tester
Det går att testa upp till 10 valfria undersidor per anrop till API:t. Antalet sidor du kan testa styrs av vilken nivå av premium din webbplats har. Ifall du har en av de större premium-varianterna har du utrymme att göra flera API-postningar i följd och sedan invänta att testresultaten kommer in under de 15-30 minuter det brukar kunna ta.
Se 2.5 Hämta lista med dina privata tester för hur du via API:t kommer över de API-anrop du gör för att nå dessa privata tester.
Du har ett begränsat antal krediter per 4 veckor att göra dessa omtester. Du kan inte övertrassera, det är upp till Webperf att stoppa dig. Så ös på.
POST
https://api.webperf.se/test_once/
https://api.webperf.se/0.1/test_once/
HTTP-header
Key: api-key
Value: din-api-nyckel
Key: site-id
Value: nummer
HTTP-body
Key: urls
Value: url1
eller
Value: url1, url2, url3 – url10
Det kan se ut så här om du använder Webperf.se's demokonto:
POST
https://api.webperf.se/test_once/
https://api.webperf.se/0.1/test_once/
HTTP-header
Key: api-key
Value: 989089bfe899d6992ff320a97
Key: site-id
Value: 3843
HTTP-body
Key: urls
Value: https://webperf.se/articles/nyhetsbrev-38/, https://webperf.se/tag/tillganglighet/
Svaret på din POST är statuskod 200 om det gick bra och en text i stil med "A once only test for # URL's belonging to site-id 3843 will be performed in a couple of minutes. The endpoint(s) is/are: {6481: 'https://api.webperf.se/private_stats/3843/6481', 6479: 'https://api.webperf.se/private_stats/3843/6479', 6477: 'https://api.webperf.se/private_stats/3843/6477', 6475: 'https://api.webperf.se/private_stats/3843/6475'}".
Ifall du får statuskod 400 har du överskridit din kvot för de innevarande 4 veckorna.
2.5 Hämta lista med dina privata tester
Dessa kallas privata tester eftersom de inte är åtkomliga öppet på Webperf.se eller andra användare av API:t än de med samma behörighet som du.
Med nedan API-svar får du ut URI:er för att hämta ut samtliga testresultat för en privat testad URL. Denna API-URI kräver att du anger din API-nyckel för att få ut svaret, se 2.6 Hämta testresultat för ett av dina privata tester nedan.
GET
https://api.webperf.se/private_stats/nummer
https://api.webperf.se/0.1/private_stats/nummer
HTTP-header
Key: api-key
Value: din-api-nyckel
HTTP-body
Key: urls
Value: url1
eller
Value: url1, url2, url3 – url10
Det kan se ut så här om du använder Webperf.se's demokonto:
GET
https://api.webperf.se/private_stats/3843
https://api.webperf.se/0.1/private_stats/3843
HTTP-header
Key: api-key
Value: 989089bfe899d6992ff320a97
Key: site-id
Value: 3843
HTTP-body
Key: urls
Value: https://webperf.se/articles/nyhetsbrev-38/, https://webperf.se/tag/tillganglighet/
Data i svaret är följande:
- api_version är ett versionsnummer (decimal) som förklarar vilken version av API:t du nått. Bra som referens ifall du sparar ner resultatet.
- uri textsträng med referens till vilken webbplats på Webperf testresultaten tillhör.
- result_count heltal om hur många olika URL:ar som testats.
- timestamp datum och klockslag (timestamp) på serversidan när resultatet senast uppdaterades.
- data listar samtliga URL:ar:
- date_added ISO-datum (yyyy-mm-dd hh:mm:ss) för när testet begärdes.
- uri den API-adress som ska anropas för att nå testdetaljer.
- url är den adress som utvärderats i testerna.
2.6 Hämta testresultat för ett av dina privata tester
Bara de med API-åtkomst till webbplatsen hos Webperf eller inloggade i Premium kan komma åt dessa resultat. De delas inte öppet.
GET
https://api.webperf.se/private_stats/nummer/test_id
https://api.webperf.se/0.1/private_stats/nummer/test_id
HTTP-header
Key: api-key
Value: din-api-nyckel
Det kan se ut så här om du använder Webperf.se's demokonto:
GET
https://api.webperf.se/private_stats/3843/6360
https://api.webperf.se/0.1/private_stats/3843/6360
HTTP-header
Key: api-key
Value: 989089bfe899d6992ff320a97
Svaret du får av API:t är i stil med vad 2.1 Hämta era senaste betyg ger dig.
2.7 Din egen URI ger dig dina senaste övergripande betyg
Denna endpoint har vissa likheter med 1.2 Beständig URI (för kommuner och regioner), men med skilnaden att det gäller din egen webbplats. Dessutom får du lite mer data eftersom du anger din API-nyckel.
Obs! Notera bindestrecket i api-keyi just detta kodexempel.
GET
https://api.webperf.se/item/nummer
Exempelvis följande för Webperfs demokonto:
GET
https://api.webperf.se/item/3843
HTTP-header
Key: api-key
Value: 989089bfe899d6992ff320a97
Data i svaret är följande:
- api_version är ett versionsnummer (decimal) som förklarar vilken version av API:t du nått. Bra som referens ifall du sparar ner resultatet.
- timestamp datum och klockslag (timestamp) på serversidan när resultatet senast uppdaterades.
- data listar information om webbplatsen:
- category textsträng som antingen är Municipality, det vill säga en kommun, eller Region om det är en region.
- sameAs är en URI (sträng) med hänvisning till organisationen på Wikidata.
- title textsträng med namnet på organisationen.
- uri textsträng med referens till organisationen på Webperf. Work-in-progress. Kommer URL:ar till Webperf-internt innehåll på sikt.
- url textsträng för organisationens adress till startsida på webbplats.
- scores listar de övergripande betygen för webbsidan:
- a11y ett decimaltal med två decimalpositioner som sammanfattar sidans tillgänglighet
- infosec ett decimaltal med två decimalpositioner som sammanfattar sidans informationssäkerhet och integritet
- overall ett decimaltal med fem decimalpositioner som sammanfattar det övergripande betyget
- pagespeed ett decimaltal med två decimalpositioner som recenserar sidan hastighet
- webstandard ett decimaltal med två decimalpositioner som sammanfattar sidans följsamhet till webbstandard
Svaret du får av API:t är i stil med vad 2.1 Hämta era senaste betyg ger dig. Men kompletterat med noden scores.
2.8 Få en texts läsbarhetsindex (LIX)
En text kan vara mer eller mindre lätt att läsa. LIX är ett mått på detta och du med premium-API:t kan enkelt via API:t kolla dina texter. Förr eller senare kommer LIX-beräkning att inkluderas i kvotsystemet med testkrediter.
GET
https://api.webperf.se/tools/lix/
https://api.webperf.se/0.1/tools/lix/
HTTP-header
Key: api-key
Value: din-api-nyckel
Key: site-id
Value: din-webbplats-idnummer
Body Form-data
Key: content
Value: din text att läsbarhetstesta
Data i svaret är följande:
- nummer är numret som ger LIX-värdet.
- sträng textversion av hur enkel eller svår texten är att läsa.
Så här kan det se ut:
[
{
"message": [
52,
"Svår, normalt värde för officiella texter"
]
},
200
]
Om något går fel kommer du istället få False till svar och en felkod.
3. Premium för webbyråer
Som webbyrå finns det en särskild premiumåtkomst. En del i det är att du kan hantera både din egen webbplats och kundernas. En annan är att det ger dig åtkomst till information som kan göra ditt säljarbete enklare. Det som är exklusivt för webbyråers premium listas nedan.
3.1 Vilka verktyg för webbanalys används hos webbplatser Webperf följer
Detta API kräver att du har Premium för webbyråer.
GET
https://api.webperf.se/webanalytics?api-key=API-nyckel
Svaret du får av API:t är en CSV-fil, separerad med semi-kolon. För knappt 4000 st webbplatser viktiga för ett digitalt Norden, främst Sverige.
Vilken utdata får du? Jo:
- title – vad är webbplatsens namn?
- url – vilken adress är det som testats?
- test_date – när gjordes det senaste testet av webbplatsen?
- ga_or_gtm – finns Google Analytics eller Google Tag Manager i koden?
- vizzit – hittas molntjänsten Vizzit i koden?
- siteimprove_analytics – har webbplatsen Siteimprove Analytics?
- matomo – existerar Matomo Analytics för webbanalys?
- piwik_pro – har webbplatsen Piwik PRO (Core eller Enterprise)
- fathom – finns Fathom Analytics på webbplatsen?
- plausible – spåras webbplatsen med Plausible Analytics?
- monsido_statistics – spåras webbplatsen med Monsido Statistics?
- hotjar – har webbplatsen Hotjar?
4. Webhook för dig med Webperf Premium
Webhooks är ett sätt att få signaler skickad till ditt API när en SaaS-tjänst har något att berätta. Som i det här fallet, att något av Webperfs tester körts och har ett testresultat till dig. Läs mer om webhooks på Webperf.se
För att dra nytta av webhooks via Webperf behöver du först och främst ha ett premiumkonto. Sätt upp en endpoint så du kan ta emot postningen från Webperf. Sedan konfigurerar du respektive webbplats inne i premium.webperf.se så vi vet var du vill ha ditt resultat skickat någonstans.
Nedan har du ett exempel på hur innehållet ser ut som du får postat till din endpoint. HTTP-anropet kommer ha en content-type med application/json och nedan payload. Du har två olika signaler om vilken sida det gäller i fallet med webhooks.
uri är adressen du i efterhand kan slå upp mot för att kolla allt om sidan så som Webperf ser på saken. Men ifall du testar många sidor kontinuerligt är det värt att veta om att för webhook finns också tested_url som direkt berättar vilken sida som testet gäller. I vanlig ordning är det vissa tester som inte utvärderar den URL:en utan istället går på din 404-sida, kollar mejlinställningar, etc. Men då vet du i alla fall vilken URL som kördes in som startpunkt.
{
"api_version": "undefined",
"uri": "https://api.webperf.se/item/3843",
"tested_url": "https://webperf.se",
"timestamp": "2024-01-13T22:34:11.519410",
"result_count": "1",
"data": {
"test_date": "2024-01-13T22:34:11.519410",
"type_of_test": 4,
"url": "https://webperf.se",
"rating": 4.95,
"check_report": "- Webbsidan kan ändå förbättras inom SEO.
- Tryckmålen har inte lämplig storlek: 99 % av tryckmålen har lämplig storlek ( 4.40 betyg )
- Alla bildelement har `[alt]`-attribut ( 5.00 betyg )
- Dokumentet har en metabeskrivning ( 5.00 betyg )
- Dokumentet har ett `<title>`-element ( 5.00 betyg )
- Dokumentet har ett giltigt `hreflang`-värde ( 5.00 betyg )
- Dokumentet har ett giltigt `rel=canonical`-värde ( 5.00 betyg )
- Dokumentet har läsliga teckenstorlekar ( 5.00 betyg )
- Dokumentet undviker plugin-program ( 5.00 betyg )
- Har en `<meta name="viewport">`-tagg med `width` eller `initial-scale` ( 5.00 betyg )
- Länkar har beskrivande text ( 5.00 betyg )
- Länkarna är genomsökningsbara ( 5.00 betyg )
- Sidan har en giltig HTTP-statuskod ( 5.00 betyg )
- Sidan är inte blockerad från indexering ( 5.00 betyg )
- robots.txt är giltig ( 5.00 betyg )",
"check_report_a11y": "",
"check_report_perf": "",
"check_report_stand": "",
"check_report_sec": "",
"json_check_data": "{}"
}
}
5. Versionshistorik
Kort om de versioner som släppts och vad som är planen för nästa version.
- 0.1 (2022-08-15) initial version med öppna data (kommuner och regioner), samt tre endpoints för premium; få sin webbplats id-nummer, hämta aktuella testresultat i JSON-format och historiska genomsnittsbetyg.
- 0.1.1 (2023-07-15) starta ny körning av sin egen webbplats (Premium).
- 0.1.2 (2023-07-25) nya funktioner för premium och webbyråer:
- Privata tester av många sidor på din webbplats och få ut resultaten via API (Premium).
- Vilka webbplatser använder vilket webbanalysverktyg? Lista i CSV-format över samtliga publika webbplatser på Webperf.se och info om de använder Google Analytics, Matomo, Plausible, Piwik PRO, Fathom, Siteimprove Analytics eller Vizzit (kräver behörigheten Premium för webbyråer).
- 0.1.3 (2023-08-03) nu kan man även se om webbplatsen använder Monsido Statistics (Premium för webbyråer)
- 0.1.4 (2023-08-06) anger om webbplatsen använder Hotjar (Premium för webbyråer)
- 0.1.5 (2023-08-25) ifall du har premium och postar med din API-nyckel till din egen URI får du de beräknade betygen – kategoribetygen (Premium).
- 0.1.6 (2023-09-08) BREAKING CHANGES!
- Alla HTTP-headers som tidigare innehöll site_id eller api_key måste få sitt understreck ändrat till ett bindestreck. Alltså, site-id och api-key. Detta beror på ramverket på serversidan som i nyare versioner inte klarar av understreck. (Premium)
- Anrop för privata tester returnerar nu vilka endpoints man kommer hitta testerna på (Premium).
- Fler webbanalysverktyg för dig som vill veta vilka som använder vad. Nu finns även Adobe Analytics, New Relic, Mixpanel, Quantcast Measure, Fullstory, Cloudflare Insights, Snowplow, Klaviyo, Microsoft Clarity, Pingdom RUM och Crazyegg (kräver behörigheten Premium för webbyråer).
- 0.1.7 (2024-03-08) få läsbarhetsindex beräknat för en text. (Premium)
- 0.1.8 (2024-03-25) BREAKING CHANGES!
- BREAKING: Endpointen https://api.webperf.se/stats/ och https://api.webperf.se/0.1/stats/ ger nu ett annat svar. Se 2.1 Hämta era senaste betyg för hur det fungerar nu
- Ny funktion är att du med åtkomst till mer än en webbplats på Webperfs Premium kan nå samtliga med samma API-nyckel. För att se respektive webbplats endpoint kolla dokumentationen under 2.1 Hämta era senaste betyg.
- 0.x (yyyy-mm-dd) snabbare svarstider och cachehantering.
- 0.x (yyyy-mm-dd) nya funktioner för Webperf Premium, bl.a:
- Stödja behörighet till multipla premium-webbplatser.
- Genom sin API-nyckel få ut mer data via de URI:er man bör ha högre behörighet till (egna webbplatser).
- Testa godtycklig URL (kommer finnas någon sorts kreditsystem för antal tester per månad som ingår utan extra kostnader).
6. Tips på verktyg och resurser
För att använda Webperfs öppna data kan du egentligen fortsätta använda din webbläsare. Åtminstone ifall du bara vill ladda ner data. Men för premium-API:t behöver du skicka med en API-nyckel i din förfrågan, vilket görs enklast med appen Postman om du inte bygger ditt anrop i någon utvecklingsmiljö.
- Postman för att utforska och jobba med API:er. Finns för Mac, Linux och Windows, samt en du kan köra direkt i webbläsaren.
- Google Colab gör att du kan köra kod direkt i webbläsaren via Googles molntjänst. Stödjer Python-kod och miljön är en variant av Jupyter Notebook.
- Anaconda hjälper dig dels med virtuella miljöer med de olika beroenden man kan vilja ha, men är också en startpunkt för Jupyter Notebook för att ha en utforskande utvecklingsmiljö direkt i webbläsaren. Finns för Mac, Linux (inklusive RaspberryPi) och Windows.
- Visual Studio Code är en utvecklingsmiljö för alla möjliga språk. Finns till Mac, Linux och Windows.
Resurser:
- Vad alla it-chefer måste veta om API:er är en nyttig introduktion till vad API:er är bra till
- Sveriges dataportal är en katalog över datakällor och erbjuds av DIGG.
- Officiella portalen för europeiska data listar 1,5 miljoner dataset.
- Länkadedata.se erbjuder halvdagskurs i DCAT-AP, semantiska specifikationer, vitbok om länkade öppna data, etc.
- Sveriges dataportals community är en bra plats för dig som vill prata eller samarbeta om datakällor.