Temperatur.nu - Användarbidrag [sv]

https://wiki.temperatur.nu/api.php?action=feedcontributions&feedformat=atom&user=Elf98 Temperatur.nu - Användarbidrag [sv] 2026-06-09T04:51:01Z Användarbidrag MediaWiki 1.35.1 https://wiki.temperatur.nu/index.php?title=Temperatur.nu_Reporter&diff=1015 Temperatur.nu Reporter 2023-11-18T07:38:55Z

<p>Elf98: </p> <hr /> <div>Information om Temperatur.nu Reporter Version 1.<br /> <br /> [[Fil:T reporter1.jpg|höger|200px]]<br /> == Var kan du köpa den? ==<br /> Version 1 säljs inte längre, men efterföljaren TEmperatur.nu Reporter V2 finns på m.nu [[https://www.temperatur.nu/info/temperatur-nu-reporter-kop-en-du-med/ https://www.temperatur.nu/info/temperatur-nu-reporter-kop-en-du-med/]]<br /> <br /> == Generellt ==<br /> * Färgen på Reporterns statusdiod updateras endast i samband med att ett anslutningsförsök till temperatur.nu görs var tredje minut.<br /> * Reportern konsumerar ca 10Mb data per månad.<br /> <br /> == Blinkguide FW 2.1 ==<br /> <br /> Normal drift:<br /> * Blinkar blått 1 gång per sekund: Startar upp eller om (initierar nätverkskortet och hämtar IP via DHCP).<br /> * Blinkar grönt 1 gång per sekund: 2st temperatur har lästs in och boxen har kontakt med temperatur.nu<br /> * Blinkar lila 1 gång per sekund: 1st temperatur har lästs in och boxen har kontakt med temperatur.nu<br /> <br /> Felkoder:<br /> * Blinkar vitt 1 gång per sekund: inga temperatursensorer kan hittas, Reportern har kontakt med temperatur.nu<br /> * Blinkar rött en gång per sekund: Boxen har anslutit till nätverket (erhållit ipnummer), men får inte kontakt med temperatur.nu. Reportern startar om automatiskt efter en stund när ingen kontakt med temperatur.nu kan etableras.<br /> <br /> == Blinkguide FW 2.0 ==<br /> <br /> Version FW 2.0 är återkallad pga en stor bugg i mjukvaran. Har du en reporter med FW2.0, skicka ett mail till support@temperatur.nu så byter vi ut den!<br /> <br /> == Blinkguide FW 1.0/1.0.1 ==<br /> <br /> * Blinkar grönt 1 gång per sekund: 2st temperaturer har lästs in och boxen har kontakt med temperatur.nu<br /> * Blinkar lila 1 gång per sekund: 1st temperatur har lästs in och boxen har kontakt med temperatur.nu<br /> * Blinkar vitt 1 gång per sekund: inga temperatursensorer kan hittas, boxen har kontakt med temperatur.nu<br /> * Lyser blått i 1 till 3 sekunder: Boxen Läser in temperaturer och försöker skicka upp data till temperatur.nu<br /> * Blinkar rött en gång per sekund: Boxen har anslutit till nätverket (erhållit ipnummer) och kan läsa in temperaturer, men får inte kontakt med temperatur.nu.<br /> <br /> * Fast lila sken: Försöker hämta IP-adress via DHCP<br /> * Blinkar lila i snabb takt: DHCP misslyckades och boxen startar om för att försöka igen.<br /> <br /> * Fast rött sken: Försöker göra namnuppslagning för www.temperatur.nu.<br /> * Blinkar rött i snabb (10ggr/sekund) takt: Kan inte hitta temperatur.nu vid uppstart och boxen startar om för att försöka igen.<br /> * Blinkar rött i snabb (5ggr/sekund) takt: Kan inte få kontakt med temperatur.nu efter att boxen initierats korrekt. Boxen startar om för att försöka igen.<br /> <br /> == Hårdvaran ==<br /> Temperatur.nu Reporter är uppbyggd kring en Atmega328. Nätverksmodulen är baserad på ENC28J60. <br /> <br /> == Mjukvaran ==<br /> Användaren kan inte göra några egna inställningar i boxen och allt är "plug and play". Det går inte heller att komma åt inlästa temperaturer lokalt.<br /> <br /> <br /> [[Kategori:www.temperatur.nu]]</div>

Elf98 https://wiki.temperatur.nu/index.php?title=API&diff=841 API 2021-03-12T10:16:38Z

<p>Elf98: </p> <hr /> <div>Informationen är flyttad till [https://temperatur.nu/info/api/ https://temperatur.nu/info/api/]</div>

Elf98 https://wiki.temperatur.nu/index.php?title=API&diff=840 API 2021-03-12T10:16:13Z

<p>Elf98: Ersatte sidans innehåll med "Informationen är flyttad till https://temperatur.nu/info/api/ https://temperatur.nu/info/api/"</p> <hr /> <div>Informationen är flyttad till [[https://temperatur.nu/info/api/ https://temperatur.nu/info/api/]]</div>

Elf98 https://wiki.temperatur.nu/index.php?title=API&diff=839 API 2021-03-12T08:41:17Z

<p>Elf98: </p> <hr /> <div>{| align="right"<br /> | __TOC__<br /> |}<br /> Det finns ett enkelt API för att hämta senaste temperaturerna från temperatur.nu.<br /> <br /> Aktuell API-version 1.16. <br /> <br /> Data returneras i XML-format eller json-format<br /> <br /> ==Support==<br /> För support på API-funktionen, använd [http://www.temperatur.nu/forum/forslag-feedback/diskusionstrad-for-api-funktionen-t1373.html Forumet på www.temperatur.nu].<br /> <br /> ==Villkor==<br /> *Mjukvaran ska skrivas på ett sådant sätt att APIet inte automatiskt belastas med samma fråga oftare än var femte minut från en enskild klient. Klientid som bryter mot detta villkor kan komma att blockeras. <br /> *Källhänvisning måste alltid anges och där det är möjligt bör länk + temperatur.nus logga visas. <br /> *Förfrågningar till APIet kan signeras, osignerade förfrågningar är begränsade till ca 20/timma per klientid (Vilket är tänkt att räcka vid privat bruk). Maila [mailto:support@temperatur.nu support@temperatur.nu] för att att erhålla en signeringsnyckel för ditt klientid. När du ansöker om en signeringsnyckel måste du ange om du vill signera med sha1 eller md5. Läs mer om hur du signerar förfrågningarna längre ner på denna sida.<br /> <br /> ==Kort beskrivning==<br /> APIet är tänkt att användas av de som skapar extern mjukvara, tex applikationer för Iphone och Android.<br /> Målet är att APIet skall vara lättförståeligt och lätt att använda - feedback från användarna är av stor vikt för att kunna utveckla APIet!<br /> <br /> ==Var finns APIet?==<br /> Du accessar APIet via http://api.temperatur.nu/tnu_1.<version>.php. ex: http://api.temperatur.nu/tnu_1.16.php<br /> <br /> ==Exempel==<br /> <br /> Så här kan resultatet från en förfrågan på http://api.temperatur.nu/tnu_1.12.php?p=linkoping&verbose&cli=test_app se ut:<br /> <?xml version='1.0' encoding='iso-8859-1'?><br /> <rss version="2.0"><br /> <channel><br /> <title>Temperatur.nu API 1.12 - Din url är inte korrekt signerad, clientnyckeln kan tillfälligt blockeras - /tnu_1.12.php</title><br /> <link>http://wiki.temperatur.nu/index.php/Api</link><br /> <item><br /> <title>Linköping/Centrum</title><br /> <id>linkoping</id><br /> <temp>9.3</temp><br /> <lat>58.414297</lat><br /> <lon>15.628788</lon><br /> <lastUpdate>2011-11-24 08:51:25</lastUpdate><br /> <kommun>Linköping</kommun><br /> <lan>Östergötlands län</lan><br /> <sourceInfo>Temperaturdata från Stångå Hotell.</sourceInfo><br /> <url>http://www.temperatur.nu/linkoping.html</url><br /> </item><br /> </channel><br /> </rss><br /> <br /> <br /> Så här kan resultatet från en förfrågan på http://api.temperatur.nu/tnu_1.16.php?lat=58.376761&lon=15.562916&num=3&graph&cli=test_app2 se ut:<br /> <?xml version='1.0' encoding='utf-8'?><br /> <rss version="2.0"><br /> <channel><br /> <title>Temperatur.nu API 1.16 - Din url är inte korrekt signerad, clientnyckeln kan tillfälligt blockeras - /tnu_1.16.php</title><br /> <link>http://wiki.temperatur.nu/index.php/Api</link><br /> <item><br /> <title>Linköping/Slaka</title><br /> <id>slaka</id><br /> <temp>11.9</temp><br /> <dist>1.3</dist><br /> <graph>https://graph.temperatur.nu/graph/slaka-1day-300-200-0-0-0-1-8-n-0-n.png</graph><br /> </item><br /> <item><br /> <title>Linköping/Hagaberg</title><br /> <id>hagaberg</id><br /> <temp>12.1</temp><br /> <dist>3.7</dist><br /> <graph>https://graph.temperatur.nu/graph/hagaberg-1day-300-200-0-0-0-1-8-n-0-n.png</graph><br /> </item><br /> <item><br /> <title>Linköping/Valla</title><br /> <id>valla</id><br /> <temp>11.9</temp><br /> <dist>3.8</dist><br /> <graph>https://graph.temperatur.nu/graph/valla-1day-300-200-0-0-0-1-8-n-0-n.png</graph><br /> </item><br /> </channel><br /> </rss><br /> <br /> ==Parametrar==<br /> Generellta parametrar<br /> <br /> {| border=1 class="wikitable"<br /> |-<br /> ! Parameter<br /> ! Beskrivning<br /> ! Kan ej användas med<br /> ! Introducerad i API-version<br /> |-<br /> | json<br /> | Om angiven returneras data i json-format i stället för xml<br /> | <br /> | 1.16<br /> |-<br /> | p<br /> | Anger för vilka orter data skall returneras - kommaseparerad lista. Utelämnas parametern returneras samtliga mätpunkter.<br /> | lat, lon, num<br /> | 1.0<br /> |-<br /> | dc<br /> | Anger om decimalkomma skall användas i stället för decimalpunkt i fälten <temperatur>, <lat>, <lon> och <dist>.<br /> |<br /> | 1.0<br /> |-<br /> | simple<br /> | Minimal output, returnerar endast <title>, <id> och <temp><br /> | verbose<br /> | 1.0<br /> |-<br /> | verbose<br /> | Returnerar alla fält för orten, se beskrivning nedan<br /> | simple<br /> | 1.0<br /> |-<br /> | coordinates<br /> | Visar koordinaterna för valda orter. Kan användas tillsammans med simple för att kunna positionera orter på en karta utan att behöva hämta alla fält.<br /> | verbose<br /> | 1.0<br /> |-<br /> | lat<br /> | Används tillsammans med lon och ev num. Det spelar inte någon roll om decimal- eller kommapunkt används. När dessa parametrar används returneras de num närmaste orterna, närmaste orten först.<br /> | p<br /> | 1.0<br /> |-<br /> | lon<br /> | Används tillsammans med lat och ev num. Det spelar inte någon roll om decimal- eller kommapunkt används. När dessa parametrar används returneras de num närmaste orterna, närmaste orten först..<br /> | p<br /> | 1.0<br /> |-<br /> | num<br /> | Används tillsammans med lat och lon. Anger hur många orter som skall returneras. Standard är 1 och max är 5 (10 från v 1.12).<br /> | p<br /> | 1.0<br /> |-<br /> | cb<br /> | CacheBust. Om denna parameter finns i urlen (&cb) kommer ett randomiserat värde att läggas till i slutet av graf-urlerna. Denna parameter kan användas för att se till att inte grafen cachas lokalt hos användaren eller i någon dåligt konfigurerad proxy mellan temperatur.nu och användaren.<br /> |<br /> | 1.8<br /> |-<br /> | cli <br /> | Skall användas för att identifiera vilken klient som hämtar data. Ex "cli=tnu_widget". Från mitten av 2011 kommer signering av urlerna krävas i kombination med cli. Läs mer längre ner.<br /> |<br /> | 1.1<br /> |-<br /> | sign<br /> | Skall APIet regelbundet måste URLerna signeras. Se information längre ner på denna sida.<br /> |<br /> | 1.0 (tillagd i efterhand)<br /> |}<br /> <br /> Parametrar som är relaterade till att hämta statistik<br /> {| border=1 class="wikitable"<br /> |-<br /> ! Parameter<br /> ! Beskrivning<br /> ! Kan ej användas med<br /> ! Introducerad i API-version<br /> |-<br /> | data<br /> | Används för att hämta rådata för en mätpunkt specificerade med variabeln p.<br /> | graph, textfil<br /> | 1.16<br /> |-<br /> | textfil<br /> | Används för att hämta länk till textfil med rådata för en mätpunkt specificerade med variabeln p. Ange parameter graddagar, dygnsmedel eller timmedel (ex textfil=graddagar) för att specificera vilket format textfilen ska ha.<br /> | graph, data<br /> | 1.16<br /> |-<br /> | amm<br /> | Används för att hämta Average, Min & Max för upp till 5 (10 från v1.12) orter specificerade med variabeln p.<br /> | graph<br /> | 1.11<br /> |-<br /> | daily<br /> | Används för att hämta dygnsmedel samt lägsta och högsta temperatur per dygn. En mätpunkt specificerad med variabeln p.<br /> | graph<br /> | 1.15<br /> |-<br /> | span<br /> | Specificerar för vilket tidsperspektiv Average, Min & Max skall skapas. Giltiga värden är: 1day (standard), 1week, 1month, 1year.<br /> | start, end<br /> | 1.2<br /> |-<br /> | shift_g<br /> |Anger om daily skall visa äldre data. Exempel: om span är 1month och shift_g är 1 hämtas data för föregående månad. Standard är 0.<br /> | start, end<br /> | 1.15<br /> |-<br /> | start<br /> | Specificerar starttid för amm. Formatet är Y-m-d-H-i, ex 2011-01-30-12-31.<br /> | span<br /> | 1.11<br /> |-<br /> | end<br /> | Specificerar sluttid för amm. Formatet är Y-m-d-H-i, ex 2011-01-30-12-31. Standard är nuvarande tid<br /> | span<br /> | 1.11<br /> |}<br /> <br /> Parametrar som är relaterade till grafgenerering:<br /> {| border=1 class="wikitable"<br /> |-<br /> ! Parameter<br /> ! Beskrivning<br /> ! Kan ej användas med<br /> ! Introducerad i API-version<br /> |-<br /> | graph<br /> | Används för att generera en graf för upp till 5 orter specificerade med variabeln p. Anges variablen compare kommer orterna att läggas in i samma graf i stället för separata.<br /> | amm<br /> | 1.2<br /> |-<br /> | span<br /> | Specificerar för vilket tidsperspektiv grafer skall skapas. Giltiga värden är: 1day (standard), 1week, 1month, 1year.<br /> | start, end<br /> | 1.2<br /> |-<br /> | shift_g<br /> | Anger om grafen skall visa äldre data. Exempel: om span är 1day och shift_g är 1 visas en graf för igår, om shift_g är 2 visar grafen data för i förrgår etc. Standard är 0.<br /> | start, end<br /> | 1.5<br /> |-<br /> | start<br /> | Specificerar starttid för graph eller amm. Formatet är Y-m-d-H-i, ex 2011-01-30-12-31.<br /> | span, shift_g, history<br /> | 1.11<br /> |-<br /> | end<br /> | Specificerar sluttid för graph eller amm. Formatet är Y-m-d-H-i, ex 2011-01-30-12-31. Standard är nuvarande tid<br /> | span, shift_g, history<br /> | 1.11<br /> |-<br /> | history<br /> | Används för att i grafen lägga in föregående periods temperatur. Visas temperaturen för det senaste dygnet visas föregående 24h i en annan färg etc. Kan förklarliga skäl endast användas med variabeln graph.<br /> | start, end<br /> | 1.12<br /> |-<br /> | history_year<br /> | Används för att i grafen lägga in jämförelse med annat år. År anges med 4 siffror, ex 2013. Kan förklarliga skäl endast användas med variabeln graph.<br /> | start, end<br /> | 1.14<br /> |-<br /> | verbose_g<br /> | Visar min/max/medel/senaste värde i grafen. Visar även när data senast hämtades för den valda orten.<br /> |<br /> | 1.5<br /> |-<br /> | 1axis<br /> | Används för att endast visa temperaturskalan till vänster. Används med fördel i små grafer för att spara utrymme.<br /> |<br /> | 1.6<br /> |-<br /> | fontsize<br /> | Anger hur stor texten skall vara. Observera att värdet inte kan relateras till vanliga textstorlekar, du måste därför testa dig fram.<br /> |<br /> | 1.8<br /> |-<br /> | linewidth<br /> | Anger bredden på graflinjen. Giltiga värden 1 till 5. Även flyttal, ex 1.5, fungerar. Decimalkomma eller decimalpunkt spelar inte någon roll.<br /> |<br /> | 1.7<br /> |-<br /> | x<br /> | Specificerar hur bred grafen skall vara. Giltiga värden är 150-2500. 300 är standard.<br /> |<br /> | 1.2 (Tillåtna värden justerade i v 1.4,v 1.14)<br /> |-<br /> | y<br /> | Specificerar hur hög grafen skall vara. Giltiga värden är 125-2500. 200 är standard.<br /> |<br /> | 1.2 (Tillåtna värden justerade i v 1.4, v 1.14)<br /> |-<br /> | color<br /> | Anger vilken/vilka färger linjer i grafen skall ha, kommasepararead lista. Standard är #FF0000,#AADDAA,#FFCC00.<br /> |<br /> | 1.13<br /> |-<br /> | compare<br /> | Anger att order som skickats med p skall läggas in för jämförelse i samma graf. Om fler än tre orter anges måste även color definieras<br /> |<br /> | 1.13<br /> |}<br /> <br /> ==Beskrivning av returnerade fält==<br /> {| border=1 class="wikitable"<br /> |-<br /> ! Fält<br /> ! Beskrivning<br /> ! parameter som visar<br /> ! parameter som döljer<br /> ! Visas som standard<br /> ! Introducerad i API-version<br /> |-<br /> | <title><br /> | Mätpunktens namn på temperatur.nu<br /> | <br /> | <br /> | X<br /> | 1.0<br /> |-<br /> | <id><br /> | Mätpunktens id på temperatur.nu. Kan användas med parametern "p" för att hämta endast denna mätpunkts information<br /> |<br /> | simple<br /> | X<br /> | 1.0<br /> |-<br /> | <temp><br /> | Mätpunktens senaste temperatur. Om decimalkomma eller decimalpunkt skall användas styrs med parametern dc.<br /> |<br /> |<br /> | X<br /> | 1.0<br /> |-<br /> | <lat><br /> | Mätpunktens latitud i decimalt format. Om decimalkomma eller decimalpunkt skall användas styrs med parametern dc.<br /> | coordinates, verbose<br /> |<br /> |<br /> | 1.0<br /> |-<br /> | <lon><br /> | Mätpunktens longitud i decimalt format. Om decimalkomma eller decimalpunkt skall användas styrs med parametern dc.<br /> | coordinates, verbose<br /> |<br /> |<br /> | 1.0<br /> |-<br /> | <lastUpdate><br /> | Tidpunkt då informationen senast uppdaterades på temperatur.nu<br /> | verbose<br /> |<br /> |<br /> | 1.0<br /> |-<br /> | <kommun><br /> | Den kommun som mätpunkten ligger i.<br /> | verbose<br /> |<br /> |<br /> | 1.0<br /> |-<br /> | <lan><br /> | Det län som mätpunkten ligger i.<br /> | verbose<br /> |<br /> |<br /> | 1.0<br /> |-<br /> | <sourceInfo><br /> | En kort textsträng med information om vem som loggar temperaturen för mätpunkten<br /> | verbose<br /> |<br /> |<br /> | 1.8<br /> |-<br /> | <forutsattning><br /> | Textsträng med information om hur mätningarna sker - finns ej för alla mätpunkter och returernar om så är fallet ett tomt fält.<br /> | verbose<br /> |<br /> |<br /> | 1.16<br /> |-<br /> | <url><br /> | Url till mätpunktens temperatur och grafer på www.temperatur.nu<br /> | verbose<br /> |<br /> |<br /> | 1.0<br /> |-<br /> | <dist><br /> | Hur långt från de givna koordinaterna mätpunkten ligger. Enheten är kilometer. Om decimalkomma eller decimalpunkt skall användas styrs med parametern dc.<br /> | lat & lon<br /> | simple<br /> |<br /> | 1.0<br /> |-<br /> | <graph><br /> | Visar url till graph för orten. Observera att ny graf endast genereras när parametern graph används. Det går därför inte att lokalt cacha urlen i klienten. <br /> | graph (x, y, span, verbose_g, shift_g)<br /> |<br /> |<br /> | 1.2<br /> |-<br /> | <ClientVersion><br /> | Visar vilken den senaste släppta klientversionen är. Kan med fördel användas för att kontrollera om det finns någon uppdatering till klientmjukvaran.<br /> | version<br /> |<br /> |<br /> | 1.10<br /> |-<br /> | <ClientVersionSet><br /> | Visar status i samband med att informationen om klientversionen uppdaterats.<br /> | version_update<br /> |<br /> |<br /> | 1.10<br /> |-<br /> | <daily><br /> | Har underliggande fält <date>, <average>, <min>, <max> som representerar data för dygn angivet i fältet date. Dessa fält returneras när parametern daily används för att hämta statisk för flera dygn<br /> | daily, span, start, end, shift_g<br /> |<br /> |<br /> | 1.15<br /> |-<br /> | <ammRange><br /> | Visar för vilket tidsperspektiv amm (medel/min/max) har hämtats<br /> | amm, span, start, end, shift_g<br /> |<br /> |<br /> | 1.11<br /> |-<br /> | <average><br /> | Medeltemperatur i specificerat tidsperspektiv<br /> | amm, span, start, end, shift_g<br /> |<br /> |<br /> | 1.11<br /> |-<br /> | <min><br /> | Den minsta temperaturen i specificerat tidsperspektiv<br /> | amm, span, start, end, shift_g<br /> |<br /> |<br /> | 1.11<br /> |-<br /> | <minTime><br /> | Vid vilken tidpunkt <min> inträffade<br /> | amm, span, start, end, shift_g<br /> |<br /> |<br /> | 1.11<br /> |-<br /> | <max><br /> | Den högsta temperaturen i specificerat tidsperspektiv<br /> | amm, span, start, end, shift_g<br /> |<br /> |<br /> | 1.11<br /> |-<br /> | <maxTime><br /> | Vid vilken tidpunkt <max> inträffade<br /> | amm, span, start, end, shift_g<br /> |<br /> |<br /> | 1.11<br /> |-<br /> | <uptime><br /> | Mätpunktens upptid i % det senaste året<br /> | verbose<br /> |<br /> |<br /> | 1.16<br /> |-<br /> | <start><br /> | Tidpunkt när mätpunkten lades till på temperatur.nu<br /> | verbose<br /> |<br /> |<br /> | 1.16<br /> |-<br /> | <moh><br /> | Mätpunktens höjd över havsnivån (Meter above Sea Level)<br /> | verbose<br /> |<br /> |<br /> | 1.16<br /> |-<br /> | <rawdata><br /> | Temperaturdata i råformat. Varje rawdata-fält innehåller subfälten date, time, timestamp, temperatur<br /> | data<br /> |<br /> |<br /> | 1.16<br /> |-<br /> | <textfil><br /> | Länk till fil med rådata i textformat.<br /> | textfil<br /> |<br /> |<br /> | 1.16<br /> <br /> |}<br /> <br /> <br /> ==Signering av URLer==<br /> Förfrågningar till APIet kan signeras. Från och med version 1.11 är antalet osignerade förfrågningar begränsade till 20 per timma. Osignerade förfrågningar kommer i framtiden att begränsas för alla api-versioner. Skriver du en privat tillämpning kan du använda APIet utan att signera URLerna.<br /> <br /> Signeringen går till så här:<br /> <br /> 1. Skapa din url som vanligt.<br /> <br /> 2. Beräkna md5-/sha1-summan av urlen (utan http://) med "+clientnyckel" tillagd på slutet. Klientnyckel erhålls efter att ha mailat [mailto:support@temperatur.nu support@temperatur.nu]<br /> <br /> 3. I slutet av urlen lägger du sedan till &sign=md5-/sha1-summa<br /> <br /> I php kan det tex se ut så här om du har en signeringsnyckel för md5:<br /> $cli_key="XXXXXXXXXXXXXXXXXXXXXXXXX";<br /> $url="api.temperatur.nu/tnu_1.9.php?p=linkoping&cli=testapp"<br /> $sign=md5($url."+".$cli_key);<br /> $signed_url=$url."&sign=".$sign;<br /> <br /> I den returnerade xml-filen kan du i det första title-fältet se om förfrågan är korrekt signerad.<br /> <br /> [http://www.fileformat.info/tool/hash.htm?text= fileformat.info] är en mycket bra sida för att verifiera att de sha1-/md5-summor du tagit fram stämmer.<br /> <br /> ==Historik/ändringslogg==<br /> 2010-05-04 - Version 1.0<br /> Första releasen.<br /> <br /> 2010-05-13 - Version 1.1<br /> Variabeln cli tillagd.<br /> <br /> 2010-05-19 - Version 1.2<br /> Stöd för att hämta grafer<br /> <br /> 2010-06-09 - Version 1.3<br /> Bugfix som fixar en bugg introducerad i 1.2 (det gick inte att hämta alla orter genom att skippa variabeln p).<br /> <br /> 2010-08-04 - Version 1.4<br /> Värden för x och y justerade. Parametern cli krävs för att apiet skall returnera data.<br /> <br /> 2010-09-01 - Version 1.5<br /> Parametrar för att via mer info i grafen. Parametrar för att visa grafer för i går, förra veckan, 2 år sedan etc.<br /> <br /> 2010-09-01 - Version 1.6<br /> Parameter för att ange om 1 eller 2 y-axlar skall visas.<br /> <br /> 2010-11-22 - Version 1.7<br /> Möjlighet att välja hur tjock graflinjen skall vara.<br /> <br /> 2010-12-19 - Version 1.8<br /> CacheBust-funktion, möjlighet att ändra textstorlek samt information om vem som loggar temperaturen när verbose är specat.<br /> <br /> 2011-01-13 - Version 1.9<br /> Signeringsfunktion inlagd. Signeringsfunktionen kommer från mitten av 2011 krävas för alla tillämpningar och och kommer successivt att läggas in i alla versioner av apiet.<br /> <br /> 2011-01-17 - Version 1.10<br /> Möjlighet att via Apiet hantera informaion gällande den senaste tillgängliga klientversionen.<br /> <br /> 2011-01-30 - Version 1.11<br /> Mer flexibel specificering av tidsperspektiv för grafer. amm - möjlighet att hämta medel/min/max i ett valfritt tidsperspektiv, antalet osignerade accesser begränsat i denna version.<br /> <br /> 2011-10-08 - Version 1.12<br /> Variabeln history tillagd. Visar föregående periods temperatur i grafer.<br /> <br /> 2012-05-04 - Version 1.13<br /> Variablerna compare och color angivna, gör det möjligt att jämföra flera orter i samma graf samt helt styra vilka färger linjerna i graferna skall ha. color kan sättas även för vanliga grafer.<br /> <br /> 2013 - Version 1.14<br /> Parametern history_year som används för att jämföra data med tidigare år. Buggfixar<br /> <br /> 2014-01-26 - Version 1.15<br /> Parametern daily. Används för att hämta dygnsmedel i ett specificerat tidsspann.<br /> <br /> 2021-02-25 - Version 1.16<br /> Parametern json för att få ut data i json-format. Parametern data som används för att få ut data i råformat. Parametern textfil som används för att få ut rådata i en textfil. Mer information returneras när parametern verbose används. Generell buggrättning<br /> <br /> [[Kategori:www.temperatur.nu]]<br /> [[Kategori:Mjukvara]]</div>

Elf98 https://wiki.temperatur.nu/index.php?title=API&diff=838 API 2021-03-12T08:38:22Z

<p>Elf98: /* Villkor */</p> <hr /> <div>{| align="right"<br /> | __TOC__<br /> |}<br /> Det finns ett enkelt API för att hämta senaste temperaturerna från temperatur.nu.<br /> <br /> Aktuell API-version 1.16. <br /> <br /> Data returneras i XML-format eller json-format<br /> <br /> ==Support==<br /> För support på API-funktionen, använd [http://www.temperatur.nu/forum/forslag-feedback/diskusionstrad-for-api-funktionen-t1373.html Forumet på www.temperatur.nu].<br /> <br /> ==Villkor==<br /> *Mjukvaran skall skrivas på ett sådant sätt att APIet inte automatiskt belastas med samma fråga oftare än var femte minut från en enskild klient. Klientid som bryter mot detta villkor kan komma att blockeras. <br /> *Källhänvisning måste alltid anges och där det är möjligt bör länk + temperatur.nus logga visas. <br /> *Förfrågningar till APIet kan signeras, osignerade förfrågningar är begränsade till ca 20/timma per klientid. Maila [mailto:support@temperatur.nu support@temperatur.nu] för att att erhålla en signeringsnyckel för ditt klientid. När du ansöker om en signeringsnyckel måste du ange om du vill signera med sha1 eller md5. Läs mer om hur du signerar förfrågningarna längre ner på denna sida.<br /> <br /> ==Kort beskrivning==<br /> APIet är tänkt att användas av de som skapar extern mjukvara, tex applikationer för Iphone och Android.<br /> Målet är att APIet skall vara lättförståeligt och lätt att använda - feedback från användarna är av stor vikt för att kunna utveckla APIet!<br /> <br /> ==Var finns APIet?==<br /> Du accessar APIet via http://api.temperatur.nu/tnu_1.<version>.php. ex: http://api.temperatur.nu/tnu_1.12.php<br /> <br /> ==Parametrar==<br /> Generellta parametrar<br /> <br /> {| border=1 class="wikitable"<br /> |-<br /> ! Parameter<br /> ! Beskrivning<br /> ! Kan ej användas med<br /> ! Introducerad i API-version<br /> |-<br /> | json<br /> | Om angiven returneras data i json-format i stället för xml<br /> | <br /> | 1.16<br /> |-<br /> | p<br /> | Anger för vilka orter data skall returneras - kommaseparerad lista. Utelämnas parametern returneras samtliga mätpunkter.<br /> | lat, lon, num<br /> | 1.0<br /> |-<br /> | dc<br /> | Anger om decimalkomma skall användas i stället för decimalpunkt i fälten <temperatur>, <lat>, <lon> och <dist>.<br /> |<br /> | 1.0<br /> |-<br /> | simple<br /> | Minimal output, returnerar endast <title>, <id> och <temp><br /> | verbose<br /> | 1.0<br /> |-<br /> | verbose<br /> | Returnerar alla fält för orten, se beskrivning nedan<br /> | simple<br /> | 1.0<br /> |-<br /> | coordinates<br /> | Visar koordinaterna för valda orter. Kan användas tillsammans med simple för att kunna positionera orter på en karta utan att behöva hämta alla fält.<br /> | verbose<br /> | 1.0<br /> |-<br /> | lat<br /> | Används tillsammans med lon och ev num. Det spelar inte någon roll om decimal- eller kommapunkt används. När dessa parametrar används returneras de num närmaste orterna, närmaste orten först.<br /> | p<br /> | 1.0<br /> |-<br /> | lon<br /> | Används tillsammans med lat och ev num. Det spelar inte någon roll om decimal- eller kommapunkt används. När dessa parametrar används returneras de num närmaste orterna, närmaste orten först..<br /> | p<br /> | 1.0<br /> |-<br /> | num<br /> | Används tillsammans med lat och lon. Anger hur många orter som skall returneras. Standard är 1 och max är 5 (10 från v 1.12).<br /> | p<br /> | 1.0<br /> |-<br /> | cb<br /> | CacheBust. Om denna parameter finns i urlen (&cb) kommer ett randomiserat värde att läggas till i slutet av graf-urlerna. Denna parameter kan användas för att se till att inte grafen cachas lokalt hos användaren eller i någon dåligt konfigurerad proxy mellan temperatur.nu och användaren.<br /> |<br /> | 1.8<br /> |-<br /> | cli <br /> | Skall användas för att identifiera vilken klient som hämtar data. Ex "cli=tnu_widget". Från mitten av 2011 kommer signering av urlerna krävas i kombination med cli. Läs mer längre ner.<br /> |<br /> | 1.1<br /> |-<br /> | sign<br /> | Skall APIet regelbundet måste URLerna signeras. Se information längre ner på denna sida.<br /> |<br /> | 1.0 (tillagd i efterhand)<br /> |}<br /> <br /> Parametrar som är relaterade till att hämta statistik<br /> {| border=1 class="wikitable"<br /> |-<br /> ! Parameter<br /> ! Beskrivning<br /> ! Kan ej användas med<br /> ! Introducerad i API-version<br /> |-<br /> | data<br /> | Används för att hämta rådata för en mätpunkt specificerade med variabeln p.<br /> | graph, textfil<br /> | 1.16<br /> |-<br /> | textfil<br /> | Används för att hämta länk till textfil med rådata för en mätpunkt specificerade med variabeln p. Ange parameter graddagar, dygnsmedel eller timmedel (ex textfil=graddagar) för att specificera vilket format textfilen ska ha.<br /> | graph, data<br /> | 1.16<br /> |-<br /> | amm<br /> | Används för att hämta Average, Min & Max för upp till 5 (10 från v1.12) orter specificerade med variabeln p.<br /> | graph<br /> | 1.11<br /> |-<br /> | daily<br /> | Används för att hämta dygnsmedel samt lägsta och högsta temperatur per dygn. En mätpunkt specificerad med variabeln p.<br /> | graph<br /> | 1.15<br /> |-<br /> | span<br /> | Specificerar för vilket tidsperspektiv Average, Min & Max skall skapas. Giltiga värden är: 1day (standard), 1week, 1month, 1year.<br /> | start, end<br /> | 1.2<br /> |-<br /> | shift_g<br /> |Anger om daily skall visa äldre data. Exempel: om span är 1month och shift_g är 1 hämtas data för föregående månad. Standard är 0.<br /> | start, end<br /> | 1.15<br /> |-<br /> | start<br /> | Specificerar starttid för amm. Formatet är Y-m-d-H-i, ex 2011-01-30-12-31.<br /> | span<br /> | 1.11<br /> |-<br /> | end<br /> | Specificerar sluttid för amm. Formatet är Y-m-d-H-i, ex 2011-01-30-12-31. Standard är nuvarande tid<br /> | span<br /> | 1.11<br /> |}<br /> <br /> Parametrar som är relaterade till grafgenerering:<br /> {| border=1 class="wikitable"<br /> |-<br /> ! Parameter<br /> ! Beskrivning<br /> ! Kan ej användas med<br /> ! Introducerad i API-version<br /> |-<br /> | graph<br /> | Används för att generera en graf för upp till 5 orter specificerade med variabeln p. Anges variablen compare kommer orterna att läggas in i samma graf i stället för separata.<br /> | amm<br /> | 1.2<br /> |-<br /> | span<br /> | Specificerar för vilket tidsperspektiv grafer skall skapas. Giltiga värden är: 1day (standard), 1week, 1month, 1year.<br /> | start, end<br /> | 1.2<br /> |-<br /> | shift_g<br /> | Anger om grafen skall visa äldre data. Exempel: om span är 1day och shift_g är 1 visas en graf för igår, om shift_g är 2 visar grafen data för i förrgår etc. Standard är 0.<br /> | start, end<br /> | 1.5<br /> |-<br /> | start<br /> | Specificerar starttid för graph eller amm. Formatet är Y-m-d-H-i, ex 2011-01-30-12-31.<br /> | span, shift_g, history<br /> | 1.11<br /> |-<br /> | end<br /> | Specificerar sluttid för graph eller amm. Formatet är Y-m-d-H-i, ex 2011-01-30-12-31. Standard är nuvarande tid<br /> | span, shift_g, history<br /> | 1.11<br /> |-<br /> | history<br /> | Används för att i grafen lägga in föregående periods temperatur. Visas temperaturen för det senaste dygnet visas föregående 24h i en annan färg etc. Kan förklarliga skäl endast användas med variabeln graph.<br /> | start, end<br /> | 1.12<br /> |-<br /> | history_year<br /> | Används för att i grafen lägga in jämförelse med annat år. År anges med 4 siffror, ex 2013. Kan förklarliga skäl endast användas med variabeln graph.<br /> | start, end<br /> | 1.14<br /> |-<br /> | verbose_g<br /> | Visar min/max/medel/senaste värde i grafen. Visar även när data senast hämtades för den valda orten.<br /> |<br /> | 1.5<br /> |-<br /> | 1axis<br /> | Används för att endast visa temperaturskalan till vänster. Används med fördel i små grafer för att spara utrymme.<br /> |<br /> | 1.6<br /> |-<br /> | fontsize<br /> | Anger hur stor texten skall vara. Observera att värdet inte kan relateras till vanliga textstorlekar, du måste därför testa dig fram.<br /> |<br /> | 1.8<br /> |-<br /> | linewidth<br /> | Anger bredden på graflinjen. Giltiga värden 1 till 5. Även flyttal, ex 1.5, fungerar. Decimalkomma eller decimalpunkt spelar inte någon roll.<br /> |<br /> | 1.7<br /> |-<br /> | x<br /> | Specificerar hur bred grafen skall vara. Giltiga värden är 150-2500. 300 är standard.<br /> |<br /> | 1.2 (Tillåtna värden justerade i v 1.4,v 1.14)<br /> |-<br /> | y<br /> | Specificerar hur hög grafen skall vara. Giltiga värden är 125-2500. 200 är standard.<br /> |<br /> | 1.2 (Tillåtna värden justerade i v 1.4, v 1.14)<br /> |-<br /> | color<br /> | Anger vilken/vilka färger linjer i grafen skall ha, kommasepararead lista. Standard är #FF0000,#AADDAA,#FFCC00.<br /> |<br /> | 1.13<br /> |-<br /> | compare<br /> | Anger att order som skickats med p skall läggas in för jämförelse i samma graf. Om fler än tre orter anges måste även color definieras<br /> |<br /> | 1.13<br /> |}<br /> <br /> ==Beskrivning av returnerade fält==<br /> {| border=1 class="wikitable"<br /> |-<br /> ! Fält<br /> ! Beskrivning<br /> ! parameter som visar<br /> ! parameter som döljer<br /> ! Visas som standard<br /> ! Introducerad i API-version<br /> |-<br /> | <title><br /> | Mätpunktens namn på temperatur.nu<br /> | <br /> | <br /> | X<br /> | 1.0<br /> |-<br /> | <id><br /> | Mätpunktens id på temperatur.nu. Kan användas med parametern "p" för att hämta endast denna mätpunkts information<br /> |<br /> | simple<br /> | X<br /> | 1.0<br /> |-<br /> | <temp><br /> | Mätpunktens senaste temperatur. Om decimalkomma eller decimalpunkt skall användas styrs med parametern dc.<br /> |<br /> |<br /> | X<br /> | 1.0<br /> |-<br /> | <lat><br /> | Mätpunktens latitud i decimalt format. Om decimalkomma eller decimalpunkt skall användas styrs med parametern dc.<br /> | coordinates, verbose<br /> |<br /> |<br /> | 1.0<br /> |-<br /> | <lon><br /> | Mätpunktens longitud i decimalt format. Om decimalkomma eller decimalpunkt skall användas styrs med parametern dc.<br /> | coordinates, verbose<br /> |<br /> |<br /> | 1.0<br /> |-<br /> | <lastUpdate><br /> | Tidpunkt då informationen senast uppdaterades på temperatur.nu<br /> | verbose<br /> |<br /> |<br /> | 1.0<br /> |-<br /> | <kommun><br /> | Den kommun som mätpunkten ligger i.<br /> | verbose<br /> |<br /> |<br /> | 1.0<br /> |-<br /> | <lan><br /> | Det län som mätpunkten ligger i.<br /> | verbose<br /> |<br /> |<br /> | 1.0<br /> |-<br /> | <sourceInfo><br /> | En kort textsträng med information om vem som loggar temperaturen för mätpunkten<br /> | verbose<br /> |<br /> |<br /> | 1.8<br /> |-<br /> | <forutsattning><br /> | Textsträng med information om hur mätningarna sker - finns ej för alla mätpunkter och returernar om så är fallet ett tomt fält.<br /> | verbose<br /> |<br /> |<br /> | 1.16<br /> |-<br /> | <url><br /> | Url till mätpunktens temperatur och grafer på www.temperatur.nu<br /> | verbose<br /> |<br /> |<br /> | 1.0<br /> |-<br /> | <dist><br /> | Hur långt från de givna koordinaterna mätpunkten ligger. Enheten är kilometer. Om decimalkomma eller decimalpunkt skall användas styrs med parametern dc.<br /> | lat & lon<br /> | simple<br /> |<br /> | 1.0<br /> |-<br /> | <graph><br /> | Visar url till graph för orten. Observera att ny graf endast genereras när parametern graph används. Det går därför inte att lokalt cacha urlen i klienten. <br /> | graph (x, y, span, verbose_g, shift_g)<br /> |<br /> |<br /> | 1.2<br /> |-<br /> | <ClientVersion><br /> | Visar vilken den senaste släppta klientversionen är. Kan med fördel användas för att kontrollera om det finns någon uppdatering till klientmjukvaran.<br /> | version<br /> |<br /> |<br /> | 1.10<br /> |-<br /> | <ClientVersionSet><br /> | Visar status i samband med att informationen om klientversionen uppdaterats.<br /> | version_update<br /> |<br /> |<br /> | 1.10<br /> |-<br /> | <daily><br /> | Har underliggande fält <date>, <average>, <min>, <max> som representerar data för dygn angivet i fältet date. Dessa fält returneras när parametern daily används för att hämta statisk för flera dygn<br /> | daily, span, start, end, shift_g<br /> |<br /> |<br /> | 1.15<br /> |-<br /> | <ammRange><br /> | Visar för vilket tidsperspektiv amm (medel/min/max) har hämtats<br /> | amm, span, start, end, shift_g<br /> |<br /> |<br /> | 1.11<br /> |-<br /> | <average><br /> | Medeltemperatur i specificerat tidsperspektiv<br /> | amm, span, start, end, shift_g<br /> |<br /> |<br /> | 1.11<br /> |-<br /> | <min><br /> | Den minsta temperaturen i specificerat tidsperspektiv<br /> | amm, span, start, end, shift_g<br /> |<br /> |<br /> | 1.11<br /> |-<br /> | <minTime><br /> | Vid vilken tidpunkt <min> inträffade<br /> | amm, span, start, end, shift_g<br /> |<br /> |<br /> | 1.11<br /> |-<br /> | <max><br /> | Den högsta temperaturen i specificerat tidsperspektiv<br /> | amm, span, start, end, shift_g<br /> |<br /> |<br /> | 1.11<br /> |-<br /> | <maxTime><br /> | Vid vilken tidpunkt <max> inträffade<br /> | amm, span, start, end, shift_g<br /> |<br /> |<br /> | 1.11<br /> |-<br /> | <uptime><br /> | Mätpunktens upptid i % det senaste året<br /> | verbose<br /> |<br /> |<br /> | 1.16<br /> |-<br /> | <start><br /> | Tidpunkt när mätpunkten lades till på temperatur.nu<br /> | verbose<br /> |<br /> |<br /> | 1.16<br /> |-<br /> | <moh><br /> | Mätpunktens höjd över havsnivån (Meter above Sea Level)<br /> | verbose<br /> |<br /> |<br /> | 1.16<br /> |-<br /> | <rawdata><br /> | Temperaturdata i råformat. Varje rawdata-fält innehåller subfälten date, time, timestamp, temperatur<br /> | data<br /> |<br /> |<br /> | 1.16<br /> |-<br /> | <textfil><br /> | Länk till fil med rådata i textformat.<br /> | textfil<br /> |<br /> |<br /> | 1.16<br /> <br /> |}<br /> <br /> ==Exempel==<br /> <br /> Så här kan resultatet från en förfrågan på http://api.temperatur.nu/tnu_1.12.php?p=linkoping&verbose&cli=test_app se ut:<br /> <?xml version='1.0' encoding='iso-8859-1'?><br /> <rss version="2.0"><br /> <channel><br /> <title>Temperatur.nu API 1.12 - Din url är inte korrekt signerad, clientnyckeln kan tillfälligt blockeras - /tnu_1.12.php</title><br /> <link>http://wiki.temperatur.nu/index.php/Api</link><br /> <item><br /> <title>Linköping/Centrum</title><br /> <id>linkoping</id><br /> <temp>9.3</temp><br /> <lat>58.414297</lat><br /> <lon>15.628788</lon><br /> <lastUpdate>2011-11-24 08:51:25</lastUpdate><br /> <kommun>Linköping</kommun><br /> <lan>Östergötlands län</lan><br /> <sourceInfo>Temperaturdata från Stångå Hotell.</sourceInfo><br /> <url>http://www.temperatur.nu/linkoping.html</url><br /> </item><br /> </channel><br /> </rss><br /> <br /> <br /> Så här kan resultatet från en förfrågan på http://api.temperatur.nu/tnu_1.16.php?lat=58.376761&lon=15.562916&num=3&graph&cli=test_app2 se ut:<br /> <?xml version='1.0' encoding='utf-8'?><br /> <rss version="2.0"><br /> <channel><br /> <title>Temperatur.nu API 1.16 - Din url är inte korrekt signerad, clientnyckeln kan tillfälligt blockeras - /tnu_1.16.php</title><br /> <link>http://wiki.temperatur.nu/index.php/Api</link><br /> <item><br /> <title>Linköping/Slaka</title><br /> <id>slaka</id><br /> <temp>11.9</temp><br /> <dist>1.3</dist><br /> <graph>https://graph.temperatur.nu/graph/slaka-1day-300-200-0-0-0-1-8-n-0-n.png</graph><br /> </item><br /> <item><br /> <title>Linköping/Hagaberg</title><br /> <id>hagaberg</id><br /> <temp>12.1</temp><br /> <dist>3.7</dist><br /> <graph>https://graph.temperatur.nu/graph/hagaberg-1day-300-200-0-0-0-1-8-n-0-n.png</graph><br /> </item><br /> <item><br /> <title>Linköping/Valla</title><br /> <id>valla</id><br /> <temp>11.9</temp><br /> <dist>3.8</dist><br /> <graph>https://graph.temperatur.nu/graph/valla-1day-300-200-0-0-0-1-8-n-0-n.png</graph><br /> </item><br /> </channel><br /> </rss><br /> <br /> ==Signering av URLer==<br /> Förfrågningar till APIet kan signeras. Från och med version 1.11 är antalet osignerade förfrågningar begränsade till 20 per timma. Osignerade förfrågningar kommer i framtiden att begränsas för alla api-versioner. Skriver du en privat tillämpning kan du använda APIet utan att signera URLerna.<br /> <br /> Signeringen går till så här:<br /> <br /> 1. Skapa din url som vanligt.<br /> <br /> 2. Beräkna md5-/sha1-summan av urlen (utan http://) med "+clientnyckel" tillagd på slutet. Klientnyckel erhålls efter att ha mailat [mailto:support@temperatur.nu support@temperatur.nu]<br /> <br /> 3. I slutet av urlen lägger du sedan till &sign=md5-/sha1-summa<br /> <br /> I php kan det tex se ut så här om du har en signeringsnyckel för md5:<br /> $cli_key="XXXXXXXXXXXXXXXXXXXXXXXXX";<br /> $url="api.temperatur.nu/tnu_1.9.php?p=linkoping&cli=testapp"<br /> $sign=md5($url."+".$cli_key);<br /> $signed_url=$url."&sign=".$sign;<br /> <br /> I den returnerade xml-filen kan du i det första title-fältet se om förfrågan är korrekt signerad.<br /> <br /> [http://www.fileformat.info/tool/hash.htm?text= fileformat.info] är en mycket bra sida för att verifiera att de sha1-/md5-summor du tagit fram stämmer.<br /> <br /> ==Historik/ändringslogg==<br /> 2010-05-04 - Version 1.0<br /> Första releasen.<br /> <br /> 2010-05-13 - Version 1.1<br /> Variabeln cli tillagd.<br /> <br /> 2010-05-19 - Version 1.2<br /> Stöd för att hämta grafer<br /> <br /> 2010-06-09 - Version 1.3<br /> Bugfix som fixar en bugg introducerad i 1.2 (det gick inte att hämta alla orter genom att skippa variabeln p).<br /> <br /> 2010-08-04 - Version 1.4<br /> Värden för x och y justerade. Parametern cli krävs för att apiet skall returnera data.<br /> <br /> 2010-09-01 - Version 1.5<br /> Parametrar för att via mer info i grafen. Parametrar för att visa grafer för i går, förra veckan, 2 år sedan etc.<br /> <br /> 2010-09-01 - Version 1.6<br /> Parameter för att ange om 1 eller 2 y-axlar skall visas.<br /> <br /> 2010-11-22 - Version 1.7<br /> Möjlighet att välja hur tjock graflinjen skall vara.<br /> <br /> 2010-12-19 - Version 1.8<br /> CacheBust-funktion, möjlighet att ändra textstorlek samt information om vem som loggar temperaturen när verbose är specat.<br /> <br /> 2011-01-13 - Version 1.9<br /> Signeringsfunktion inlagd. Signeringsfunktionen kommer från mitten av 2011 krävas för alla tillämpningar och och kommer successivt att läggas in i alla versioner av apiet.<br /> <br /> 2011-01-17 - Version 1.10<br /> Möjlighet att via Apiet hantera informaion gällande den senaste tillgängliga klientversionen.<br /> <br /> 2011-01-30 - Version 1.11<br /> Mer flexibel specificering av tidsperspektiv för grafer. amm - möjlighet att hämta medel/min/max i ett valfritt tidsperspektiv, antalet osignerade accesser begränsat i denna version.<br /> <br /> 2011-10-08 - Version 1.12<br /> Variabeln history tillagd. Visar föregående periods temperatur i grafer.<br /> <br /> 2012-05-04 - Version 1.13<br /> Variablerna compare och color angivna, gör det möjligt att jämföra flera orter i samma graf samt helt styra vilka färger linjerna i graferna skall ha. color kan sättas även för vanliga grafer.<br /> <br /> 2013 - Version 1.14<br /> Parametern history_year som används för att jämföra data med tidigare år. Buggfixar<br /> <br /> 2014-01-26 - Version 1.15<br /> Parametern daily. Används för att hämta dygnsmedel i ett specificerat tidsspann.<br /> <br /> 2021-02-25 - Version 1.16<br /> Parametern json för att få ut data i json-format. Parametern data som används för att få ut data i råformat. Parametern textfil som används för att få ut rådata i en textfil. Mer information returneras när parametern verbose används. Generell buggrättning<br /> <br /> [[Kategori:www.temperatur.nu]]<br /> [[Kategori:Mjukvara]]</div>

Elf98 https://wiki.temperatur.nu/index.php?title=Temperatur.nu_Reporter&diff=783 Temperatur.nu Reporter 2021-03-08T07:22:41Z

<p>Elf98: </p> <hr /> <div>Information om Temperatur.nu Reporter Version 1.<br /> <br /> [[Fil:T reporter1.jpg|höger|200px]]<br /> == Var kan du köpa den? ==<br /> Version 1 säljs inte längre, men efterföljaren TEmperatur.nu Reporter V2 finns på m.nu [[https://www.m.nu/temperaturnu-reporter-v2-rapportera-till-temperaturnu https://www.m.nu/temperaturnu-reporter-v2-rapportera-till-temperaturnu]]<br /> <br /> == Generellt ==<br /> * Färgen på Reporterns statusdiod updateras endast i samband med att ett anslutningsförsök till temperatur.nu görs var tredje minut.<br /> * Reportern konsumerar ca 10Mb data per månad.<br /> <br /> == Blinkguide FW 2.1 ==<br /> <br /> Normal drift:<br /> * Blinkar blått 1 gång per sekund: Startar upp eller om (initierar nätverkskortet och hämtar IP via DHCP).<br /> * Blinkar grönt 1 gång per sekund: 2st temperatur har lästs in och boxen har kontakt med temperatur.nu<br /> * Blinkar lila 1 gång per sekund: 1st temperatur har lästs in och boxen har kontakt med temperatur.nu<br /> <br /> Felkoder:<br /> * Blinkar vitt 1 gång per sekund: inga temperatursensorer kan hittas, Reportern har kontakt med temperatur.nu<br /> * Blinkar rött en gång per sekund: Boxen har anslutit till nätverket (erhållit ipnummer), men får inte kontakt med temperatur.nu. Reportern startar om automatiskt efter en stund när ingen kontakt med temperatur.nu kan etableras.<br /> <br /> == Blinkguide FW 2.0 ==<br /> <br /> Version FW 2.0 är återkallad pga en stor bugg i mjukvaran. Har du en reporter med FW2.0, skicka ett mail till support@temperatur.nu så byter vi ut den!<br /> <br /> == Blinkguide FW 1.0/1.0.1 ==<br /> <br /> * Blinkar grönt 1 gång per sekund: 2st temperaturer har lästs in och boxen har kontakt med temperatur.nu<br /> * Blinkar lila 1 gång per sekund: 1st temperatur har lästs in och boxen har kontakt med temperatur.nu<br /> * Blinkar vitt 1 gång per sekund: inga temperatursensorer kan hittas, boxen har kontakt med temperatur.nu<br /> * Lyser blått i 1 till 3 sekunder: Boxen Läser in temperaturer och försöker skicka upp data till temperatur.nu<br /> * Blinkar rött en gång per sekund: Boxen har anslutit till nätverket (erhållit ipnummer) och kan läsa in temperaturer, men får inte kontakt med temperatur.nu.<br /> <br /> * Fast lila sken: Försöker hämta IP-adress via DHCP<br /> * Blinkar lila i snabb takt: DHCP misslyckades och boxen startar om för att försöka igen.<br /> <br /> * Fast rött sken: Försöker göra namnuppslagning för www.temperatur.nu.<br /> * Blinkar rött i snabb (10ggr/sekund) takt: Kan inte hitta temperatur.nu vid uppstart och boxen startar om för att försöka igen.<br /> * Blinkar rött i snabb (5ggr/sekund) takt: Kan inte få kontakt med temperatur.nu efter att boxen initierats korrekt. Boxen startar om för att försöka igen.<br /> <br /> == Hårdvaran ==<br /> Temperatur.nu Reporter är uppbyggd kring en Atmega328. Nätverksmodulen är baserad på ENC28J60. <br /> <br /> == Mjukvaran ==<br /> Användaren kan inte göra några egna inställningar i boxen och allt är "plug and play". Det går inte heller att komma åt inlästa temperaturer lokalt.<br /> <br /> <br /> [[Kategori:www.temperatur.nu]]</div>

Elf98 https://wiki.temperatur.nu/index.php?title=Rapportera_till_temperatur.nu&diff=782 Rapportera till temperatur.nu 2021-03-08T07:19:49Z

<p>Elf98: </p> <hr /> <div>[[Information om www.temperatur.nu|Temperatur.nu]] bygger helt och hållet på att frivilliga ger temperatur.nu tillgång till aktuell temperatur. <br /> <br /> Informationen är flyttad till: [[https://temperatur.nu/info/rapportera-till-temperatur-nu/ https://temperatur.nu/info/rapportera-till-temperatur-nu/]]</div>

Elf98 https://wiki.temperatur.nu/index.php?title=Rapportera_till_temperatur.nu&diff=781 Rapportera till temperatur.nu 2021-03-08T07:19:37Z

<p>Elf98: Ersatte sidans innehåll med "Temperatur.nu bygger helt och hållet på att frivilliga ger temperatur.nu tillgång till aktuell temperatur. Informationen..."</p> <hr /> <div>[[Information om www.temperatur.nu|Temperatur.nu]] bygger helt och hållet på att frivilliga ger temperatur.nu tillgång till aktuell temperatur. <br /> <br /> Informationen är flyttad till: [[https://temperatur.nu/info/rapportera-till-temperatur-nu/https://temperatur.nu/info/rapportera-till-temperatur-nu/]]</div>

Elf98 https://wiki.temperatur.nu/index.php?title=API&diff=777 API 2021-03-02T13:11:10Z

<p>Elf98: /* Historik/ändringslogg */</p> <hr /> <div>{| align="right"<br /> | __TOC__<br /> |}<br /> Det finns ett enkelt API för att hämta senaste temperaturerna från temperatur.nu.<br /> <br /> Aktuell API-version 1.16. <br /> <br /> Data returneras i XML-format eller json-format<br /> <br /> ==Support==<br /> För support på API-funktionen, använd [http://www.temperatur.nu/forum/forslag-feedback/diskusionstrad-for-api-funktionen-t1373.html Forumet på www.temperatur.nu].<br /> <br /> ==Villkor==<br /> *Mjukvaran skall skrivas på ett sådant sätt att APIet inte automatiskt belastas med samma fråga oftare än var femte minut från en enskild klient. Klientid som bryter mot detta villkor kan komma att blockeras. <br /> *Det måste mycket tydligt framgå att temperaturerna kommer från temperatur.nu.<br /> *Där så är möjligt skall temperaturerna vara länkar till temperatur.nu.<br /> *Temperatur.nus [[Logotype|logotype]] skall finnas i applikationen, gärna så den tydligt syns när programmet används. Om detta ej är möjligt kan logotypen placeras där inställningar för applikationen görs.<br /> *APIet får ej användas för att automatiskt samla in och lagra data längre än 24h.<br /> *I de fall applikationen kommer att kosta pengar för användaren krävs särskild överenskommelse med temperatur.nu. Kontakta [mailto:support@temperatur.nu support@temperatur.nu] för mer information.<br /> *Förfrågningar till APIet kan signeras, från och med version 1.11 är osignerade förfrågningar är begränsade till ca 20/timma per klientid. Denna begränsning kommer efter hand att läggas in även på de äldre versionerna. Maila [mailto:support@temperatur.nu support@temperatur.nu] för att att erhålla en signeringsnyckel för ditt klientid. När du ansöker om en signeringsnyckel måste du ange om du vill signera med sha1 eller md5. Läs mer om hur du signerar förfrågningarna längre ner på denna sida.<br /> *Du skall skriva en beskrivning av din mjukvara i denna Wiki. På så sätt kommer fler intresserade att hitta din applikation. Klienter som inte finns beskrivna i Wikin kan komma att blockeras. [[Mjukvaror_som_använder_APIet|Här finns en lista med kända klienter]]<br /> <br /> <br /> ==Kort beskrivning==<br /> APIet är tänkt att användas av de som skapar extern mjukvara, tex applikationer för Iphone och Android.<br /> Målet är att APIet skall vara lättförståeligt och lätt att använda - feedback från användarna är av stor vikt för att kunna utveckla APIet!<br /> <br /> ==Var finns APIet?==<br /> Du accessar APIet via http://api.temperatur.nu/tnu_1.<version>.php. ex: http://api.temperatur.nu/tnu_1.12.php<br /> <br /> ==Parametrar==<br /> Generellta parametrar<br /> <br /> {| border=1 class="wikitable"<br /> |-<br /> ! Parameter<br /> ! Beskrivning<br /> ! Kan ej användas med<br /> ! Introducerad i API-version<br /> |-<br /> | json<br /> | Om angiven returneras data i json-format i stället för xml<br /> | <br /> | 1.16<br /> |-<br /> | p<br /> | Anger för vilka orter data skall returneras - kommaseparerad lista. Utelämnas parametern returneras samtliga mätpunkter.<br /> | lat, lon, num<br /> | 1.0<br /> |-<br /> | dc<br /> | Anger om decimalkomma skall användas i stället för decimalpunkt i fälten <temperatur>, <lat>, <lon> och <dist>.<br /> |<br /> | 1.0<br /> |-<br /> | simple<br /> | Minimal output, returnerar endast <title>, <id> och <temp><br /> | verbose<br /> | 1.0<br /> |-<br /> | verbose<br /> | Returnerar alla fält för orten, se beskrivning nedan<br /> | simple<br /> | 1.0<br /> |-<br /> | coordinates<br /> | Visar koordinaterna för valda orter. Kan användas tillsammans med simple för att kunna positionera orter på en karta utan att behöva hämta alla fält.<br /> | verbose<br /> | 1.0<br /> |-<br /> | lat<br /> | Används tillsammans med lon och ev num. Det spelar inte någon roll om decimal- eller kommapunkt används. När dessa parametrar används returneras de num närmaste orterna, närmaste orten först.<br /> | p<br /> | 1.0<br /> |-<br /> | lon<br /> | Används tillsammans med lat och ev num. Det spelar inte någon roll om decimal- eller kommapunkt används. När dessa parametrar används returneras de num närmaste orterna, närmaste orten först..<br /> | p<br /> | 1.0<br /> |-<br /> | num<br /> | Används tillsammans med lat och lon. Anger hur många orter som skall returneras. Standard är 1 och max är 5 (10 från v 1.12).<br /> | p<br /> | 1.0<br /> |-<br /> | cb<br /> | CacheBust. Om denna parameter finns i urlen (&cb) kommer ett randomiserat värde att läggas till i slutet av graf-urlerna. Denna parameter kan användas för att se till att inte grafen cachas lokalt hos användaren eller i någon dåligt konfigurerad proxy mellan temperatur.nu och användaren.<br /> |<br /> | 1.8<br /> |-<br /> | cli <br /> | Skall användas för att identifiera vilken klient som hämtar data. Ex "cli=tnu_widget". Från mitten av 2011 kommer signering av urlerna krävas i kombination med cli. Läs mer längre ner.<br /> |<br /> | 1.1<br /> |-<br /> | sign<br /> | Skall APIet regelbundet måste URLerna signeras. Se information längre ner på denna sida.<br /> |<br /> | 1.0 (tillagd i efterhand)<br /> |}<br /> <br /> Parametrar som är relaterade till att hämta statistik<br /> {| border=1 class="wikitable"<br /> |-<br /> ! Parameter<br /> ! Beskrivning<br /> ! Kan ej användas med<br /> ! Introducerad i API-version<br /> |-<br /> | data<br /> | Används för att hämta rådata för en mätpunkt specificerade med variabeln p.<br /> | graph, textfil<br /> | 1.16<br /> |-<br /> | textfil<br /> | Används för att hämta länk till textfil med rådata för en mätpunkt specificerade med variabeln p. Ange parameter graddagar, dygnsmedel eller timmedel (ex textfil=graddagar) för att specificera vilket format textfilen ska ha.<br /> | graph, data<br /> | 1.16<br /> |-<br /> | amm<br /> | Används för att hämta Average, Min & Max för upp till 5 (10 från v1.12) orter specificerade med variabeln p.<br /> | graph<br /> | 1.11<br /> |-<br /> | daily<br /> | Används för att hämta dygnsmedel samt lägsta och högsta temperatur per dygn. En mätpunkt specificerad med variabeln p.<br /> | graph<br /> | 1.15<br /> |-<br /> | span<br /> | Specificerar för vilket tidsperspektiv Average, Min & Max skall skapas. Giltiga värden är: 1day (standard), 1week, 1month, 1year.<br /> | start, end<br /> | 1.2<br /> |-<br /> | shift_g<br /> |Anger om daily skall visa äldre data. Exempel: om span är 1month och shift_g är 1 hämtas data för föregående månad. Standard är 0.<br /> | start, end<br /> | 1.15<br /> |-<br /> | start<br /> | Specificerar starttid för amm. Formatet är Y-m-d-H-i, ex 2011-01-30-12-31.<br /> | span<br /> | 1.11<br /> |-<br /> | end<br /> | Specificerar sluttid för amm. Formatet är Y-m-d-H-i, ex 2011-01-30-12-31. Standard är nuvarande tid<br /> | span<br /> | 1.11<br /> |}<br /> <br /> Parametrar som är relaterade till grafgenerering:<br /> {| border=1 class="wikitable"<br /> |-<br /> ! Parameter<br /> ! Beskrivning<br /> ! Kan ej användas med<br /> ! Introducerad i API-version<br /> |-<br /> | graph<br /> | Används för att generera en graf för upp till 5 orter specificerade med variabeln p. Anges variablen compare kommer orterna att läggas in i samma graf i stället för separata.<br /> | amm<br /> | 1.2<br /> |-<br /> | span<br /> | Specificerar för vilket tidsperspektiv grafer skall skapas. Giltiga värden är: 1day (standard), 1week, 1month, 1year.<br /> | start, end<br /> | 1.2<br /> |-<br /> | shift_g<br /> | Anger om grafen skall visa äldre data. Exempel: om span är 1day och shift_g är 1 visas en graf för igår, om shift_g är 2 visar grafen data för i förrgår etc. Standard är 0.<br /> | start, end<br /> | 1.5<br /> |-<br /> | start<br /> | Specificerar starttid för graph eller amm. Formatet är Y-m-d-H-i, ex 2011-01-30-12-31.<br /> | span, shift_g, history<br /> | 1.11<br /> |-<br /> | end<br /> | Specificerar sluttid för graph eller amm. Formatet är Y-m-d-H-i, ex 2011-01-30-12-31. Standard är nuvarande tid<br /> | span, shift_g, history<br /> | 1.11<br /> |-<br /> | history<br /> | Används för att i grafen lägga in föregående periods temperatur. Visas temperaturen för det senaste dygnet visas föregående 24h i en annan färg etc. Kan förklarliga skäl endast användas med variabeln graph.<br /> | start, end<br /> | 1.12<br /> |-<br /> | history_year<br /> | Används för att i grafen lägga in jämförelse med annat år. År anges med 4 siffror, ex 2013. Kan förklarliga skäl endast användas med variabeln graph.<br /> | start, end<br /> | 1.14<br /> |-<br /> | verbose_g<br /> | Visar min/max/medel/senaste värde i grafen. Visar även när data senast hämtades för den valda orten.<br /> |<br /> | 1.5<br /> |-<br /> | 1axis<br /> | Används för att endast visa temperaturskalan till vänster. Används med fördel i små grafer för att spara utrymme.<br /> |<br /> | 1.6<br /> |-<br /> | fontsize<br /> | Anger hur stor texten skall vara. Observera att värdet inte kan relateras till vanliga textstorlekar, du måste därför testa dig fram.<br /> |<br /> | 1.8<br /> |-<br /> | linewidth<br /> | Anger bredden på graflinjen. Giltiga värden 1 till 5. Även flyttal, ex 1.5, fungerar. Decimalkomma eller decimalpunkt spelar inte någon roll.<br /> |<br /> | 1.7<br /> |-<br /> | x<br /> | Specificerar hur bred grafen skall vara. Giltiga värden är 150-2500. 300 är standard.<br /> |<br /> | 1.2 (Tillåtna värden justerade i v 1.4,v 1.14)<br /> |-<br /> | y<br /> | Specificerar hur hög grafen skall vara. Giltiga värden är 125-2500. 200 är standard.<br /> |<br /> | 1.2 (Tillåtna värden justerade i v 1.4, v 1.14)<br /> |-<br /> | color<br /> | Anger vilken/vilka färger linjer i grafen skall ha, kommasepararead lista. Standard är #FF0000,#AADDAA,#FFCC00.<br /> |<br /> | 1.13<br /> |-<br /> | compare<br /> | Anger att order som skickats med p skall läggas in för jämförelse i samma graf. Om fler än tre orter anges måste även color definieras<br /> |<br /> | 1.13<br /> |}<br /> <br /> ==Beskrivning av returnerade fält==<br /> {| border=1 class="wikitable"<br /> |-<br /> ! Fält<br /> ! Beskrivning<br /> ! parameter som visar<br /> ! parameter som döljer<br /> ! Visas som standard<br /> ! Introducerad i API-version<br /> |-<br /> | <title><br /> | Mätpunktens namn på temperatur.nu<br /> | <br /> | <br /> | X<br /> | 1.0<br /> |-<br /> | <id><br /> | Mätpunktens id på temperatur.nu. Kan användas med parametern "p" för att hämta endast denna mätpunkts information<br /> |<br /> | simple<br /> | X<br /> | 1.0<br /> |-<br /> | <temp><br /> | Mätpunktens senaste temperatur. Om decimalkomma eller decimalpunkt skall användas styrs med parametern dc.<br /> |<br /> |<br /> | X<br /> | 1.0<br /> |-<br /> | <lat><br /> | Mätpunktens latitud i decimalt format. Om decimalkomma eller decimalpunkt skall användas styrs med parametern dc.<br /> | coordinates, verbose<br /> |<br /> |<br /> | 1.0<br /> |-<br /> | <lon><br /> | Mätpunktens longitud i decimalt format. Om decimalkomma eller decimalpunkt skall användas styrs med parametern dc.<br /> | coordinates, verbose<br /> |<br /> |<br /> | 1.0<br /> |-<br /> | <lastUpdate><br /> | Tidpunkt då informationen senast uppdaterades på temperatur.nu<br /> | verbose<br /> |<br /> |<br /> | 1.0<br /> |-<br /> | <kommun><br /> | Den kommun som mätpunkten ligger i.<br /> | verbose<br /> |<br /> |<br /> | 1.0<br /> |-<br /> | <lan><br /> | Det län som mätpunkten ligger i.<br /> | verbose<br /> |<br /> |<br /> | 1.0<br /> |-<br /> | <sourceInfo><br /> | En kort textsträng med information om vem som loggar temperaturen för mätpunkten<br /> | verbose<br /> |<br /> |<br /> | 1.8<br /> |-<br /> | <forutsattning><br /> | Textsträng med information om hur mätningarna sker - finns ej för alla mätpunkter och returernar om så är fallet ett tomt fält.<br /> | verbose<br /> |<br /> |<br /> | 1.16<br /> |-<br /> | <url><br /> | Url till mätpunktens temperatur och grafer på www.temperatur.nu<br /> | verbose<br /> |<br /> |<br /> | 1.0<br /> |-<br /> | <dist><br /> | Hur långt från de givna koordinaterna mätpunkten ligger. Enheten är kilometer. Om decimalkomma eller decimalpunkt skall användas styrs med parametern dc.<br /> | lat & lon<br /> | simple<br /> |<br /> | 1.0<br /> |-<br /> | <graph><br /> | Visar url till graph för orten. Observera att ny graf endast genereras när parametern graph används. Det går därför inte att lokalt cacha urlen i klienten. <br /> | graph (x, y, span, verbose_g, shift_g)<br /> |<br /> |<br /> | 1.2<br /> |-<br /> | <ClientVersion><br /> | Visar vilken den senaste släppta klientversionen är. Kan med fördel användas för att kontrollera om det finns någon uppdatering till klientmjukvaran.<br /> | version<br /> |<br /> |<br /> | 1.10<br /> |-<br /> | <ClientVersionSet><br /> | Visar status i samband med att informationen om klientversionen uppdaterats.<br /> | version_update<br /> |<br /> |<br /> | 1.10<br /> |-<br /> | <daily><br /> | Har underliggande fält <date>, <average>, <min>, <max> som representerar data för dygn angivet i fältet date. Dessa fält returneras när parametern daily används för att hämta statisk för flera dygn<br /> | daily, span, start, end, shift_g<br /> |<br /> |<br /> | 1.15<br /> |-<br /> | <ammRange><br /> | Visar för vilket tidsperspektiv amm (medel/min/max) har hämtats<br /> | amm, span, start, end, shift_g<br /> |<br /> |<br /> | 1.11<br /> |-<br /> | <average><br /> | Medeltemperatur i specificerat tidsperspektiv<br /> | amm, span, start, end, shift_g<br /> |<br /> |<br /> | 1.11<br /> |-<br /> | <min><br /> | Den minsta temperaturen i specificerat tidsperspektiv<br /> | amm, span, start, end, shift_g<br /> |<br /> |<br /> | 1.11<br /> |-<br /> | <minTime><br /> | Vid vilken tidpunkt <min> inträffade<br /> | amm, span, start, end, shift_g<br /> |<br /> |<br /> | 1.11<br /> |-<br /> | <max><br /> | Den högsta temperaturen i specificerat tidsperspektiv<br /> | amm, span, start, end, shift_g<br /> |<br /> |<br /> | 1.11<br /> |-<br /> | <maxTime><br /> | Vid vilken tidpunkt <max> inträffade<br /> | amm, span, start, end, shift_g<br /> |<br /> |<br /> | 1.11<br /> |-<br /> | <uptime><br /> | Mätpunktens upptid i % det senaste året<br /> | verbose<br /> |<br /> |<br /> | 1.16<br /> |-<br /> | <start><br /> | Tidpunkt när mätpunkten lades till på temperatur.nu<br /> | verbose<br /> |<br /> |<br /> | 1.16<br /> |-<br /> | <moh><br /> | Mätpunktens höjd över havsnivån (Meter above Sea Level)<br /> | verbose<br /> |<br /> |<br /> | 1.16<br /> |-<br /> | <rawdata><br /> | Temperaturdata i råformat. Varje rawdata-fält innehåller subfälten date, time, timestamp, temperatur<br /> | data<br /> |<br /> |<br /> | 1.16<br /> |-<br /> | <textfil><br /> | Länk till fil med rådata i textformat.<br /> | textfil<br /> |<br /> |<br /> | 1.16<br /> <br /> |}<br /> <br /> ==Exempel==<br /> <br /> Så här kan resultatet från en förfrågan på http://api.temperatur.nu/tnu_1.12.php?p=linkoping&verbose&cli=test_app se ut:<br /> <?xml version='1.0' encoding='iso-8859-1'?><br /> <rss version="2.0"><br /> <channel><br /> <title>Temperatur.nu API 1.12 - Din url är inte korrekt signerad, clientnyckeln kan tillfälligt blockeras - /tnu_1.12.php</title><br /> <link>http://wiki.temperatur.nu/index.php/Api</link><br /> <item><br /> <title>Linköping/Centrum</title><br /> <id>linkoping</id><br /> <temp>9.3</temp><br /> <lat>58.414297</lat><br /> <lon>15.628788</lon><br /> <lastUpdate>2011-11-24 08:51:25</lastUpdate><br /> <kommun>Linköping</kommun><br /> <lan>Östergötlands län</lan><br /> <sourceInfo>Temperaturdata från Stångå Hotell.</sourceInfo><br /> <url>http://www.temperatur.nu/linkoping.html</url><br /> </item><br /> </channel><br /> </rss><br /> <br /> <br /> Så här kan resultatet från en förfrågan på http://api.temperatur.nu/tnu_1.16.php?lat=58.376761&lon=15.562916&num=3&graph&cli=test_app2 se ut:<br /> <?xml version='1.0' encoding='utf-8'?><br /> <rss version="2.0"><br /> <channel><br /> <title>Temperatur.nu API 1.16 - Din url är inte korrekt signerad, clientnyckeln kan tillfälligt blockeras - /tnu_1.16.php</title><br /> <link>http://wiki.temperatur.nu/index.php/Api</link><br /> <item><br /> <title>Linköping/Slaka</title><br /> <id>slaka</id><br /> <temp>11.9</temp><br /> <dist>1.3</dist><br /> <graph>https://graph.temperatur.nu/graph/slaka-1day-300-200-0-0-0-1-8-n-0-n.png</graph><br /> </item><br /> <item><br /> <title>Linköping/Hagaberg</title><br /> <id>hagaberg</id><br /> <temp>12.1</temp><br /> <dist>3.7</dist><br /> <graph>https://graph.temperatur.nu/graph/hagaberg-1day-300-200-0-0-0-1-8-n-0-n.png</graph><br /> </item><br /> <item><br /> <title>Linköping/Valla</title><br /> <id>valla</id><br /> <temp>11.9</temp><br /> <dist>3.8</dist><br /> <graph>https://graph.temperatur.nu/graph/valla-1day-300-200-0-0-0-1-8-n-0-n.png</graph><br /> </item><br /> </channel><br /> </rss><br /> <br /> ==Signering av URLer==<br /> Förfrågningar till APIet kan signeras. Från och med version 1.11 är antalet osignerade förfrågningar begränsade till 20 per timma. Osignerade förfrågningar kommer i framtiden att begränsas för alla api-versioner. Skriver du en privat tillämpning kan du använda APIet utan att signera URLerna.<br /> <br /> Signeringen går till så här:<br /> <br /> 1. Skapa din url som vanligt.<br /> <br /> 2. Beräkna md5-/sha1-summan av urlen (utan http://) med "+clientnyckel" tillagd på slutet. Klientnyckel erhålls efter att ha mailat [mailto:support@temperatur.nu support@temperatur.nu]<br /> <br /> 3. I slutet av urlen lägger du sedan till &sign=md5-/sha1-summa<br /> <br /> I php kan det tex se ut så här om du har en signeringsnyckel för md5:<br /> $cli_key="XXXXXXXXXXXXXXXXXXXXXXXXX";<br /> $url="api.temperatur.nu/tnu_1.9.php?p=linkoping&cli=testapp"<br /> $sign=md5($url."+".$cli_key);<br /> $signed_url=$url."&sign=".$sign;<br /> <br /> I den returnerade xml-filen kan du i det första title-fältet se om förfrågan är korrekt signerad.<br /> <br /> [http://www.fileformat.info/tool/hash.htm?text= fileformat.info] är en mycket bra sida för att verifiera att de sha1-/md5-summor du tagit fram stämmer.<br /> <br /> ==Historik/ändringslogg==<br /> 2010-05-04 - Version 1.0<br /> Första releasen.<br /> <br /> 2010-05-13 - Version 1.1<br /> Variabeln cli tillagd.<br /> <br /> 2010-05-19 - Version 1.2<br /> Stöd för att hämta grafer<br /> <br /> 2010-06-09 - Version 1.3<br /> Bugfix som fixar en bugg introducerad i 1.2 (det gick inte att hämta alla orter genom att skippa variabeln p).<br /> <br /> 2010-08-04 - Version 1.4<br /> Värden för x och y justerade. Parametern cli krävs för att apiet skall returnera data.<br /> <br /> 2010-09-01 - Version 1.5<br /> Parametrar för att via mer info i grafen. Parametrar för att visa grafer för i går, förra veckan, 2 år sedan etc.<br /> <br /> 2010-09-01 - Version 1.6<br /> Parameter för att ange om 1 eller 2 y-axlar skall visas.<br /> <br /> 2010-11-22 - Version 1.7<br /> Möjlighet att välja hur tjock graflinjen skall vara.<br /> <br /> 2010-12-19 - Version 1.8<br /> CacheBust-funktion, möjlighet att ändra textstorlek samt information om vem som loggar temperaturen när verbose är specat.<br /> <br /> 2011-01-13 - Version 1.9<br /> Signeringsfunktion inlagd. Signeringsfunktionen kommer från mitten av 2011 krävas för alla tillämpningar och och kommer successivt att läggas in i alla versioner av apiet.<br /> <br /> 2011-01-17 - Version 1.10<br /> Möjlighet att via Apiet hantera informaion gällande den senaste tillgängliga klientversionen.<br /> <br /> 2011-01-30 - Version 1.11<br /> Mer flexibel specificering av tidsperspektiv för grafer. amm - möjlighet att hämta medel/min/max i ett valfritt tidsperspektiv, antalet osignerade accesser begränsat i denna version.<br /> <br /> 2011-10-08 - Version 1.12<br /> Variabeln history tillagd. Visar föregående periods temperatur i grafer.<br /> <br /> 2012-05-04 - Version 1.13<br /> Variablerna compare och color angivna, gör det möjligt att jämföra flera orter i samma graf samt helt styra vilka färger linjerna i graferna skall ha. color kan sättas även för vanliga grafer.<br /> <br /> 2013 - Version 1.14<br /> Parametern history_year som används för att jämföra data med tidigare år. Buggfixar<br /> <br /> 2014-01-26 - Version 1.15<br /> Parametern daily. Används för att hämta dygnsmedel i ett specificerat tidsspann.<br /> <br /> 2021-02-25 - Version 1.16<br /> Parametern json för att få ut data i json-format. Parametern data som används för att få ut data i råformat. Parametern textfil som används för att få ut rådata i en textfil. Mer information returneras när parametern verbose används. Generell buggrättning<br /> <br /> [[Kategori:www.temperatur.nu]]<br /> [[Kategori:Mjukvara]]</div>

Elf98 https://wiki.temperatur.nu/index.php?title=API&diff=776 API 2021-03-02T13:10:37Z

<p>Elf98: /* Beskrivning av returnerade fält */</p> <hr /> <div>{| align="right"<br /> | __TOC__<br /> |}<br /> Det finns ett enkelt API för att hämta senaste temperaturerna från temperatur.nu.<br /> <br /> Aktuell API-version 1.16. <br /> <br /> Data returneras i XML-format eller json-format<br /> <br /> ==Support==<br /> För support på API-funktionen, använd [http://www.temperatur.nu/forum/forslag-feedback/diskusionstrad-for-api-funktionen-t1373.html Forumet på www.temperatur.nu].<br /> <br /> ==Villkor==<br /> *Mjukvaran skall skrivas på ett sådant sätt att APIet inte automatiskt belastas med samma fråga oftare än var femte minut från en enskild klient. Klientid som bryter mot detta villkor kan komma att blockeras. <br /> *Det måste mycket tydligt framgå att temperaturerna kommer från temperatur.nu.<br /> *Där så är möjligt skall temperaturerna vara länkar till temperatur.nu.<br /> *Temperatur.nus [[Logotype|logotype]] skall finnas i applikationen, gärna så den tydligt syns när programmet används. Om detta ej är möjligt kan logotypen placeras där inställningar för applikationen görs.<br /> *APIet får ej användas för att automatiskt samla in och lagra data längre än 24h.<br /> *I de fall applikationen kommer att kosta pengar för användaren krävs särskild överenskommelse med temperatur.nu. Kontakta [mailto:support@temperatur.nu support@temperatur.nu] för mer information.<br /> *Förfrågningar till APIet kan signeras, från och med version 1.11 är osignerade förfrågningar är begränsade till ca 20/timma per klientid. Denna begränsning kommer efter hand att läggas in även på de äldre versionerna. Maila [mailto:support@temperatur.nu support@temperatur.nu] för att att erhålla en signeringsnyckel för ditt klientid. När du ansöker om en signeringsnyckel måste du ange om du vill signera med sha1 eller md5. Läs mer om hur du signerar förfrågningarna längre ner på denna sida.<br /> *Du skall skriva en beskrivning av din mjukvara i denna Wiki. På så sätt kommer fler intresserade att hitta din applikation. Klienter som inte finns beskrivna i Wikin kan komma att blockeras. [[Mjukvaror_som_använder_APIet|Här finns en lista med kända klienter]]<br /> <br /> <br /> ==Kort beskrivning==<br /> APIet är tänkt att användas av de som skapar extern mjukvara, tex applikationer för Iphone och Android.<br /> Målet är att APIet skall vara lättförståeligt och lätt att använda - feedback från användarna är av stor vikt för att kunna utveckla APIet!<br /> <br /> ==Var finns APIet?==<br /> Du accessar APIet via http://api.temperatur.nu/tnu_1.<version>.php. ex: http://api.temperatur.nu/tnu_1.12.php<br /> <br /> ==Parametrar==<br /> Generellta parametrar<br /> <br /> {| border=1 class="wikitable"<br /> |-<br /> ! Parameter<br /> ! Beskrivning<br /> ! Kan ej användas med<br /> ! Introducerad i API-version<br /> |-<br /> | json<br /> | Om angiven returneras data i json-format i stället för xml<br /> | <br /> | 1.16<br /> |-<br /> | p<br /> | Anger för vilka orter data skall returneras - kommaseparerad lista. Utelämnas parametern returneras samtliga mätpunkter.<br /> | lat, lon, num<br /> | 1.0<br /> |-<br /> | dc<br /> | Anger om decimalkomma skall användas i stället för decimalpunkt i fälten <temperatur>, <lat>, <lon> och <dist>.<br /> |<br /> | 1.0<br /> |-<br /> | simple<br /> | Minimal output, returnerar endast <title>, <id> och <temp><br /> | verbose<br /> | 1.0<br /> |-<br /> | verbose<br /> | Returnerar alla fält för orten, se beskrivning nedan<br /> | simple<br /> | 1.0<br /> |-<br /> | coordinates<br /> | Visar koordinaterna för valda orter. Kan användas tillsammans med simple för att kunna positionera orter på en karta utan att behöva hämta alla fält.<br /> | verbose<br /> | 1.0<br /> |-<br /> | lat<br /> | Används tillsammans med lon och ev num. Det spelar inte någon roll om decimal- eller kommapunkt används. När dessa parametrar används returneras de num närmaste orterna, närmaste orten först.<br /> | p<br /> | 1.0<br /> |-<br /> | lon<br /> | Används tillsammans med lat och ev num. Det spelar inte någon roll om decimal- eller kommapunkt används. När dessa parametrar används returneras de num närmaste orterna, närmaste orten först..<br /> | p<br /> | 1.0<br /> |-<br /> | num<br /> | Används tillsammans med lat och lon. Anger hur många orter som skall returneras. Standard är 1 och max är 5 (10 från v 1.12).<br /> | p<br /> | 1.0<br /> |-<br /> | cb<br /> | CacheBust. Om denna parameter finns i urlen (&cb) kommer ett randomiserat värde att läggas till i slutet av graf-urlerna. Denna parameter kan användas för att se till att inte grafen cachas lokalt hos användaren eller i någon dåligt konfigurerad proxy mellan temperatur.nu och användaren.<br /> |<br /> | 1.8<br /> |-<br /> | cli <br /> | Skall användas för att identifiera vilken klient som hämtar data. Ex "cli=tnu_widget". Från mitten av 2011 kommer signering av urlerna krävas i kombination med cli. Läs mer längre ner.<br /> |<br /> | 1.1<br /> |-<br /> | sign<br /> | Skall APIet regelbundet måste URLerna signeras. Se information längre ner på denna sida.<br /> |<br /> | 1.0 (tillagd i efterhand)<br /> |}<br /> <br /> Parametrar som är relaterade till att hämta statistik<br /> {| border=1 class="wikitable"<br /> |-<br /> ! Parameter<br /> ! Beskrivning<br /> ! Kan ej användas med<br /> ! Introducerad i API-version<br /> |-<br /> | data<br /> | Används för att hämta rådata för en mätpunkt specificerade med variabeln p.<br /> | graph, textfil<br /> | 1.16<br /> |-<br /> | textfil<br /> | Används för att hämta länk till textfil med rådata för en mätpunkt specificerade med variabeln p. Ange parameter graddagar, dygnsmedel eller timmedel (ex textfil=graddagar) för att specificera vilket format textfilen ska ha.<br /> | graph, data<br /> | 1.16<br /> |-<br /> | amm<br /> | Används för att hämta Average, Min & Max för upp till 5 (10 från v1.12) orter specificerade med variabeln p.<br /> | graph<br /> | 1.11<br /> |-<br /> | daily<br /> | Används för att hämta dygnsmedel samt lägsta och högsta temperatur per dygn. En mätpunkt specificerad med variabeln p.<br /> | graph<br /> | 1.15<br /> |-<br /> | span<br /> | Specificerar för vilket tidsperspektiv Average, Min & Max skall skapas. Giltiga värden är: 1day (standard), 1week, 1month, 1year.<br /> | start, end<br /> | 1.2<br /> |-<br /> | shift_g<br /> |Anger om daily skall visa äldre data. Exempel: om span är 1month och shift_g är 1 hämtas data för föregående månad. Standard är 0.<br /> | start, end<br /> | 1.15<br /> |-<br /> | start<br /> | Specificerar starttid för amm. Formatet är Y-m-d-H-i, ex 2011-01-30-12-31.<br /> | span<br /> | 1.11<br /> |-<br /> | end<br /> | Specificerar sluttid för amm. Formatet är Y-m-d-H-i, ex 2011-01-30-12-31. Standard är nuvarande tid<br /> | span<br /> | 1.11<br /> |}<br /> <br /> Parametrar som är relaterade till grafgenerering:<br /> {| border=1 class="wikitable"<br /> |-<br /> ! Parameter<br /> ! Beskrivning<br /> ! Kan ej användas med<br /> ! Introducerad i API-version<br /> |-<br /> | graph<br /> | Används för att generera en graf för upp till 5 orter specificerade med variabeln p. Anges variablen compare kommer orterna att läggas in i samma graf i stället för separata.<br /> | amm<br /> | 1.2<br /> |-<br /> | span<br /> | Specificerar för vilket tidsperspektiv grafer skall skapas. Giltiga värden är: 1day (standard), 1week, 1month, 1year.<br /> | start, end<br /> | 1.2<br /> |-<br /> | shift_g<br /> | Anger om grafen skall visa äldre data. Exempel: om span är 1day och shift_g är 1 visas en graf för igår, om shift_g är 2 visar grafen data för i förrgår etc. Standard är 0.<br /> | start, end<br /> | 1.5<br /> |-<br /> | start<br /> | Specificerar starttid för graph eller amm. Formatet är Y-m-d-H-i, ex 2011-01-30-12-31.<br /> | span, shift_g, history<br /> | 1.11<br /> |-<br /> | end<br /> | Specificerar sluttid för graph eller amm. Formatet är Y-m-d-H-i, ex 2011-01-30-12-31. Standard är nuvarande tid<br /> | span, shift_g, history<br /> | 1.11<br /> |-<br /> | history<br /> | Används för att i grafen lägga in föregående periods temperatur. Visas temperaturen för det senaste dygnet visas föregående 24h i en annan färg etc. Kan förklarliga skäl endast användas med variabeln graph.<br /> | start, end<br /> | 1.12<br /> |-<br /> | history_year<br /> | Används för att i grafen lägga in jämförelse med annat år. År anges med 4 siffror, ex 2013. Kan förklarliga skäl endast användas med variabeln graph.<br /> | start, end<br /> | 1.14<br /> |-<br /> | verbose_g<br /> | Visar min/max/medel/senaste värde i grafen. Visar även när data senast hämtades för den valda orten.<br /> |<br /> | 1.5<br /> |-<br /> | 1axis<br /> | Används för att endast visa temperaturskalan till vänster. Används med fördel i små grafer för att spara utrymme.<br /> |<br /> | 1.6<br /> |-<br /> | fontsize<br /> | Anger hur stor texten skall vara. Observera att värdet inte kan relateras till vanliga textstorlekar, du måste därför testa dig fram.<br /> |<br /> | 1.8<br /> |-<br /> | linewidth<br /> | Anger bredden på graflinjen. Giltiga värden 1 till 5. Även flyttal, ex 1.5, fungerar. Decimalkomma eller decimalpunkt spelar inte någon roll.<br /> |<br /> | 1.7<br /> |-<br /> | x<br /> | Specificerar hur bred grafen skall vara. Giltiga värden är 150-2500. 300 är standard.<br /> |<br /> | 1.2 (Tillåtna värden justerade i v 1.4,v 1.14)<br /> |-<br /> | y<br /> | Specificerar hur hög grafen skall vara. Giltiga värden är 125-2500. 200 är standard.<br /> |<br /> | 1.2 (Tillåtna värden justerade i v 1.4, v 1.14)<br /> |-<br /> | color<br /> | Anger vilken/vilka färger linjer i grafen skall ha, kommasepararead lista. Standard är #FF0000,#AADDAA,#FFCC00.<br /> |<br /> | 1.13<br /> |-<br /> | compare<br /> | Anger att order som skickats med p skall läggas in för jämförelse i samma graf. Om fler än tre orter anges måste även color definieras<br /> |<br /> | 1.13<br /> |}<br /> <br /> ==Beskrivning av returnerade fält==<br /> {| border=1 class="wikitable"<br /> |-<br /> ! Fält<br /> ! Beskrivning<br /> ! parameter som visar<br /> ! parameter som döljer<br /> ! Visas som standard<br /> ! Introducerad i API-version<br /> |-<br /> | <title><br /> | Mätpunktens namn på temperatur.nu<br /> | <br /> | <br /> | X<br /> | 1.0<br /> |-<br /> | <id><br /> | Mätpunktens id på temperatur.nu. Kan användas med parametern "p" för att hämta endast denna mätpunkts information<br /> |<br /> | simple<br /> | X<br /> | 1.0<br /> |-<br /> | <temp><br /> | Mätpunktens senaste temperatur. Om decimalkomma eller decimalpunkt skall användas styrs med parametern dc.<br /> |<br /> |<br /> | X<br /> | 1.0<br /> |-<br /> | <lat><br /> | Mätpunktens latitud i decimalt format. Om decimalkomma eller decimalpunkt skall användas styrs med parametern dc.<br /> | coordinates, verbose<br /> |<br /> |<br /> | 1.0<br /> |-<br /> | <lon><br /> | Mätpunktens longitud i decimalt format. Om decimalkomma eller decimalpunkt skall användas styrs med parametern dc.<br /> | coordinates, verbose<br /> |<br /> |<br /> | 1.0<br /> |-<br /> | <lastUpdate><br /> | Tidpunkt då informationen senast uppdaterades på temperatur.nu<br /> | verbose<br /> |<br /> |<br /> | 1.0<br /> |-<br /> | <kommun><br /> | Den kommun som mätpunkten ligger i.<br /> | verbose<br /> |<br /> |<br /> | 1.0<br /> |-<br /> | <lan><br /> | Det län som mätpunkten ligger i.<br /> | verbose<br /> |<br /> |<br /> | 1.0<br /> |-<br /> | <sourceInfo><br /> | En kort textsträng med information om vem som loggar temperaturen för mätpunkten<br /> | verbose<br /> |<br /> |<br /> | 1.8<br /> |-<br /> | <forutsattning><br /> | Textsträng med information om hur mätningarna sker - finns ej för alla mätpunkter och returernar om så är fallet ett tomt fält.<br /> | verbose<br /> |<br /> |<br /> | 1.16<br /> |-<br /> | <url><br /> | Url till mätpunktens temperatur och grafer på www.temperatur.nu<br /> | verbose<br /> |<br /> |<br /> | 1.0<br /> |-<br /> | <dist><br /> | Hur långt från de givna koordinaterna mätpunkten ligger. Enheten är kilometer. Om decimalkomma eller decimalpunkt skall användas styrs med parametern dc.<br /> | lat & lon<br /> | simple<br /> |<br /> | 1.0<br /> |-<br /> | <graph><br /> | Visar url till graph för orten. Observera att ny graf endast genereras när parametern graph används. Det går därför inte att lokalt cacha urlen i klienten. <br /> | graph (x, y, span, verbose_g, shift_g)<br /> |<br /> |<br /> | 1.2<br /> |-<br /> | <ClientVersion><br /> | Visar vilken den senaste släppta klientversionen är. Kan med fördel användas för att kontrollera om det finns någon uppdatering till klientmjukvaran.<br /> | version<br /> |<br /> |<br /> | 1.10<br /> |-<br /> | <ClientVersionSet><br /> | Visar status i samband med att informationen om klientversionen uppdaterats.<br /> | version_update<br /> |<br /> |<br /> | 1.10<br /> |-<br /> | <daily><br /> | Har underliggande fält <date>, <average>, <min>, <max> som representerar data för dygn angivet i fältet date. Dessa fält returneras när parametern daily används för att hämta statisk för flera dygn<br /> | daily, span, start, end, shift_g<br /> |<br /> |<br /> | 1.15<br /> |-<br /> | <ammRange><br /> | Visar för vilket tidsperspektiv amm (medel/min/max) har hämtats<br /> | amm, span, start, end, shift_g<br /> |<br /> |<br /> | 1.11<br /> |-<br /> | <average><br /> | Medeltemperatur i specificerat tidsperspektiv<br /> | amm, span, start, end, shift_g<br /> |<br /> |<br /> | 1.11<br /> |-<br /> | <min><br /> | Den minsta temperaturen i specificerat tidsperspektiv<br /> | amm, span, start, end, shift_g<br /> |<br /> |<br /> | 1.11<br /> |-<br /> | <minTime><br /> | Vid vilken tidpunkt <min> inträffade<br /> | amm, span, start, end, shift_g<br /> |<br /> |<br /> | 1.11<br /> |-<br /> | <max><br /> | Den högsta temperaturen i specificerat tidsperspektiv<br /> | amm, span, start, end, shift_g<br /> |<br /> |<br /> | 1.11<br /> |-<br /> | <maxTime><br /> | Vid vilken tidpunkt <max> inträffade<br /> | amm, span, start, end, shift_g<br /> |<br /> |<br /> | 1.11<br /> |-<br /> | <uptime><br /> | Mätpunktens upptid i % det senaste året<br /> | verbose<br /> |<br /> |<br /> | 1.16<br /> |-<br /> | <start><br /> | Tidpunkt när mätpunkten lades till på temperatur.nu<br /> | verbose<br /> |<br /> |<br /> | 1.16<br /> |-<br /> | <moh><br /> | Mätpunktens höjd över havsnivån (Meter above Sea Level)<br /> | verbose<br /> |<br /> |<br /> | 1.16<br /> |-<br /> | <rawdata><br /> | Temperaturdata i råformat. Varje rawdata-fält innehåller subfälten date, time, timestamp, temperatur<br /> | data<br /> |<br /> |<br /> | 1.16<br /> |-<br /> | <textfil><br /> | Länk till fil med rådata i textformat.<br /> | textfil<br /> |<br /> |<br /> | 1.16<br /> <br /> |}<br /> <br /> ==Exempel==<br /> <br /> Så här kan resultatet från en förfrågan på http://api.temperatur.nu/tnu_1.12.php?p=linkoping&verbose&cli=test_app se ut:<br /> <?xml version='1.0' encoding='iso-8859-1'?><br /> <rss version="2.0"><br /> <channel><br /> <title>Temperatur.nu API 1.12 - Din url är inte korrekt signerad, clientnyckeln kan tillfälligt blockeras - /tnu_1.12.php</title><br /> <link>http://wiki.temperatur.nu/index.php/Api</link><br /> <item><br /> <title>Linköping/Centrum</title><br /> <id>linkoping</id><br /> <temp>9.3</temp><br /> <lat>58.414297</lat><br /> <lon>15.628788</lon><br /> <lastUpdate>2011-11-24 08:51:25</lastUpdate><br /> <kommun>Linköping</kommun><br /> <lan>Östergötlands län</lan><br /> <sourceInfo>Temperaturdata från Stångå Hotell.</sourceInfo><br /> <url>http://www.temperatur.nu/linkoping.html</url><br /> </item><br /> </channel><br /> </rss><br /> <br /> <br /> Så här kan resultatet från en förfrågan på http://api.temperatur.nu/tnu_1.16.php?lat=58.376761&lon=15.562916&num=3&graph&cli=test_app2 se ut:<br /> <?xml version='1.0' encoding='utf-8'?><br /> <rss version="2.0"><br /> <channel><br /> <title>Temperatur.nu API 1.16 - Din url är inte korrekt signerad, clientnyckeln kan tillfälligt blockeras - /tnu_1.16.php</title><br /> <link>http://wiki.temperatur.nu/index.php/Api</link><br /> <item><br /> <title>Linköping/Slaka</title><br /> <id>slaka</id><br /> <temp>11.9</temp><br /> <dist>1.3</dist><br /> <graph>https://graph.temperatur.nu/graph/slaka-1day-300-200-0-0-0-1-8-n-0-n.png</graph><br /> </item><br /> <item><br /> <title>Linköping/Hagaberg</title><br /> <id>hagaberg</id><br /> <temp>12.1</temp><br /> <dist>3.7</dist><br /> <graph>https://graph.temperatur.nu/graph/hagaberg-1day-300-200-0-0-0-1-8-n-0-n.png</graph><br /> </item><br /> <item><br /> <title>Linköping/Valla</title><br /> <id>valla</id><br /> <temp>11.9</temp><br /> <dist>3.8</dist><br /> <graph>https://graph.temperatur.nu/graph/valla-1day-300-200-0-0-0-1-8-n-0-n.png</graph><br /> </item><br /> </channel><br /> </rss><br /> <br /> ==Signering av URLer==<br /> Förfrågningar till APIet kan signeras. Från och med version 1.11 är antalet osignerade förfrågningar begränsade till 20 per timma. Osignerade förfrågningar kommer i framtiden att begränsas för alla api-versioner. Skriver du en privat tillämpning kan du använda APIet utan att signera URLerna.<br /> <br /> Signeringen går till så här:<br /> <br /> 1. Skapa din url som vanligt.<br /> <br /> 2. Beräkna md5-/sha1-summan av urlen (utan http://) med "+clientnyckel" tillagd på slutet. Klientnyckel erhålls efter att ha mailat [mailto:support@temperatur.nu support@temperatur.nu]<br /> <br /> 3. I slutet av urlen lägger du sedan till &sign=md5-/sha1-summa<br /> <br /> I php kan det tex se ut så här om du har en signeringsnyckel för md5:<br /> $cli_key="XXXXXXXXXXXXXXXXXXXXXXXXX";<br /> $url="api.temperatur.nu/tnu_1.9.php?p=linkoping&cli=testapp"<br /> $sign=md5($url."+".$cli_key);<br /> $signed_url=$url."&sign=".$sign;<br /> <br /> I den returnerade xml-filen kan du i det första title-fältet se om förfrågan är korrekt signerad.<br /> <br /> [http://www.fileformat.info/tool/hash.htm?text= fileformat.info] är en mycket bra sida för att verifiera att de sha1-/md5-summor du tagit fram stämmer.<br /> <br /> ==Historik/ändringslogg==<br /> 2010-05-04 - Version 1.0<br /> Första releasen.<br /> <br /> 2010-05-13 - Version 1.1<br /> Variabeln cli tillagd.<br /> <br /> 2010-05-19 - Version 1.2<br /> Stöd för att hämta grafer<br /> <br /> 2010-06-09 - Version 1.3<br /> Bugfix som fixar en bugg introducerad i 1.2 (det gick inte att hämta alla orter genom att skippa variabeln p).<br /> <br /> 2010-08-04 - Version 1.4<br /> Värden för x och y justerade. Parametern cli krävs för att apiet skall returnera data.<br /> <br /> 2010-09-01 - Version 1.5<br /> Parametrar för att via mer info i grafen. Parametrar för att visa grafer för i går, förra veckan, 2 år sedan etc.<br /> <br /> 2010-09-01 - Version 1.6<br /> Parameter för att ange om 1 eller 2 y-axlar skall visas.<br /> <br /> 2010-11-22 - Version 1.7<br /> Möjlighet att välja hur tjock graflinjen skall vara.<br /> <br /> 2010-12-19 - Version 1.8<br /> CacheBust-funktion, möjlighet att ändra textstorlek samt information om vem som loggar temperaturen när verbose är specat.<br /> <br /> 2011-01-13 - Version 1.9<br /> Signeringsfunktion inlagd. Signeringsfunktionen kommer från mitten av 2011 krävas för alla tillämpningar och och kommer successivt att läggas in i alla versioner av apiet.<br /> <br /> 2011-01-17 - Version 1.10<br /> Möjlighet att via Apiet hantera informaion gällande den senaste tillgängliga klientversionen.<br /> <br /> 2011-01-30 - Version 1.11<br /> Mer flexibel specificering av tidsperspektiv för grafer. amm - möjlighet att hämta medel/min/max i ett valfritt tidsperspektiv, antalet osignerade accesser begränsat i denna version.<br /> <br /> 2011-10-08 - Version 1.12<br /> Variabeln history tillagd. Visar föregående periods temperatur i grafer.<br /> <br /> 2012-05-04 - Version 1.13<br /> Variablerna compare och color angivna, gör det möjligt att jämföra flera orter i samma graf samt helt styra vilka färger linjerna i graferna skall ha. color kan sättas även för vanliga grafer.<br /> <br /> 2013 - Version 1.14<br /> Parametern history_year som används för att jämföra data med tidigare år. Buggfixar<br /> <br /> 2014-01-26 - Version 1.15<br /> Parametern daily. Används för att hämta dygnsmedel i ett specificerat tidsspann.<br /> <br /> 2021-02-25 - Version 1.16<br /> Parametern json för att få ut data i json-format. Parametern data som används för att få ut data i råformat. Mer information returneras när parametern verbose används. Generell buggrättning<br /> <br /> [[Kategori:www.temperatur.nu]]<br /> [[Kategori:Mjukvara]]</div>

Elf98 https://wiki.temperatur.nu/index.php?title=API&diff=775 API 2021-03-02T13:09:49Z

<p>Elf98: /* Parametrar */</p> <hr /> <div>{| align="right"<br /> | __TOC__<br /> |}<br /> Det finns ett enkelt API för att hämta senaste temperaturerna från temperatur.nu.<br /> <br /> Aktuell API-version 1.16. <br /> <br /> Data returneras i XML-format eller json-format<br /> <br /> ==Support==<br /> För support på API-funktionen, använd [http://www.temperatur.nu/forum/forslag-feedback/diskusionstrad-for-api-funktionen-t1373.html Forumet på www.temperatur.nu].<br /> <br /> ==Villkor==<br /> *Mjukvaran skall skrivas på ett sådant sätt att APIet inte automatiskt belastas med samma fråga oftare än var femte minut från en enskild klient. Klientid som bryter mot detta villkor kan komma att blockeras. <br /> *Det måste mycket tydligt framgå att temperaturerna kommer från temperatur.nu.<br /> *Där så är möjligt skall temperaturerna vara länkar till temperatur.nu.<br /> *Temperatur.nus [[Logotype|logotype]] skall finnas i applikationen, gärna så den tydligt syns när programmet används. Om detta ej är möjligt kan logotypen placeras där inställningar för applikationen görs.<br /> *APIet får ej användas för att automatiskt samla in och lagra data längre än 24h.<br /> *I de fall applikationen kommer att kosta pengar för användaren krävs särskild överenskommelse med temperatur.nu. Kontakta [mailto:support@temperatur.nu support@temperatur.nu] för mer information.<br /> *Förfrågningar till APIet kan signeras, från och med version 1.11 är osignerade förfrågningar är begränsade till ca 20/timma per klientid. Denna begränsning kommer efter hand att läggas in även på de äldre versionerna. Maila [mailto:support@temperatur.nu support@temperatur.nu] för att att erhålla en signeringsnyckel för ditt klientid. När du ansöker om en signeringsnyckel måste du ange om du vill signera med sha1 eller md5. Läs mer om hur du signerar förfrågningarna längre ner på denna sida.<br /> *Du skall skriva en beskrivning av din mjukvara i denna Wiki. På så sätt kommer fler intresserade att hitta din applikation. Klienter som inte finns beskrivna i Wikin kan komma att blockeras. [[Mjukvaror_som_använder_APIet|Här finns en lista med kända klienter]]<br /> <br /> <br /> ==Kort beskrivning==<br /> APIet är tänkt att användas av de som skapar extern mjukvara, tex applikationer för Iphone och Android.<br /> Målet är att APIet skall vara lättförståeligt och lätt att använda - feedback från användarna är av stor vikt för att kunna utveckla APIet!<br /> <br /> ==Var finns APIet?==<br /> Du accessar APIet via http://api.temperatur.nu/tnu_1.<version>.php. ex: http://api.temperatur.nu/tnu_1.12.php<br /> <br /> ==Parametrar==<br /> Generellta parametrar<br /> <br /> {| border=1 class="wikitable"<br /> |-<br /> ! Parameter<br /> ! Beskrivning<br /> ! Kan ej användas med<br /> ! Introducerad i API-version<br /> |-<br /> | json<br /> | Om angiven returneras data i json-format i stället för xml<br /> | <br /> | 1.16<br /> |-<br /> | p<br /> | Anger för vilka orter data skall returneras - kommaseparerad lista. Utelämnas parametern returneras samtliga mätpunkter.<br /> | lat, lon, num<br /> | 1.0<br /> |-<br /> | dc<br /> | Anger om decimalkomma skall användas i stället för decimalpunkt i fälten <temperatur>, <lat>, <lon> och <dist>.<br /> |<br /> | 1.0<br /> |-<br /> | simple<br /> | Minimal output, returnerar endast <title>, <id> och <temp><br /> | verbose<br /> | 1.0<br /> |-<br /> | verbose<br /> | Returnerar alla fält för orten, se beskrivning nedan<br /> | simple<br /> | 1.0<br /> |-<br /> | coordinates<br /> | Visar koordinaterna för valda orter. Kan användas tillsammans med simple för att kunna positionera orter på en karta utan att behöva hämta alla fält.<br /> | verbose<br /> | 1.0<br /> |-<br /> | lat<br /> | Används tillsammans med lon och ev num. Det spelar inte någon roll om decimal- eller kommapunkt används. När dessa parametrar används returneras de num närmaste orterna, närmaste orten först.<br /> | p<br /> | 1.0<br /> |-<br /> | lon<br /> | Används tillsammans med lat och ev num. Det spelar inte någon roll om decimal- eller kommapunkt används. När dessa parametrar används returneras de num närmaste orterna, närmaste orten först..<br /> | p<br /> | 1.0<br /> |-<br /> | num<br /> | Används tillsammans med lat och lon. Anger hur många orter som skall returneras. Standard är 1 och max är 5 (10 från v 1.12).<br /> | p<br /> | 1.0<br /> |-<br /> | cb<br /> | CacheBust. Om denna parameter finns i urlen (&cb) kommer ett randomiserat värde att läggas till i slutet av graf-urlerna. Denna parameter kan användas för att se till att inte grafen cachas lokalt hos användaren eller i någon dåligt konfigurerad proxy mellan temperatur.nu och användaren.<br /> |<br /> | 1.8<br /> |-<br /> | cli <br /> | Skall användas för att identifiera vilken klient som hämtar data. Ex "cli=tnu_widget". Från mitten av 2011 kommer signering av urlerna krävas i kombination med cli. Läs mer längre ner.<br /> |<br /> | 1.1<br /> |-<br /> | sign<br /> | Skall APIet regelbundet måste URLerna signeras. Se information längre ner på denna sida.<br /> |<br /> | 1.0 (tillagd i efterhand)<br /> |}<br /> <br /> Parametrar som är relaterade till att hämta statistik<br /> {| border=1 class="wikitable"<br /> |-<br /> ! Parameter<br /> ! Beskrivning<br /> ! Kan ej användas med<br /> ! Introducerad i API-version<br /> |-<br /> | data<br /> | Används för att hämta rådata för en mätpunkt specificerade med variabeln p.<br /> | graph, textfil<br /> | 1.16<br /> |-<br /> | textfil<br /> | Används för att hämta länk till textfil med rådata för en mätpunkt specificerade med variabeln p. Ange parameter graddagar, dygnsmedel eller timmedel (ex textfil=graddagar) för att specificera vilket format textfilen ska ha.<br /> | graph, data<br /> | 1.16<br /> |-<br /> | amm<br /> | Används för att hämta Average, Min & Max för upp till 5 (10 från v1.12) orter specificerade med variabeln p.<br /> | graph<br /> | 1.11<br /> |-<br /> | daily<br /> | Används för att hämta dygnsmedel samt lägsta och högsta temperatur per dygn. En mätpunkt specificerad med variabeln p.<br /> | graph<br /> | 1.15<br /> |-<br /> | span<br /> | Specificerar för vilket tidsperspektiv Average, Min & Max skall skapas. Giltiga värden är: 1day (standard), 1week, 1month, 1year.<br /> | start, end<br /> | 1.2<br /> |-<br /> | shift_g<br /> |Anger om daily skall visa äldre data. Exempel: om span är 1month och shift_g är 1 hämtas data för föregående månad. Standard är 0.<br /> | start, end<br /> | 1.15<br /> |-<br /> | start<br /> | Specificerar starttid för amm. Formatet är Y-m-d-H-i, ex 2011-01-30-12-31.<br /> | span<br /> | 1.11<br /> |-<br /> | end<br /> | Specificerar sluttid för amm. Formatet är Y-m-d-H-i, ex 2011-01-30-12-31. Standard är nuvarande tid<br /> | span<br /> | 1.11<br /> |}<br /> <br /> Parametrar som är relaterade till grafgenerering:<br /> {| border=1 class="wikitable"<br /> |-<br /> ! Parameter<br /> ! Beskrivning<br /> ! Kan ej användas med<br /> ! Introducerad i API-version<br /> |-<br /> | graph<br /> | Används för att generera en graf för upp till 5 orter specificerade med variabeln p. Anges variablen compare kommer orterna att läggas in i samma graf i stället för separata.<br /> | amm<br /> | 1.2<br /> |-<br /> | span<br /> | Specificerar för vilket tidsperspektiv grafer skall skapas. Giltiga värden är: 1day (standard), 1week, 1month, 1year.<br /> | start, end<br /> | 1.2<br /> |-<br /> | shift_g<br /> | Anger om grafen skall visa äldre data. Exempel: om span är 1day och shift_g är 1 visas en graf för igår, om shift_g är 2 visar grafen data för i förrgår etc. Standard är 0.<br /> | start, end<br /> | 1.5<br /> |-<br /> | start<br /> | Specificerar starttid för graph eller amm. Formatet är Y-m-d-H-i, ex 2011-01-30-12-31.<br /> | span, shift_g, history<br /> | 1.11<br /> |-<br /> | end<br /> | Specificerar sluttid för graph eller amm. Formatet är Y-m-d-H-i, ex 2011-01-30-12-31. Standard är nuvarande tid<br /> | span, shift_g, history<br /> | 1.11<br /> |-<br /> | history<br /> | Används för att i grafen lägga in föregående periods temperatur. Visas temperaturen för det senaste dygnet visas föregående 24h i en annan färg etc. Kan förklarliga skäl endast användas med variabeln graph.<br /> | start, end<br /> | 1.12<br /> |-<br /> | history_year<br /> | Används för att i grafen lägga in jämförelse med annat år. År anges med 4 siffror, ex 2013. Kan förklarliga skäl endast användas med variabeln graph.<br /> | start, end<br /> | 1.14<br /> |-<br /> | verbose_g<br /> | Visar min/max/medel/senaste värde i grafen. Visar även när data senast hämtades för den valda orten.<br /> |<br /> | 1.5<br /> |-<br /> | 1axis<br /> | Används för att endast visa temperaturskalan till vänster. Används med fördel i små grafer för att spara utrymme.<br /> |<br /> | 1.6<br /> |-<br /> | fontsize<br /> | Anger hur stor texten skall vara. Observera att värdet inte kan relateras till vanliga textstorlekar, du måste därför testa dig fram.<br /> |<br /> | 1.8<br /> |-<br /> | linewidth<br /> | Anger bredden på graflinjen. Giltiga värden 1 till 5. Även flyttal, ex 1.5, fungerar. Decimalkomma eller decimalpunkt spelar inte någon roll.<br /> |<br /> | 1.7<br /> |-<br /> | x<br /> | Specificerar hur bred grafen skall vara. Giltiga värden är 150-2500. 300 är standard.<br /> |<br /> | 1.2 (Tillåtna värden justerade i v 1.4,v 1.14)<br /> |-<br /> | y<br /> | Specificerar hur hög grafen skall vara. Giltiga värden är 125-2500. 200 är standard.<br /> |<br /> | 1.2 (Tillåtna värden justerade i v 1.4, v 1.14)<br /> |-<br /> | color<br /> | Anger vilken/vilka färger linjer i grafen skall ha, kommasepararead lista. Standard är #FF0000,#AADDAA,#FFCC00.<br /> |<br /> | 1.13<br /> |-<br /> | compare<br /> | Anger att order som skickats med p skall läggas in för jämförelse i samma graf. Om fler än tre orter anges måste även color definieras<br /> |<br /> | 1.13<br /> |}<br /> <br /> ==Beskrivning av returnerade fält==<br /> {| border=1 class="wikitable"<br /> |-<br /> ! Fält<br /> ! Beskrivning<br /> ! parameter som visar<br /> ! parameter som döljer<br /> ! Visas som standard<br /> ! Introducerad i API-version<br /> |-<br /> | <title><br /> | Mätpunktens namn på temperatur.nu<br /> | <br /> | <br /> | X<br /> | 1.0<br /> |-<br /> | <id><br /> | Mätpunktens id på temperatur.nu. Kan användas med parametern "p" för att hämta endast denna mätpunkts information<br /> |<br /> | simple<br /> | X<br /> | 1.0<br /> |-<br /> | <temp><br /> | Mätpunktens senaste temperatur. Om decimalkomma eller decimalpunkt skall användas styrs med parametern dc.<br /> |<br /> |<br /> | X<br /> | 1.0<br /> |-<br /> | <lat><br /> | Mätpunktens latitud i decimalt format. Om decimalkomma eller decimalpunkt skall användas styrs med parametern dc.<br /> | coordinates, verbose<br /> |<br /> |<br /> | 1.0<br /> |-<br /> | <lon><br /> | Mätpunktens longitud i decimalt format. Om decimalkomma eller decimalpunkt skall användas styrs med parametern dc.<br /> | coordinates, verbose<br /> |<br /> |<br /> | 1.0<br /> |-<br /> | <lastUpdate><br /> | Tidpunkt då informationen senast uppdaterades på temperatur.nu<br /> | verbose<br /> |<br /> |<br /> | 1.0<br /> |-<br /> | <kommun><br /> | Den kommun som mätpunkten ligger i.<br /> | verbose<br /> |<br /> |<br /> | 1.0<br /> |-<br /> | <lan><br /> | Det län som mätpunkten ligger i.<br /> | verbose<br /> |<br /> |<br /> | 1.0<br /> |-<br /> | <sourceInfo><br /> | En kort textsträng med information om vem som loggar temperaturen för mätpunkten<br /> | verbose<br /> |<br /> |<br /> | 1.8<br /> |-<br /> | <forutsattning><br /> | Textsträng med information om hur mätningarna sker - finns ej för alla mätpunkter och returernar om så är fallet ett tomt fält.<br /> | verbose<br /> |<br /> |<br /> | 1.16<br /> |-<br /> | <url><br /> | Url till mätpunktens temperatur och grafer på www.temperatur.nu<br /> | verbose<br /> |<br /> |<br /> | 1.0<br /> |-<br /> | <dist><br /> | Hur långt från de givna koordinaterna mätpunkten ligger. Enheten är kilometer. Om decimalkomma eller decimalpunkt skall användas styrs med parametern dc.<br /> | lat & lon<br /> | simple<br /> |<br /> | 1.0<br /> |-<br /> | <graph><br /> | Visar url till graph för orten. Observera att ny graf endast genereras när parametern graph används. Det går därför inte att lokalt cacha urlen i klienten. <br /> | graph (x, y, span, verbose_g, shift_g)<br /> |<br /> |<br /> | 1.2<br /> |-<br /> | <ClientVersion><br /> | Visar vilken den senaste släppta klientversionen är. Kan med fördel användas för att kontrollera om det finns någon uppdatering till klientmjukvaran.<br /> | version<br /> |<br /> |<br /> | 1.10<br /> |-<br /> | <ClientVersionSet><br /> | Visar status i samband med att informationen om klientversionen uppdaterats.<br /> | version_update<br /> |<br /> |<br /> | 1.10<br /> |-<br /> | <daily><br /> | Har underliggande fält <date>, <average>, <min>, <max> som representerar data för dygn angivet i fältet date. Dessa fält returneras när parametern daily används för att hämta statisk för flera dygn<br /> | daily, span, start, end, shift_g<br /> |<br /> |<br /> | 1.15<br /> |-<br /> | <ammRange><br /> | Visar för vilket tidsperspektiv amm (medel/min/max) har hämtats<br /> | amm, span, start, end, shift_g<br /> |<br /> |<br /> | 1.11<br /> |-<br /> | <average><br /> | Medeltemperatur i specificerat tidsperspektiv<br /> | amm, span, start, end, shift_g<br /> |<br /> |<br /> | 1.11<br /> |-<br /> | <min><br /> | Den minsta temperaturen i specificerat tidsperspektiv<br /> | amm, span, start, end, shift_g<br /> |<br /> |<br /> | 1.11<br /> |-<br /> | <minTime><br /> | Vid vilken tidpunkt <min> inträffade<br /> | amm, span, start, end, shift_g<br /> |<br /> |<br /> | 1.11<br /> |-<br /> | <max><br /> | Den högsta temperaturen i specificerat tidsperspektiv<br /> | amm, span, start, end, shift_g<br /> |<br /> |<br /> | 1.11<br /> |-<br /> | <maxTime><br /> | Vid vilken tidpunkt <max> inträffade<br /> | amm, span, start, end, shift_g<br /> |<br /> |<br /> | 1.11<br /> |-<br /> | <uptime><br /> | Mätpunktens upptid i % det senaste året<br /> | verbose<br /> |<br /> |<br /> | 1.16<br /> |-<br /> | <start><br /> | Tidpunkt när mätpunkten lades till på temperatur.nu<br /> | verbose<br /> |<br /> |<br /> | 1.16<br /> |-<br /> | <moh><br /> | Mätpunktens höjd över havsnivån (Meter above Sea Level)<br /> | verbose<br /> |<br /> |<br /> | 1.16<br /> |-<br /> | <rawdata><br /> | Temperaturdata i råformat. Varje rawdata-fält innehåller subfälten date, time, timestamp, temperatur<br /> | data<br /> |<br /> |<br /> | 1.16<br /> <br /> |}<br /> <br /> ==Exempel==<br /> <br /> Så här kan resultatet från en förfrågan på http://api.temperatur.nu/tnu_1.12.php?p=linkoping&verbose&cli=test_app se ut:<br /> <?xml version='1.0' encoding='iso-8859-1'?><br /> <rss version="2.0"><br /> <channel><br /> <title>Temperatur.nu API 1.12 - Din url är inte korrekt signerad, clientnyckeln kan tillfälligt blockeras - /tnu_1.12.php</title><br /> <link>http://wiki.temperatur.nu/index.php/Api</link><br /> <item><br /> <title>Linköping/Centrum</title><br /> <id>linkoping</id><br /> <temp>9.3</temp><br /> <lat>58.414297</lat><br /> <lon>15.628788</lon><br /> <lastUpdate>2011-11-24 08:51:25</lastUpdate><br /> <kommun>Linköping</kommun><br /> <lan>Östergötlands län</lan><br /> <sourceInfo>Temperaturdata från Stångå Hotell.</sourceInfo><br /> <url>http://www.temperatur.nu/linkoping.html</url><br /> </item><br /> </channel><br /> </rss><br /> <br /> <br /> Så här kan resultatet från en förfrågan på http://api.temperatur.nu/tnu_1.16.php?lat=58.376761&lon=15.562916&num=3&graph&cli=test_app2 se ut:<br /> <?xml version='1.0' encoding='utf-8'?><br /> <rss version="2.0"><br /> <channel><br /> <title>Temperatur.nu API 1.16 - Din url är inte korrekt signerad, clientnyckeln kan tillfälligt blockeras - /tnu_1.16.php</title><br /> <link>http://wiki.temperatur.nu/index.php/Api</link><br /> <item><br /> <title>Linköping/Slaka</title><br /> <id>slaka</id><br /> <temp>11.9</temp><br /> <dist>1.3</dist><br /> <graph>https://graph.temperatur.nu/graph/slaka-1day-300-200-0-0-0-1-8-n-0-n.png</graph><br /> </item><br /> <item><br /> <title>Linköping/Hagaberg</title><br /> <id>hagaberg</id><br /> <temp>12.1</temp><br /> <dist>3.7</dist><br /> <graph>https://graph.temperatur.nu/graph/hagaberg-1day-300-200-0-0-0-1-8-n-0-n.png</graph><br /> </item><br /> <item><br /> <title>Linköping/Valla</title><br /> <id>valla</id><br /> <temp>11.9</temp><br /> <dist>3.8</dist><br /> <graph>https://graph.temperatur.nu/graph/valla-1day-300-200-0-0-0-1-8-n-0-n.png</graph><br /> </item><br /> </channel><br /> </rss><br /> <br /> ==Signering av URLer==<br /> Förfrågningar till APIet kan signeras. Från och med version 1.11 är antalet osignerade förfrågningar begränsade till 20 per timma. Osignerade förfrågningar kommer i framtiden att begränsas för alla api-versioner. Skriver du en privat tillämpning kan du använda APIet utan att signera URLerna.<br /> <br /> Signeringen går till så här:<br /> <br /> 1. Skapa din url som vanligt.<br /> <br /> 2. Beräkna md5-/sha1-summan av urlen (utan http://) med "+clientnyckel" tillagd på slutet. Klientnyckel erhålls efter att ha mailat [mailto:support@temperatur.nu support@temperatur.nu]<br /> <br /> 3. I slutet av urlen lägger du sedan till &sign=md5-/sha1-summa<br /> <br /> I php kan det tex se ut så här om du har en signeringsnyckel för md5:<br /> $cli_key="XXXXXXXXXXXXXXXXXXXXXXXXX";<br /> $url="api.temperatur.nu/tnu_1.9.php?p=linkoping&cli=testapp"<br /> $sign=md5($url."+".$cli_key);<br /> $signed_url=$url."&sign=".$sign;<br /> <br /> I den returnerade xml-filen kan du i det första title-fältet se om förfrågan är korrekt signerad.<br /> <br /> [http://www.fileformat.info/tool/hash.htm?text= fileformat.info] är en mycket bra sida för att verifiera att de sha1-/md5-summor du tagit fram stämmer.<br /> <br /> ==Historik/ändringslogg==<br /> 2010-05-04 - Version 1.0<br /> Första releasen.<br /> <br /> 2010-05-13 - Version 1.1<br /> Variabeln cli tillagd.<br /> <br /> 2010-05-19 - Version 1.2<br /> Stöd för att hämta grafer<br /> <br /> 2010-06-09 - Version 1.3<br /> Bugfix som fixar en bugg introducerad i 1.2 (det gick inte att hämta alla orter genom att skippa variabeln p).<br /> <br /> 2010-08-04 - Version 1.4<br /> Värden för x och y justerade. Parametern cli krävs för att apiet skall returnera data.<br /> <br /> 2010-09-01 - Version 1.5<br /> Parametrar för att via mer info i grafen. Parametrar för att visa grafer för i går, förra veckan, 2 år sedan etc.<br /> <br /> 2010-09-01 - Version 1.6<br /> Parameter för att ange om 1 eller 2 y-axlar skall visas.<br /> <br /> 2010-11-22 - Version 1.7<br /> Möjlighet att välja hur tjock graflinjen skall vara.<br /> <br /> 2010-12-19 - Version 1.8<br /> CacheBust-funktion, möjlighet att ändra textstorlek samt information om vem som loggar temperaturen när verbose är specat.<br /> <br /> 2011-01-13 - Version 1.9<br /> Signeringsfunktion inlagd. Signeringsfunktionen kommer från mitten av 2011 krävas för alla tillämpningar och och kommer successivt att läggas in i alla versioner av apiet.<br /> <br /> 2011-01-17 - Version 1.10<br /> Möjlighet att via Apiet hantera informaion gällande den senaste tillgängliga klientversionen.<br /> <br /> 2011-01-30 - Version 1.11<br /> Mer flexibel specificering av tidsperspektiv för grafer. amm - möjlighet att hämta medel/min/max i ett valfritt tidsperspektiv, antalet osignerade accesser begränsat i denna version.<br /> <br /> 2011-10-08 - Version 1.12<br /> Variabeln history tillagd. Visar föregående periods temperatur i grafer.<br /> <br /> 2012-05-04 - Version 1.13<br /> Variablerna compare och color angivna, gör det möjligt att jämföra flera orter i samma graf samt helt styra vilka färger linjerna i graferna skall ha. color kan sättas även för vanliga grafer.<br /> <br /> 2013 - Version 1.14<br /> Parametern history_year som används för att jämföra data med tidigare år. Buggfixar<br /> <br /> 2014-01-26 - Version 1.15<br /> Parametern daily. Används för att hämta dygnsmedel i ett specificerat tidsspann.<br /> <br /> 2021-02-25 - Version 1.16<br /> Parametern json för att få ut data i json-format. Parametern data som används för att få ut data i råformat. Mer information returneras när parametern verbose används. Generell buggrättning<br /> <br /> [[Kategori:www.temperatur.nu]]<br /> [[Kategori:Mjukvara]]</div>

Elf98 https://wiki.temperatur.nu/index.php?title=Huvudsida&diff=774 Huvudsida 2021-03-01T12:39:25Z

<p>Elf98: /* Att komma igång */</p> <hr /> <div>__NOTOC__<br /> <span style="font-size:150%">Välkommen till wiki.temperatur.nu!</span><br /> Detta är den helt nya informationskanalen där information gällande temperatur.nu/m.nu kommer att samlas.<br /> <br /> Då det är ett Wiki-system kan vem som helst skapa ett konto och lägga upp nya sidor eller korrigera felaktig information på befintliga sidor.<br /> <br /> {{Multicol}}<br /> <br /> == Kategori:www.temperatur.nu ==<br /> [[Fil:temperatur_nu_logo.png|150px|länk=http://www.temperatur.nu|temperatur.nu logo]]<br /> <categorytree mode=pages>www.temperatur.nu</categorytree></div>

Elf98 https://wiki.temperatur.nu/index.php?title=Huvudsida&diff=773 Huvudsida 2021-03-01T12:39:00Z

<p>Elf98: /* Kategori:Mjukvara */</p> <hr /> <div>__NOTOC__<br /> <span style="font-size:150%">Välkommen till wiki.temperatur.nu!</span><br /> Detta är den helt nya informationskanalen där information gällande temperatur.nu/m.nu kommer att samlas.<br /> <br /> Då det är ett Wiki-system kan vem som helst skapa ett konto och lägga upp nya sidor eller korrigera felaktig information på befintliga sidor.<br /> <br /> {{Multicol}}<br /> <br /> == Kategori:www.temperatur.nu ==<br /> [[Fil:temperatur_nu_logo.png|150px|länk=http://www.temperatur.nu|temperatur.nu logo]]<br /> <categorytree mode=pages>www.temperatur.nu</categorytree><br /> <br /> == Att komma igång ==<br /> Vi kanske ska låta dessa länkar stå kvar ett tag, de är mycket användbara!<br /> <br /> * [http://meta.wikimedia.org/wiki/Help:Contents Användarmanualen]<br /> * [http://www.mediawiki.org/wiki/Manual:Configuration_settings Lista över konfigurationsinställningar]<br /> * [http://www.mediawiki.org/wiki/Manual:FAQ MediaWiki FAQ]<br /> * [https://lists.wikimedia.org/mailman/listinfo/mediawiki-announce MediaWiki release mail list]<br /> <br /> En exempelsida med mängder med olika formateringar:<br /> [http://sv.wikipedia.org/wiki/Svenska Wikipedia:Svenska]<br /> <br /> Lite genvägar för att snabbt kunna skapa kategoriserade sidor.<br /> [http://meta.wikimedia.org/wiki/Help:Category Information om Kategorier]<br /> {{Multicol-end}}</div>

Elf98 https://wiki.temperatur.nu/index.php?title=Huvudsida&diff=772 Huvudsida 2021-03-01T12:38:52Z

<p>Elf98: </p> <hr /> <div>__NOTOC__<br /> <span style="font-size:150%">Välkommen till wiki.temperatur.nu!</span><br /> Detta är den helt nya informationskanalen där information gällande temperatur.nu/m.nu kommer att samlas.<br /> <br /> Då det är ett Wiki-system kan vem som helst skapa ett konto och lägga upp nya sidor eller korrigera felaktig information på befintliga sidor.<br /> <br /> {{Multicol}}<br /> <br /> == Kategori:www.temperatur.nu ==<br /> [[Fil:temperatur_nu_logo.png|150px|länk=http://www.temperatur.nu|temperatur.nu logo]]<br /> <categorytree mode=pages>www.temperatur.nu</categorytree><br /> <br /> == Kategori:Mjukvara ==<br /> <categorytree mode=pages>Mjukvara</categorytree><br /> <br /> == Att komma igång ==<br /> Vi kanske ska låta dessa länkar stå kvar ett tag, de är mycket användbara!<br /> <br /> * [http://meta.wikimedia.org/wiki/Help:Contents Användarmanualen]<br /> * [http://www.mediawiki.org/wiki/Manual:Configuration_settings Lista över konfigurationsinställningar]<br /> * [http://www.mediawiki.org/wiki/Manual:FAQ MediaWiki FAQ]<br /> * [https://lists.wikimedia.org/mailman/listinfo/mediawiki-announce MediaWiki release mail list]<br /> <br /> En exempelsida med mängder med olika formateringar:<br /> [http://sv.wikipedia.org/wiki/Svenska Wikipedia:Svenska]<br /> <br /> Lite genvägar för att snabbt kunna skapa kategoriserade sidor.<br /> [http://meta.wikimedia.org/wiki/Help:Category Information om Kategorier]<br /> {{Multicol-end}}</div>

Elf98 https://wiki.temperatur.nu/index.php?title=Huvudsida&diff=771 Huvudsida 2021-03-01T12:38:17Z

<p>Elf98: </p> <hr /> <div>[[Fil:temperatur_nu_logo.png|150px|länk=http://www.temperatur.nu|temperatur.nu logo]]<br /> <br /> __NOTOC__<br /> <span style="font-size:150%">Välkommen till wiki.temperatur.nu!</span><br /> Detta är den helt nya informationskanalen där information gällande temperatur.nu/m.nu kommer att samlas.<br /> <br /> Då det är ett Wiki-system kan vem som helst skapa ett konto och lägga upp nya sidor eller korrigera felaktig information på befintliga sidor.<br /> <br /> {{Multicol}}<br /> <br /> == Kategori:www.temperatur.nu ==<br /> [[Fil:temperatur_nu_logo.png|150px|länk=http://www.temperatur.nu|temperatur.nu logo]]<br /> <categorytree mode=pages>www.temperatur.nu</categorytree><br /> <br /> == Kategori:Mjukvara ==<br /> <categorytree mode=pages>Mjukvara</categorytree><br /> <br /> == Att komma igång ==<br /> Vi kanske ska låta dessa länkar stå kvar ett tag, de är mycket användbara!<br /> <br /> * [http://meta.wikimedia.org/wiki/Help:Contents Användarmanualen]<br /> * [http://www.mediawiki.org/wiki/Manual:Configuration_settings Lista över konfigurationsinställningar]<br /> * [http://www.mediawiki.org/wiki/Manual:FAQ MediaWiki FAQ]<br /> * [https://lists.wikimedia.org/mailman/listinfo/mediawiki-announce MediaWiki release mail list]<br /> <br /> En exempelsida med mängder med olika formateringar:<br /> [http://sv.wikipedia.org/wiki/Svenska Wikipedia:Svenska]<br /> <br /> Lite genvägar för att snabbt kunna skapa kategoriserade sidor.<br /> [http://meta.wikimedia.org/wiki/Help:Category Information om Kategorier]<br /> {{Multicol-end}}</div>

Elf98 https://wiki.temperatur.nu/index.php?title=Huvudsida&diff=770 Huvudsida 2021-03-01T10:58:42Z

<p>Elf98: /* Kategori:Hårdvara */</p> <hr /> <div>[[Fil:m_nu_logo.png|160px|länk=http://www.m.nu|m.nu logo]] [[Fil:temperatur_nu_logo.png|150px|länk=http://www.temperatur.nu|temperatur.nu logo]]<br /> <br /> __NOTOC__<br /> <span style="font-size:150%">Välkommen till wiki.temperatur.nu!</span><br /> Detta är den helt nya informationskanalen där information gällande temperatur.nu/m.nu kommer att samlas.<br /> <br /> Då det är ett Wiki-system kan vem som helst skapa ett konto och lägga upp nya sidor eller korrigera felaktig information på befintliga sidor.<br /> <br /> {{Multicol}}<br /> <br /> == Kategori:www.temperatur.nu ==<br /> [[Fil:temperatur_nu_logo.png|150px|länk=http://www.temperatur.nu|temperatur.nu logo]]<br /> <categorytree mode=pages>www.temperatur.nu</categorytree><br /> <br /> == Kategori:Mjukvara ==<br /> <categorytree mode=pages>Mjukvara</categorytree><br /> <br /> == Att komma igång ==<br /> Vi kanske ska låta dessa länkar stå kvar ett tag, de är mycket användbara!<br /> <br /> * [http://meta.wikimedia.org/wiki/Help:Contents Användarmanualen]<br /> * [http://www.mediawiki.org/wiki/Manual:Configuration_settings Lista över konfigurationsinställningar]<br /> * [http://www.mediawiki.org/wiki/Manual:FAQ MediaWiki FAQ]<br /> * [https://lists.wikimedia.org/mailman/listinfo/mediawiki-announce MediaWiki release mail list]<br /> <br /> En exempelsida med mängder med olika formateringar:<br /> [http://sv.wikipedia.org/wiki/Svenska Wikipedia:Svenska]<br /> <br /> Lite genvägar för att snabbt kunna skapa kategoriserade sidor.<br /> [http://meta.wikimedia.org/wiki/Help:Category Information om Kategorier]<br /> {{Multicol-end}}</div>

Elf98 https://wiki.temperatur.nu/index.php?title=API&diff=766 API 2021-02-25T14:21:03Z

<p>Elf98: /* Exempel */</p> <hr /> <div>{| align="right"<br /> | __TOC__<br /> |}<br /> Det finns ett enkelt API för att hämta senaste temperaturerna från temperatur.nu.<br /> <br /> Aktuell API-version 1.16. <br /> <br /> Data returneras i XML-format eller json-format<br /> <br /> ==Support==<br /> För support på API-funktionen, använd [http://www.temperatur.nu/forum/forslag-feedback/diskusionstrad-for-api-funktionen-t1373.html Forumet på www.temperatur.nu].<br /> <br /> ==Villkor==<br /> *Mjukvaran skall skrivas på ett sådant sätt att APIet inte automatiskt belastas med samma fråga oftare än var femte minut från en enskild klient. Klientid som bryter mot detta villkor kan komma att blockeras. <br /> *Det måste mycket tydligt framgå att temperaturerna kommer från temperatur.nu.<br /> *Där så är möjligt skall temperaturerna vara länkar till temperatur.nu.<br /> *Temperatur.nus [[Logotype|logotype]] skall finnas i applikationen, gärna så den tydligt syns när programmet används. Om detta ej är möjligt kan logotypen placeras där inställningar för applikationen görs.<br /> *APIet får ej användas för att automatiskt samla in och lagra data längre än 24h.<br /> *I de fall applikationen kommer att kosta pengar för användaren krävs särskild överenskommelse med temperatur.nu. Kontakta [mailto:support@temperatur.nu support@temperatur.nu] för mer information.<br /> *Förfrågningar till APIet kan signeras, från och med version 1.11 är osignerade förfrågningar är begränsade till ca 20/timma per klientid. Denna begränsning kommer efter hand att läggas in även på de äldre versionerna. Maila [mailto:support@temperatur.nu support@temperatur.nu] för att att erhålla en signeringsnyckel för ditt klientid. När du ansöker om en signeringsnyckel måste du ange om du vill signera med sha1 eller md5. Läs mer om hur du signerar förfrågningarna längre ner på denna sida.<br /> *Du skall skriva en beskrivning av din mjukvara i denna Wiki. På så sätt kommer fler intresserade att hitta din applikation. Klienter som inte finns beskrivna i Wikin kan komma att blockeras. [[Mjukvaror_som_använder_APIet|Här finns en lista med kända klienter]]<br /> <br /> <br /> ==Kort beskrivning==<br /> APIet är tänkt att användas av de som skapar extern mjukvara, tex applikationer för Iphone och Android.<br /> Målet är att APIet skall vara lättförståeligt och lätt att använda - feedback från användarna är av stor vikt för att kunna utveckla APIet!<br /> <br /> ==Var finns APIet?==<br /> Du accessar APIet via http://api.temperatur.nu/tnu_1.<version>.php. ex: http://api.temperatur.nu/tnu_1.12.php<br /> <br /> ==Parametrar==<br /> Generellta parametrar<br /> <br /> {| border=1 class="wikitable"<br /> |-<br /> ! Parameter<br /> ! Beskrivning<br /> ! Kan ej användas med<br /> ! Introducerad i API-version<br /> |-<br /> | json<br /> | Om angiven returneras data i json-format i stället för xml<br /> | <br /> | 1.16<br /> |-<br /> | p<br /> | Anger för vilka orter data skall returneras - kommaseparerad lista. Utelämnas parametern returneras samtliga mätpunkter.<br /> | lat, lon, num<br /> | 1.0<br /> |-<br /> | dc<br /> | Anger om decimalkomma skall användas i stället för decimalpunkt i fälten <temperatur>, <lat>, <lon> och <dist>.<br /> |<br /> | 1.0<br /> |-<br /> | simple<br /> | Minimal output, returnerar endast <title>, <id> och <temp><br /> | verbose<br /> | 1.0<br /> |-<br /> | verbose<br /> | Returnerar alla fält för orten, se beskrivning nedan<br /> | simple<br /> | 1.0<br /> |-<br /> | coordinates<br /> | Visar koordinaterna för valda orter. Kan användas tillsammans med simple för att kunna positionera orter på en karta utan att behöva hämta alla fält.<br /> | verbose<br /> | 1.0<br /> |-<br /> | lat<br /> | Används tillsammans med lon och ev num. Det spelar inte någon roll om decimal- eller kommapunkt används. När dessa parametrar används returneras de num närmaste orterna, närmaste orten först.<br /> | p<br /> | 1.0<br /> |-<br /> | lon<br /> | Används tillsammans med lat och ev num. Det spelar inte någon roll om decimal- eller kommapunkt används. När dessa parametrar används returneras de num närmaste orterna, närmaste orten först..<br /> | p<br /> | 1.0<br /> |-<br /> | num<br /> | Används tillsammans med lat och lon. Anger hur många orter som skall returneras. Standard är 1 och max är 5 (10 från v 1.12).<br /> | p<br /> | 1.0<br /> |-<br /> | cb<br /> | CacheBust. Om denna parameter finns i urlen (&cb) kommer ett randomiserat värde att läggas till i slutet av graf-urlerna. Denna parameter kan användas för att se till att inte grafen cachas lokalt hos användaren eller i någon dåligt konfigurerad proxy mellan temperatur.nu och användaren.<br /> |<br /> | 1.8<br /> |-<br /> | cli <br /> | Skall användas för att identifiera vilken klient som hämtar data. Ex "cli=tnu_widget". Från mitten av 2011 kommer signering av urlerna krävas i kombination med cli. Läs mer längre ner.<br /> |<br /> | 1.1<br /> |-<br /> | sign<br /> | Skall APIet regelbundet måste URLerna signeras. Se information längre ner på denna sida.<br /> |<br /> | 1.0 (tillagd i efterhand)<br /> |}<br /> <br /> Parametrar som är relaterade till att hämta statistik<br /> {| border=1 class="wikitable"<br /> |-<br /> ! Parameter<br /> ! Beskrivning<br /> ! Kan ej användas med<br /> ! Introducerad i API-version<br /> |-<br /> | data<br /> | Används för att hämta rådata för en mätpunkt specificerade med variabeln p.<br /> | graph<br /> | 1.16<br /> |-<br /> | amm<br /> | Används för att hämta Average, Min & Max för upp till 5 (10 från v1.12) orter specificerade med variabeln p.<br /> | graph<br /> | 1.11<br /> |-<br /> | daily<br /> | Används för att hämta dygnsmedel samt lägsta och högsta temperatur per dygn. En mätpunkt specificerad med variabeln p.<br /> | graph<br /> | 1.15<br /> |-<br /> | span<br /> | Specificerar för vilket tidsperspektiv Average, Min & Max skall skapas. Giltiga värden är: 1day (standard), 1week, 1month, 1year.<br /> | start, end<br /> | 1.2<br /> |-<br /> | shift_g<br /> |Anger om daily skall visa äldre data. Exempel: om span är 1month och shift_g är 1 hämtas data för föregående månad. Standard är 0.<br /> | start, end<br /> | 1.15<br /> |-<br /> | start<br /> | Specificerar starttid för amm. Formatet är Y-m-d-H-i, ex 2011-01-30-12-31.<br /> | span<br /> | 1.11<br /> |-<br /> | end<br /> | Specificerar sluttid för amm. Formatet är Y-m-d-H-i, ex 2011-01-30-12-31. Standard är nuvarande tid<br /> | span<br /> | 1.11<br /> |}<br /> <br /> Parametrar som är relaterade till grafgenerering:<br /> {| border=1 class="wikitable"<br /> |-<br /> ! Parameter<br /> ! Beskrivning<br /> ! Kan ej användas med<br /> ! Introducerad i API-version<br /> |-<br /> | graph<br /> | Används för att generera en graf för upp till 5 orter specificerade med variabeln p. Anges variablen compare kommer orterna att läggas in i samma graf i stället för separata.<br /> | amm<br /> | 1.2<br /> |-<br /> | span<br /> | Specificerar för vilket tidsperspektiv grafer skall skapas. Giltiga värden är: 1day (standard), 1week, 1month, 1year.<br /> | start, end<br /> | 1.2<br /> |-<br /> | shift_g<br /> | Anger om grafen skall visa äldre data. Exempel: om span är 1day och shift_g är 1 visas en graf för igår, om shift_g är 2 visar grafen data för i förrgår etc. Standard är 0.<br /> | start, end<br /> | 1.5<br /> |-<br /> | start<br /> | Specificerar starttid för graph eller amm. Formatet är Y-m-d-H-i, ex 2011-01-30-12-31.<br /> | span, shift_g, history<br /> | 1.11<br /> |-<br /> | end<br /> | Specificerar sluttid för graph eller amm. Formatet är Y-m-d-H-i, ex 2011-01-30-12-31. Standard är nuvarande tid<br /> | span, shift_g, history<br /> | 1.11<br /> |-<br /> | history<br /> | Används för att i grafen lägga in föregående periods temperatur. Visas temperaturen för det senaste dygnet visas föregående 24h i en annan färg etc. Kan förklarliga skäl endast användas med variabeln graph.<br /> | start, end<br /> | 1.12<br /> |-<br /> | history_year<br /> | Används för att i grafen lägga in jämförelse med annat år. År anges med 4 siffror, ex 2013. Kan förklarliga skäl endast användas med variabeln graph.<br /> | start, end<br /> | 1.14<br /> |-<br /> | verbose_g<br /> | Visar min/max/medel/senaste värde i grafen. Visar även när data senast hämtades för den valda orten.<br /> |<br /> | 1.5<br /> |-<br /> | 1axis<br /> | Används för att endast visa temperaturskalan till vänster. Används med fördel i små grafer för att spara utrymme.<br /> |<br /> | 1.6<br /> |-<br /> | fontsize<br /> | Anger hur stor texten skall vara. Observera att värdet inte kan relateras till vanliga textstorlekar, du måste därför testa dig fram.<br /> |<br /> | 1.8<br /> |-<br /> | linewidth<br /> | Anger bredden på graflinjen. Giltiga värden 1 till 5. Även flyttal, ex 1.5, fungerar. Decimalkomma eller decimalpunkt spelar inte någon roll.<br /> |<br /> | 1.7<br /> |-<br /> | x<br /> | Specificerar hur bred grafen skall vara. Giltiga värden är 150-2500. 300 är standard.<br /> |<br /> | 1.2 (Tillåtna värden justerade i v 1.4,v 1.14)<br /> |-<br /> | y<br /> | Specificerar hur hög grafen skall vara. Giltiga värden är 125-2500. 200 är standard.<br /> |<br /> | 1.2 (Tillåtna värden justerade i v 1.4, v 1.14)<br /> |-<br /> | color<br /> | Anger vilken/vilka färger linjer i grafen skall ha, kommasepararead lista. Standard är #FF0000,#AADDAA,#FFCC00.<br /> |<br /> | 1.13<br /> |-<br /> | compare<br /> | Anger att order som skickats med p skall läggas in för jämförelse i samma graf. Om fler än tre orter anges måste även color definieras<br /> |<br /> | 1.13<br /> |}<br /> <br /> ==Beskrivning av returnerade fält==<br /> {| border=1 class="wikitable"<br /> |-<br /> ! Fält<br /> ! Beskrivning<br /> ! parameter som visar<br /> ! parameter som döljer<br /> ! Visas som standard<br /> ! Introducerad i API-version<br /> |-<br /> | <title><br /> | Mätpunktens namn på temperatur.nu<br /> | <br /> | <br /> | X<br /> | 1.0<br /> |-<br /> | <id><br /> | Mätpunktens id på temperatur.nu. Kan användas med parametern "p" för att hämta endast denna mätpunkts information<br /> |<br /> | simple<br /> | X<br /> | 1.0<br /> |-<br /> | <temp><br /> | Mätpunktens senaste temperatur. Om decimalkomma eller decimalpunkt skall användas styrs med parametern dc.<br /> |<br /> |<br /> | X<br /> | 1.0<br /> |-<br /> | <lat><br /> | Mätpunktens latitud i decimalt format. Om decimalkomma eller decimalpunkt skall användas styrs med parametern dc.<br /> | coordinates, verbose<br /> |<br /> |<br /> | 1.0<br /> |-<br /> | <lon><br /> | Mätpunktens longitud i decimalt format. Om decimalkomma eller decimalpunkt skall användas styrs med parametern dc.<br /> | coordinates, verbose<br /> |<br /> |<br /> | 1.0<br /> |-<br /> | <lastUpdate><br /> | Tidpunkt då informationen senast uppdaterades på temperatur.nu<br /> | verbose<br /> |<br /> |<br /> | 1.0<br /> |-<br /> | <kommun><br /> | Den kommun som mätpunkten ligger i.<br /> | verbose<br /> |<br /> |<br /> | 1.0<br /> |-<br /> | <lan><br /> | Det län som mätpunkten ligger i.<br /> | verbose<br /> |<br /> |<br /> | 1.0<br /> |-<br /> | <sourceInfo><br /> | En kort textsträng med information om vem som loggar temperaturen för mätpunkten<br /> | verbose<br /> |<br /> |<br /> | 1.8<br /> |-<br /> | <forutsattning><br /> | Textsträng med information om hur mätningarna sker - finns ej för alla mätpunkter och returernar om så är fallet ett tomt fält.<br /> | verbose<br /> |<br /> |<br /> | 1.16<br /> |-<br /> | <url><br /> | Url till mätpunktens temperatur och grafer på www.temperatur.nu<br /> | verbose<br /> |<br /> |<br /> | 1.0<br /> |-<br /> | <dist><br /> | Hur långt från de givna koordinaterna mätpunkten ligger. Enheten är kilometer. Om decimalkomma eller decimalpunkt skall användas styrs med parametern dc.<br /> | lat & lon<br /> | simple<br /> |<br /> | 1.0<br /> |-<br /> | <graph><br /> | Visar url till graph för orten. Observera att ny graf endast genereras när parametern graph används. Det går därför inte att lokalt cacha urlen i klienten. <br /> | graph (x, y, span, verbose_g, shift_g)<br /> |<br /> |<br /> | 1.2<br /> |-<br /> | <ClientVersion><br /> | Visar vilken den senaste släppta klientversionen är. Kan med fördel användas för att kontrollera om det finns någon uppdatering till klientmjukvaran.<br /> | version<br /> |<br /> |<br /> | 1.10<br /> |-<br /> | <ClientVersionSet><br /> | Visar status i samband med att informationen om klientversionen uppdaterats.<br /> | version_update<br /> |<br /> |<br /> | 1.10<br /> |-<br /> | <daily><br /> | Har underliggande fält <date>, <average>, <min>, <max> som representerar data för dygn angivet i fältet date. Dessa fält returneras när parametern daily används för att hämta statisk för flera dygn<br /> | daily, span, start, end, shift_g<br /> |<br /> |<br /> | 1.15<br /> |-<br /> | <ammRange><br /> | Visar för vilket tidsperspektiv amm (medel/min/max) har hämtats<br /> | amm, span, start, end, shift_g<br /> |<br /> |<br /> | 1.11<br /> |-<br /> | <average><br /> | Medeltemperatur i specificerat tidsperspektiv<br /> | amm, span, start, end, shift_g<br /> |<br /> |<br /> | 1.11<br /> |-<br /> | <min><br /> | Den minsta temperaturen i specificerat tidsperspektiv<br /> | amm, span, start, end, shift_g<br /> |<br /> |<br /> | 1.11<br /> |-<br /> | <minTime><br /> | Vid vilken tidpunkt <min> inträffade<br /> | amm, span, start, end, shift_g<br /> |<br /> |<br /> | 1.11<br /> |-<br /> | <max><br /> | Den högsta temperaturen i specificerat tidsperspektiv<br /> | amm, span, start, end, shift_g<br /> |<br /> |<br /> | 1.11<br /> |-<br /> | <maxTime><br /> | Vid vilken tidpunkt <max> inträffade<br /> | amm, span, start, end, shift_g<br /> |<br /> |<br /> | 1.11<br /> |-<br /> | <uptime><br /> | Mätpunktens upptid i % det senaste året<br /> | verbose<br /> |<br /> |<br /> | 1.16<br /> |-<br /> | <start><br /> | Tidpunkt när mätpunkten lades till på temperatur.nu<br /> | verbose<br /> |<br /> |<br /> | 1.16<br /> |-<br /> | <moh><br /> | Mätpunktens höjd över havsnivån (Meter above Sea Level)<br /> | verbose<br /> |<br /> |<br /> | 1.16<br /> |-<br /> | <rawdata><br /> | Temperaturdata i råformat. Varje rawdata-fält innehåller subfälten date, time, timestamp, temperatur<br /> | data<br /> |<br /> |<br /> | 1.16<br /> <br /> |}<br /> <br /> ==Exempel==<br /> <br /> Så här kan resultatet från en förfrågan på http://api.temperatur.nu/tnu_1.12.php?p=linkoping&verbose&cli=test_app se ut:<br /> <?xml version='1.0' encoding='iso-8859-1'?><br /> <rss version="2.0"><br /> <channel><br /> <title>Temperatur.nu API 1.12 - Din url är inte korrekt signerad, clientnyckeln kan tillfälligt blockeras - /tnu_1.12.php</title><br /> <link>http://wiki.temperatur.nu/index.php/Api</link><br /> <item><br /> <title>Linköping/Centrum</title><br /> <id>linkoping</id><br /> <temp>9.3</temp><br /> <lat>58.414297</lat><br /> <lon>15.628788</lon><br /> <lastUpdate>2011-11-24 08:51:25</lastUpdate><br /> <kommun>Linköping</kommun><br /> <lan>Östergötlands län</lan><br /> <sourceInfo>Temperaturdata från Stångå Hotell.</sourceInfo><br /> <url>http://www.temperatur.nu/linkoping.html</url><br /> </item><br /> </channel><br /> </rss><br /> <br /> <br /> Så här kan resultatet från en förfrågan på http://api.temperatur.nu/tnu_1.16.php?lat=58.376761&lon=15.562916&num=3&graph&cli=test_app2 se ut:<br /> <?xml version='1.0' encoding='utf-8'?><br /> <rss version="2.0"><br /> <channel><br /> <title>Temperatur.nu API 1.16 - Din url är inte korrekt signerad, clientnyckeln kan tillfälligt blockeras - /tnu_1.16.php</title><br /> <link>http://wiki.temperatur.nu/index.php/Api</link><br /> <item><br /> <title>Linköping/Slaka</title><br /> <id>slaka</id><br /> <temp>11.9</temp><br /> <dist>1.3</dist><br /> <graph>https://graph.temperatur.nu/graph/slaka-1day-300-200-0-0-0-1-8-n-0-n.png</graph><br /> </item><br /> <item><br /> <title>Linköping/Hagaberg</title><br /> <id>hagaberg</id><br /> <temp>12.1</temp><br /> <dist>3.7</dist><br /> <graph>https://graph.temperatur.nu/graph/hagaberg-1day-300-200-0-0-0-1-8-n-0-n.png</graph><br /> </item><br /> <item><br /> <title>Linköping/Valla</title><br /> <id>valla</id><br /> <temp>11.9</temp><br /> <dist>3.8</dist><br /> <graph>https://graph.temperatur.nu/graph/valla-1day-300-200-0-0-0-1-8-n-0-n.png</graph><br /> </item><br /> </channel><br /> </rss><br /> <br /> ==Signering av URLer==<br /> Förfrågningar till APIet kan signeras. Från och med version 1.11 är antalet osignerade förfrågningar begränsade till 20 per timma. Osignerade förfrågningar kommer i framtiden att begränsas för alla api-versioner. Skriver du en privat tillämpning kan du använda APIet utan att signera URLerna.<br /> <br /> Signeringen går till så här:<br /> <br /> 1. Skapa din url som vanligt.<br /> <br /> 2. Beräkna md5-/sha1-summan av urlen (utan http://) med "+clientnyckel" tillagd på slutet. Klientnyckel erhålls efter att ha mailat [mailto:support@temperatur.nu support@temperatur.nu]<br /> <br /> 3. I slutet av urlen lägger du sedan till &sign=md5-/sha1-summa<br /> <br /> I php kan det tex se ut så här om du har en signeringsnyckel för md5:<br /> $cli_key="XXXXXXXXXXXXXXXXXXXXXXXXX";<br /> $url="api.temperatur.nu/tnu_1.9.php?p=linkoping&cli=testapp"<br /> $sign=md5($url."+".$cli_key);<br /> $signed_url=$url."&sign=".$sign;<br /> <br /> I den returnerade xml-filen kan du i det första title-fältet se om förfrågan är korrekt signerad.<br /> <br /> [http://www.fileformat.info/tool/hash.htm?text= fileformat.info] är en mycket bra sida för att verifiera att de sha1-/md5-summor du tagit fram stämmer.<br /> <br /> ==Historik/ändringslogg==<br /> 2010-05-04 - Version 1.0<br /> Första releasen.<br /> <br /> 2010-05-13 - Version 1.1<br /> Variabeln cli tillagd.<br /> <br /> 2010-05-19 - Version 1.2<br /> Stöd för att hämta grafer<br /> <br /> 2010-06-09 - Version 1.3<br /> Bugfix som fixar en bugg introducerad i 1.2 (det gick inte att hämta alla orter genom att skippa variabeln p).<br /> <br /> 2010-08-04 - Version 1.4<br /> Värden för x och y justerade. Parametern cli krävs för att apiet skall returnera data.<br /> <br /> 2010-09-01 - Version 1.5<br /> Parametrar för att via mer info i grafen. Parametrar för att visa grafer för i går, förra veckan, 2 år sedan etc.<br /> <br /> 2010-09-01 - Version 1.6<br /> Parameter för att ange om 1 eller 2 y-axlar skall visas.<br /> <br /> 2010-11-22 - Version 1.7<br /> Möjlighet att välja hur tjock graflinjen skall vara.<br /> <br /> 2010-12-19 - Version 1.8<br /> CacheBust-funktion, möjlighet att ändra textstorlek samt information om vem som loggar temperaturen när verbose är specat.<br /> <br /> 2011-01-13 - Version 1.9<br /> Signeringsfunktion inlagd. Signeringsfunktionen kommer från mitten av 2011 krävas för alla tillämpningar och och kommer successivt att läggas in i alla versioner av apiet.<br /> <br /> 2011-01-17 - Version 1.10<br /> Möjlighet att via Apiet hantera informaion gällande den senaste tillgängliga klientversionen.<br /> <br /> 2011-01-30 - Version 1.11<br /> Mer flexibel specificering av tidsperspektiv för grafer. amm - möjlighet att hämta medel/min/max i ett valfritt tidsperspektiv, antalet osignerade accesser begränsat i denna version.<br /> <br /> 2011-10-08 - Version 1.12<br /> Variabeln history tillagd. Visar föregående periods temperatur i grafer.<br /> <br /> 2012-05-04 - Version 1.13<br /> Variablerna compare och color angivna, gör det möjligt att jämföra flera orter i samma graf samt helt styra vilka färger linjerna i graferna skall ha. color kan sättas även för vanliga grafer.<br /> <br /> 2013 - Version 1.14<br /> Parametern history_year som används för att jämföra data med tidigare år. Buggfixar<br /> <br /> 2014-01-26 - Version 1.15<br /> Parametern daily. Används för att hämta dygnsmedel i ett specificerat tidsspann.<br /> <br /> 2021-02-25 - Version 1.16<br /> Parametern json för att få ut data i json-format. Parametern data som används för att få ut data i råformat. Mer information returneras när parametern verbose används. Generell buggrättning<br /> <br /> [[Kategori:www.temperatur.nu]]<br /> [[Kategori:Mjukvara]]</div>

Elf98 https://wiki.temperatur.nu/index.php?title=API&diff=765 API 2021-02-25T14:12:17Z

<p>Elf98: /* Exempel */</p> <hr /> <div>{| align="right"<br /> | __TOC__<br /> |}<br /> Det finns ett enkelt API för att hämta senaste temperaturerna från temperatur.nu.<br /> <br /> Aktuell API-version 1.16. <br /> <br /> Data returneras i XML-format eller json-format<br /> <br /> ==Support==<br /> För support på API-funktionen, använd [http://www.temperatur.nu/forum/forslag-feedback/diskusionstrad-for-api-funktionen-t1373.html Forumet på www.temperatur.nu].<br /> <br /> ==Villkor==<br /> *Mjukvaran skall skrivas på ett sådant sätt att APIet inte automatiskt belastas med samma fråga oftare än var femte minut från en enskild klient. Klientid som bryter mot detta villkor kan komma att blockeras. <br /> *Det måste mycket tydligt framgå att temperaturerna kommer från temperatur.nu.<br /> *Där så är möjligt skall temperaturerna vara länkar till temperatur.nu.<br /> *Temperatur.nus [[Logotype|logotype]] skall finnas i applikationen, gärna så den tydligt syns när programmet används. Om detta ej är möjligt kan logotypen placeras där inställningar för applikationen görs.<br /> *APIet får ej användas för att automatiskt samla in och lagra data längre än 24h.<br /> *I de fall applikationen kommer att kosta pengar för användaren krävs särskild överenskommelse med temperatur.nu. Kontakta [mailto:support@temperatur.nu support@temperatur.nu] för mer information.<br /> *Förfrågningar till APIet kan signeras, från och med version 1.11 är osignerade förfrågningar är begränsade till ca 20/timma per klientid. Denna begränsning kommer efter hand att läggas in även på de äldre versionerna. Maila [mailto:support@temperatur.nu support@temperatur.nu] för att att erhålla en signeringsnyckel för ditt klientid. När du ansöker om en signeringsnyckel måste du ange om du vill signera med sha1 eller md5. Läs mer om hur du signerar förfrågningarna längre ner på denna sida.<br /> *Du skall skriva en beskrivning av din mjukvara i denna Wiki. På så sätt kommer fler intresserade att hitta din applikation. Klienter som inte finns beskrivna i Wikin kan komma att blockeras. [[Mjukvaror_som_använder_APIet|Här finns en lista med kända klienter]]<br /> <br /> <br /> ==Kort beskrivning==<br /> APIet är tänkt att användas av de som skapar extern mjukvara, tex applikationer för Iphone och Android.<br /> Målet är att APIet skall vara lättförståeligt och lätt att använda - feedback från användarna är av stor vikt för att kunna utveckla APIet!<br /> <br /> ==Var finns APIet?==<br /> Du accessar APIet via http://api.temperatur.nu/tnu_1.<version>.php. ex: http://api.temperatur.nu/tnu_1.12.php<br /> <br /> ==Parametrar==<br /> Generellta parametrar<br /> <br /> {| border=1 class="wikitable"<br /> |-<br /> ! Parameter<br /> ! Beskrivning<br /> ! Kan ej användas med<br /> ! Introducerad i API-version<br /> |-<br /> | json<br /> | Om angiven returneras data i json-format i stället för xml<br /> | <br /> | 1.16<br /> |-<br /> | p<br /> | Anger för vilka orter data skall returneras - kommaseparerad lista. Utelämnas parametern returneras samtliga mätpunkter.<br /> | lat, lon, num<br /> | 1.0<br /> |-<br /> | dc<br /> | Anger om decimalkomma skall användas i stället för decimalpunkt i fälten <temperatur>, <lat>, <lon> och <dist>.<br /> |<br /> | 1.0<br /> |-<br /> | simple<br /> | Minimal output, returnerar endast <title>, <id> och <temp><br /> | verbose<br /> | 1.0<br /> |-<br /> | verbose<br /> | Returnerar alla fält för orten, se beskrivning nedan<br /> | simple<br /> | 1.0<br /> |-<br /> | coordinates<br /> | Visar koordinaterna för valda orter. Kan användas tillsammans med simple för att kunna positionera orter på en karta utan att behöva hämta alla fält.<br /> | verbose<br /> | 1.0<br /> |-<br /> | lat<br /> | Används tillsammans med lon och ev num. Det spelar inte någon roll om decimal- eller kommapunkt används. När dessa parametrar används returneras de num närmaste orterna, närmaste orten först.<br /> | p<br /> | 1.0<br /> |-<br /> | lon<br /> | Används tillsammans med lat och ev num. Det spelar inte någon roll om decimal- eller kommapunkt används. När dessa parametrar används returneras de num närmaste orterna, närmaste orten först..<br /> | p<br /> | 1.0<br /> |-<br /> | num<br /> | Används tillsammans med lat och lon. Anger hur många orter som skall returneras. Standard är 1 och max är 5 (10 från v 1.12).<br /> | p<br /> | 1.0<br /> |-<br /> | cb<br /> | CacheBust. Om denna parameter finns i urlen (&cb) kommer ett randomiserat värde att läggas till i slutet av graf-urlerna. Denna parameter kan användas för att se till att inte grafen cachas lokalt hos användaren eller i någon dåligt konfigurerad proxy mellan temperatur.nu och användaren.<br /> |<br /> | 1.8<br /> |-<br /> | cli <br /> | Skall användas för att identifiera vilken klient som hämtar data. Ex "cli=tnu_widget". Från mitten av 2011 kommer signering av urlerna krävas i kombination med cli. Läs mer längre ner.<br /> |<br /> | 1.1<br /> |-<br /> | sign<br /> | Skall APIet regelbundet måste URLerna signeras. Se information längre ner på denna sida.<br /> |<br /> | 1.0 (tillagd i efterhand)<br /> |}<br /> <br /> Parametrar som är relaterade till att hämta statistik<br /> {| border=1 class="wikitable"<br /> |-<br /> ! Parameter<br /> ! Beskrivning<br /> ! Kan ej användas med<br /> ! Introducerad i API-version<br /> |-<br /> | data<br /> | Används för att hämta rådata för en mätpunkt specificerade med variabeln p.<br /> | graph<br /> | 1.16<br /> |-<br /> | amm<br /> | Används för att hämta Average, Min & Max för upp till 5 (10 från v1.12) orter specificerade med variabeln p.<br /> | graph<br /> | 1.11<br /> |-<br /> | daily<br /> | Används för att hämta dygnsmedel samt lägsta och högsta temperatur per dygn. En mätpunkt specificerad med variabeln p.<br /> | graph<br /> | 1.15<br /> |-<br /> | span<br /> | Specificerar för vilket tidsperspektiv Average, Min & Max skall skapas. Giltiga värden är: 1day (standard), 1week, 1month, 1year.<br /> | start, end<br /> | 1.2<br /> |-<br /> | shift_g<br /> |Anger om daily skall visa äldre data. Exempel: om span är 1month och shift_g är 1 hämtas data för föregående månad. Standard är 0.<br /> | start, end<br /> | 1.15<br /> |-<br /> | start<br /> | Specificerar starttid för amm. Formatet är Y-m-d-H-i, ex 2011-01-30-12-31.<br /> | span<br /> | 1.11<br /> |-<br /> | end<br /> | Specificerar sluttid för amm. Formatet är Y-m-d-H-i, ex 2011-01-30-12-31. Standard är nuvarande tid<br /> | span<br /> | 1.11<br /> |}<br /> <br /> Parametrar som är relaterade till grafgenerering:<br /> {| border=1 class="wikitable"<br /> |-<br /> ! Parameter<br /> ! Beskrivning<br /> ! Kan ej användas med<br /> ! Introducerad i API-version<br /> |-<br /> | graph<br /> | Används för att generera en graf för upp till 5 orter specificerade med variabeln p. Anges variablen compare kommer orterna att läggas in i samma graf i stället för separata.<br /> | amm<br /> | 1.2<br /> |-<br /> | span<br /> | Specificerar för vilket tidsperspektiv grafer skall skapas. Giltiga värden är: 1day (standard), 1week, 1month, 1year.<br /> | start, end<br /> | 1.2<br /> |-<br /> | shift_g<br /> | Anger om grafen skall visa äldre data. Exempel: om span är 1day och shift_g är 1 visas en graf för igår, om shift_g är 2 visar grafen data för i förrgår etc. Standard är 0.<br /> | start, end<br /> | 1.5<br /> |-<br /> | start<br /> | Specificerar starttid för graph eller amm. Formatet är Y-m-d-H-i, ex 2011-01-30-12-31.<br /> | span, shift_g, history<br /> | 1.11<br /> |-<br /> | end<br /> | Specificerar sluttid för graph eller amm. Formatet är Y-m-d-H-i, ex 2011-01-30-12-31. Standard är nuvarande tid<br /> | span, shift_g, history<br /> | 1.11<br /> |-<br /> | history<br /> | Används för att i grafen lägga in föregående periods temperatur. Visas temperaturen för det senaste dygnet visas föregående 24h i en annan färg etc. Kan förklarliga skäl endast användas med variabeln graph.<br /> | start, end<br /> | 1.12<br /> |-<br /> | history_year<br /> | Används för att i grafen lägga in jämförelse med annat år. År anges med 4 siffror, ex 2013. Kan förklarliga skäl endast användas med variabeln graph.<br /> | start, end<br /> | 1.14<br /> |-<br /> | verbose_g<br /> | Visar min/max/medel/senaste värde i grafen. Visar även när data senast hämtades för den valda orten.<br /> |<br /> | 1.5<br /> |-<br /> | 1axis<br /> | Används för att endast visa temperaturskalan till vänster. Används med fördel i små grafer för att spara utrymme.<br /> |<br /> | 1.6<br /> |-<br /> | fontsize<br /> | Anger hur stor texten skall vara. Observera att värdet inte kan relateras till vanliga textstorlekar, du måste därför testa dig fram.<br /> |<br /> | 1.8<br /> |-<br /> | linewidth<br /> | Anger bredden på graflinjen. Giltiga värden 1 till 5. Även flyttal, ex 1.5, fungerar. Decimalkomma eller decimalpunkt spelar inte någon roll.<br /> |<br /> | 1.7<br /> |-<br /> | x<br /> | Specificerar hur bred grafen skall vara. Giltiga värden är 150-2500. 300 är standard.<br /> |<br /> | 1.2 (Tillåtna värden justerade i v 1.4,v 1.14)<br /> |-<br /> | y<br /> | Specificerar hur hög grafen skall vara. Giltiga värden är 125-2500. 200 är standard.<br /> |<br /> | 1.2 (Tillåtna värden justerade i v 1.4, v 1.14)<br /> |-<br /> | color<br /> | Anger vilken/vilka färger linjer i grafen skall ha, kommasepararead lista. Standard är #FF0000,#AADDAA,#FFCC00.<br /> |<br /> | 1.13<br /> |-<br /> | compare<br /> | Anger att order som skickats med p skall läggas in för jämförelse i samma graf. Om fler än tre orter anges måste även color definieras<br /> |<br /> | 1.13<br /> |}<br /> <br /> ==Beskrivning av returnerade fält==<br /> {| border=1 class="wikitable"<br /> |-<br /> ! Fält<br /> ! Beskrivning<br /> ! parameter som visar<br /> ! parameter som döljer<br /> ! Visas som standard<br /> ! Introducerad i API-version<br /> |-<br /> | <title><br /> | Mätpunktens namn på temperatur.nu<br /> | <br /> | <br /> | X<br /> | 1.0<br /> |-<br /> | <id><br /> | Mätpunktens id på temperatur.nu. Kan användas med parametern "p" för att hämta endast denna mätpunkts information<br /> |<br /> | simple<br /> | X<br /> | 1.0<br /> |-<br /> | <temp><br /> | Mätpunktens senaste temperatur. Om decimalkomma eller decimalpunkt skall användas styrs med parametern dc.<br /> |<br /> |<br /> | X<br /> | 1.0<br /> |-<br /> | <lat><br /> | Mätpunktens latitud i decimalt format. Om decimalkomma eller decimalpunkt skall användas styrs med parametern dc.<br /> | coordinates, verbose<br /> |<br /> |<br /> | 1.0<br /> |-<br /> | <lon><br /> | Mätpunktens longitud i decimalt format. Om decimalkomma eller decimalpunkt skall användas styrs med parametern dc.<br /> | coordinates, verbose<br /> |<br /> |<br /> | 1.0<br /> |-<br /> | <lastUpdate><br /> | Tidpunkt då informationen senast uppdaterades på temperatur.nu<br /> | verbose<br /> |<br /> |<br /> | 1.0<br /> |-<br /> | <kommun><br /> | Den kommun som mätpunkten ligger i.<br /> | verbose<br /> |<br /> |<br /> | 1.0<br /> |-<br /> | <lan><br /> | Det län som mätpunkten ligger i.<br /> | verbose<br /> |<br /> |<br /> | 1.0<br /> |-<br /> | <sourceInfo><br /> | En kort textsträng med information om vem som loggar temperaturen för mätpunkten<br /> | verbose<br /> |<br /> |<br /> | 1.8<br /> |-<br /> | <forutsattning><br /> | Textsträng med information om hur mätningarna sker - finns ej för alla mätpunkter och returernar om så är fallet ett tomt fält.<br /> | verbose<br /> |<br /> |<br /> | 1.16<br /> |-<br /> | <url><br /> | Url till mätpunktens temperatur och grafer på www.temperatur.nu<br /> | verbose<br /> |<br /> |<br /> | 1.0<br /> |-<br /> | <dist><br /> | Hur långt från de givna koordinaterna mätpunkten ligger. Enheten är kilometer. Om decimalkomma eller decimalpunkt skall användas styrs med parametern dc.<br /> | lat & lon<br /> | simple<br /> |<br /> | 1.0<br /> |-<br /> | <graph><br /> | Visar url till graph för orten. Observera att ny graf endast genereras när parametern graph används. Det går därför inte att lokalt cacha urlen i klienten. <br /> | graph (x, y, span, verbose_g, shift_g)<br /> |<br /> |<br /> | 1.2<br /> |-<br /> | <ClientVersion><br /> | Visar vilken den senaste släppta klientversionen är. Kan med fördel användas för att kontrollera om det finns någon uppdatering till klientmjukvaran.<br /> | version<br /> |<br /> |<br /> | 1.10<br /> |-<br /> | <ClientVersionSet><br /> | Visar status i samband med att informationen om klientversionen uppdaterats.<br /> | version_update<br /> |<br /> |<br /> | 1.10<br /> |-<br /> | <daily><br /> | Har underliggande fält <date>, <average>, <min>, <max> som representerar data för dygn angivet i fältet date. Dessa fält returneras när parametern daily används för att hämta statisk för flera dygn<br /> | daily, span, start, end, shift_g<br /> |<br /> |<br /> | 1.15<br /> |-<br /> | <ammRange><br /> | Visar för vilket tidsperspektiv amm (medel/min/max) har hämtats<br /> | amm, span, start, end, shift_g<br /> |<br /> |<br /> | 1.11<br /> |-<br /> | <average><br /> | Medeltemperatur i specificerat tidsperspektiv<br /> | amm, span, start, end, shift_g<br /> |<br /> |<br /> | 1.11<br /> |-<br /> | <min><br /> | Den minsta temperaturen i specificerat tidsperspektiv<br /> | amm, span, start, end, shift_g<br /> |<br /> |<br /> | 1.11<br /> |-<br /> | <minTime><br /> | Vid vilken tidpunkt <min> inträffade<br /> | amm, span, start, end, shift_g<br /> |<br /> |<br /> | 1.11<br /> |-<br /> | <max><br /> | Den högsta temperaturen i specificerat tidsperspektiv<br /> | amm, span, start, end, shift_g<br /> |<br /> |<br /> | 1.11<br /> |-<br /> | <maxTime><br /> | Vid vilken tidpunkt <max> inträffade<br /> | amm, span, start, end, shift_g<br /> |<br /> |<br /> | 1.11<br /> |-<br /> | <uptime><br /> | Mätpunktens upptid i % det senaste året<br /> | verbose<br /> |<br /> |<br /> | 1.16<br /> |-<br /> | <start><br /> | Tidpunkt när mätpunkten lades till på temperatur.nu<br /> | verbose<br /> |<br /> |<br /> | 1.16<br /> |-<br /> | <moh><br /> | Mätpunktens höjd över havsnivån (Meter above Sea Level)<br /> | verbose<br /> |<br /> |<br /> | 1.16<br /> |-<br /> | <rawdata><br /> | Temperaturdata i råformat. Varje rawdata-fält innehåller subfälten date, time, timestamp, temperatur<br /> | data<br /> |<br /> |<br /> | 1.16<br /> <br /> |}<br /> <br /> ==Exempel==<br /> <br /> Så här kan resultatet från en förfrågan på http://api.temperatur.nu/tnu_1.12.php?p=linkoping&verbose&cli=test_app se ut:<br /> <?xml version='1.0' encoding='iso-8859-1'?><br /> <rss version="2.0"><br /> <channel><br /> <title>Temperatur.nu API 1.12 - Din url är inte korrekt signerad, clientnyckeln kan tillfälligt blockeras - /tnu_1.12.php</title><br /> <link>http://wiki.temperatur.nu/index.php/Api</link><br /> <item><br /> <title>Linköping/Centrum</title><br /> <id>linkoping</id><br /> <temp>9.3</temp><br /> <lat>58.414297</lat><br /> <lon>15.628788</lon><br /> <lastUpdate>2011-11-24 08:51:25</lastUpdate><br /> <kommun>Linköping</kommun><br /> <lan>Östergötlands län</lan><br /> <sourceInfo>Temperaturdata från Stångå Hotell.</sourceInfo><br /> <url>http://www.temperatur.nu/linkoping.html</url><br /> </item><br /> </channel><br /> </rss><br /> <br /> <br /> Så här kan resultatet från en förfrågan på http://api.temperatur.nu/tnu_1.16.php?lat=58.376761&lon=15.562916&num=3&graph&cli=test_app2 se ut:<br /> <?xml version='1.0' encoding='utf-8'?><br /> <rss version="2.0"><br /> <channel><br /> <title>Temperatur.nu API 1.16 - Din url är inte korrekt signerad, clientnyckeln kan tillfälligt blockeras - /tnu_1.16.php</title><br /> <link>http://wiki.temperatur.nu/index.php/Api</link><br /> <item><br /> <title>Linköping/Slaka</title><br /> <id>slaka</id><br /> <temp>11.9</temp><br /> <dist>1.3</dist><br /> <graph>https://graph.temperatur.nu/graph/slaka-1day-300-200-0-0-0-1-8-n-0-n.png</graph><br /> </item><br /> <item><br /> <title>Linköping/Hagaberg</title><br /> <id>hagaberg</id><br /> <temp>12.1</temp><br /> <dist>3.7</dist><br /> <graph>https://graph.temperatur.nu/graph/hagaberg-1day-300-200-0-0-0-1-8-n-0-n.png</graph><br /> </item><br /> <item><br /> <title>Linköping/Valla</title><br /> <id>valla</id><br /> <temp>11.9</temp><br /> <dist>3.8</dist><br /> <graph>https://graph.temperatur.nu/graph/valla-1day-300-200-0-0-0-1-8-n-0-n.png</graph><br /> </item><br /> </channel><br /> </rss><br /> <br /> ==Signering av URLer==<br /> Förfrågningar till APIet kan signeras. Från och med version 1.11 är antalet osignerade förfrågningar begränsade till 20 per timma. Osignerade förfrågningar kommer i framtiden att begränsas för alla api-versioner. Skriver du en privat tillämpning kan du använda APIet utan att signera URLerna.<br /> <br /> Signeringen går till så här:<br /> <br /> 1. Skapa din url som vanligt.<br /> <br /> 2. Beräkna md5-/sha1-summan av urlen (utan http://) med "+clientnyckel" tillagd på slutet. Klientnyckel erhålls efter att ha mailat [mailto:support@temperatur.nu support@temperatur.nu]<br /> <br /> 3. I slutet av urlen lägger du sedan till &sign=md5-/sha1-summa<br /> <br /> I php kan det tex se ut så här om du har en signeringsnyckel för md5:<br /> $cli_key="XXXXXXXXXXXXXXXXXXXXXXXXX";<br /> $url="api.temperatur.nu/tnu_1.9.php?p=linkoping&cli=testapp"<br /> $sign=md5($url."+".$cli_key);<br /> $signed_url=$url."&sign=".$sign;<br /> <br /> I den returnerade xml-filen kan du i det första title-fältet se om förfrågan är korrekt signerad.<br /> <br /> [http://www.fileformat.info/tool/hash.htm?text= fileformat.info] är en mycket bra sida för att verifiera att de sha1-/md5-summor du tagit fram stämmer.<br /> <br /> ==Historik/ändringslogg==<br /> 2010-05-04 - Version 1.0<br /> Första releasen.<br /> <br /> 2010-05-13 - Version 1.1<br /> Variabeln cli tillagd.<br /> <br /> 2010-05-19 - Version 1.2<br /> Stöd för att hämta grafer<br /> <br /> 2010-06-09 - Version 1.3<br /> Bugfix som fixar en bugg introducerad i 1.2 (det gick inte att hämta alla orter genom att skippa variabeln p).<br /> <br /> 2010-08-04 - Version 1.4<br /> Värden för x och y justerade. Parametern cli krävs för att apiet skall returnera data.<br /> <br /> 2010-09-01 - Version 1.5<br /> Parametrar för att via mer info i grafen. Parametrar för att visa grafer för i går, förra veckan, 2 år sedan etc.<br /> <br /> 2010-09-01 - Version 1.6<br /> Parameter för att ange om 1 eller 2 y-axlar skall visas.<br /> <br /> 2010-11-22 - Version 1.7<br /> Möjlighet att välja hur tjock graflinjen skall vara.<br /> <br /> 2010-12-19 - Version 1.8<br /> CacheBust-funktion, möjlighet att ändra textstorlek samt information om vem som loggar temperaturen när verbose är specat.<br /> <br /> 2011-01-13 - Version 1.9<br /> Signeringsfunktion inlagd. Signeringsfunktionen kommer från mitten av 2011 krävas för alla tillämpningar och och kommer successivt att läggas in i alla versioner av apiet.<br /> <br /> 2011-01-17 - Version 1.10<br /> Möjlighet att via Apiet hantera informaion gällande den senaste tillgängliga klientversionen.<br /> <br /> 2011-01-30 - Version 1.11<br /> Mer flexibel specificering av tidsperspektiv för grafer. amm - möjlighet att hämta medel/min/max i ett valfritt tidsperspektiv, antalet osignerade accesser begränsat i denna version.<br /> <br /> 2011-10-08 - Version 1.12<br /> Variabeln history tillagd. Visar föregående periods temperatur i grafer.<br /> <br /> 2012-05-04 - Version 1.13<br /> Variablerna compare och color angivna, gör det möjligt att jämföra flera orter i samma graf samt helt styra vilka färger linjerna i graferna skall ha. color kan sättas även för vanliga grafer.<br /> <br /> 2013 - Version 1.14<br /> Parametern history_year som används för att jämföra data med tidigare år. Buggfixar<br /> <br /> 2014-01-26 - Version 1.15<br /> Parametern daily. Används för att hämta dygnsmedel i ett specificerat tidsspann.<br /> <br /> 2021-02-25 - Version 1.16<br /> Parametern json för att få ut data i json-format. Parametern data som används för att få ut data i råformat. Mer information returneras när parametern verbose används. Generell buggrättning<br /> <br /> [[Kategori:www.temperatur.nu]]<br /> [[Kategori:Mjukvara]]</div>

Elf98 https://wiki.temperatur.nu/index.php?title=API&diff=764 API 2021-02-25T14:11:53Z

<p>Elf98: /* Exempel */</p> <hr /> <div>{| align="right"<br /> | __TOC__<br /> |}<br /> Det finns ett enkelt API för att hämta senaste temperaturerna från temperatur.nu.<br /> <br /> Aktuell API-version 1.16. <br /> <br /> Data returneras i XML-format eller json-format<br /> <br /> ==Support==<br /> För support på API-funktionen, använd [http://www.temperatur.nu/forum/forslag-feedback/diskusionstrad-for-api-funktionen-t1373.html Forumet på www.temperatur.nu].<br /> <br /> ==Villkor==<br /> *Mjukvaran skall skrivas på ett sådant sätt att APIet inte automatiskt belastas med samma fråga oftare än var femte minut från en enskild klient. Klientid som bryter mot detta villkor kan komma att blockeras. <br /> *Det måste mycket tydligt framgå att temperaturerna kommer från temperatur.nu.<br /> *Där så är möjligt skall temperaturerna vara länkar till temperatur.nu.<br /> *Temperatur.nus [[Logotype|logotype]] skall finnas i applikationen, gärna så den tydligt syns när programmet används. Om detta ej är möjligt kan logotypen placeras där inställningar för applikationen görs.<br /> *APIet får ej användas för att automatiskt samla in och lagra data längre än 24h.<br /> *I de fall applikationen kommer att kosta pengar för användaren krävs särskild överenskommelse med temperatur.nu. Kontakta [mailto:support@temperatur.nu support@temperatur.nu] för mer information.<br /> *Förfrågningar till APIet kan signeras, från och med version 1.11 är osignerade förfrågningar är begränsade till ca 20/timma per klientid. Denna begränsning kommer efter hand att läggas in även på de äldre versionerna. Maila [mailto:support@temperatur.nu support@temperatur.nu] för att att erhålla en signeringsnyckel för ditt klientid. När du ansöker om en signeringsnyckel måste du ange om du vill signera med sha1 eller md5. Läs mer om hur du signerar förfrågningarna längre ner på denna sida.<br /> *Du skall skriva en beskrivning av din mjukvara i denna Wiki. På så sätt kommer fler intresserade att hitta din applikation. Klienter som inte finns beskrivna i Wikin kan komma att blockeras. [[Mjukvaror_som_använder_APIet|Här finns en lista med kända klienter]]<br /> <br /> <br /> ==Kort beskrivning==<br /> APIet är tänkt att användas av de som skapar extern mjukvara, tex applikationer för Iphone och Android.<br /> Målet är att APIet skall vara lättförståeligt och lätt att använda - feedback från användarna är av stor vikt för att kunna utveckla APIet!<br /> <br /> ==Var finns APIet?==<br /> Du accessar APIet via http://api.temperatur.nu/tnu_1.<version>.php. ex: http://api.temperatur.nu/tnu_1.12.php<br /> <br /> ==Parametrar==<br /> Generellta parametrar<br /> <br /> {| border=1 class="wikitable"<br /> |-<br /> ! Parameter<br /> ! Beskrivning<br /> ! Kan ej användas med<br /> ! Introducerad i API-version<br /> |-<br /> | json<br /> | Om angiven returneras data i json-format i stället för xml<br /> | <br /> | 1.16<br /> |-<br /> | p<br /> | Anger för vilka orter data skall returneras - kommaseparerad lista. Utelämnas parametern returneras samtliga mätpunkter.<br /> | lat, lon, num<br /> | 1.0<br /> |-<br /> | dc<br /> | Anger om decimalkomma skall användas i stället för decimalpunkt i fälten <temperatur>, <lat>, <lon> och <dist>.<br /> |<br /> | 1.0<br /> |-<br /> | simple<br /> | Minimal output, returnerar endast <title>, <id> och <temp><br /> | verbose<br /> | 1.0<br /> |-<br /> | verbose<br /> | Returnerar alla fält för orten, se beskrivning nedan<br /> | simple<br /> | 1.0<br /> |-<br /> | coordinates<br /> | Visar koordinaterna för valda orter. Kan användas tillsammans med simple för att kunna positionera orter på en karta utan att behöva hämta alla fält.<br /> | verbose<br /> | 1.0<br /> |-<br /> | lat<br /> | Används tillsammans med lon och ev num. Det spelar inte någon roll om decimal- eller kommapunkt används. När dessa parametrar används returneras de num närmaste orterna, närmaste orten först.<br /> | p<br /> | 1.0<br /> |-<br /> | lon<br /> | Används tillsammans med lat och ev num. Det spelar inte någon roll om decimal- eller kommapunkt används. När dessa parametrar används returneras de num närmaste orterna, närmaste orten först..<br /> | p<br /> | 1.0<br /> |-<br /> | num<br /> | Används tillsammans med lat och lon. Anger hur många orter som skall returneras. Standard är 1 och max är 5 (10 från v 1.12).<br /> | p<br /> | 1.0<br /> |-<br /> | cb<br /> | CacheBust. Om denna parameter finns i urlen (&cb) kommer ett randomiserat värde att läggas till i slutet av graf-urlerna. Denna parameter kan användas för att se till att inte grafen cachas lokalt hos användaren eller i någon dåligt konfigurerad proxy mellan temperatur.nu och användaren.<br /> |<br /> | 1.8<br /> |-<br /> | cli <br /> | Skall användas för att identifiera vilken klient som hämtar data. Ex "cli=tnu_widget". Från mitten av 2011 kommer signering av urlerna krävas i kombination med cli. Läs mer längre ner.<br /> |<br /> | 1.1<br /> |-<br /> | sign<br /> | Skall APIet regelbundet måste URLerna signeras. Se information längre ner på denna sida.<br /> |<br /> | 1.0 (tillagd i efterhand)<br /> |}<br /> <br /> Parametrar som är relaterade till att hämta statistik<br /> {| border=1 class="wikitable"<br /> |-<br /> ! Parameter<br /> ! Beskrivning<br /> ! Kan ej användas med<br /> ! Introducerad i API-version<br /> |-<br /> | data<br /> | Används för att hämta rådata för en mätpunkt specificerade med variabeln p.<br /> | graph<br /> | 1.16<br /> |-<br /> | amm<br /> | Används för att hämta Average, Min & Max för upp till 5 (10 från v1.12) orter specificerade med variabeln p.<br /> | graph<br /> | 1.11<br /> |-<br /> | daily<br /> | Används för att hämta dygnsmedel samt lägsta och högsta temperatur per dygn. En mätpunkt specificerad med variabeln p.<br /> | graph<br /> | 1.15<br /> |-<br /> | span<br /> | Specificerar för vilket tidsperspektiv Average, Min & Max skall skapas. Giltiga värden är: 1day (standard), 1week, 1month, 1year.<br /> | start, end<br /> | 1.2<br /> |-<br /> | shift_g<br /> |Anger om daily skall visa äldre data. Exempel: om span är 1month och shift_g är 1 hämtas data för föregående månad. Standard är 0.<br /> | start, end<br /> | 1.15<br /> |-<br /> | start<br /> | Specificerar starttid för amm. Formatet är Y-m-d-H-i, ex 2011-01-30-12-31.<br /> | span<br /> | 1.11<br /> |-<br /> | end<br /> | Specificerar sluttid för amm. Formatet är Y-m-d-H-i, ex 2011-01-30-12-31. Standard är nuvarande tid<br /> | span<br /> | 1.11<br /> |}<br /> <br /> Parametrar som är relaterade till grafgenerering:<br /> {| border=1 class="wikitable"<br /> |-<br /> ! Parameter<br /> ! Beskrivning<br /> ! Kan ej användas med<br /> ! Introducerad i API-version<br /> |-<br /> | graph<br /> | Används för att generera en graf för upp till 5 orter specificerade med variabeln p. Anges variablen compare kommer orterna att läggas in i samma graf i stället för separata.<br /> | amm<br /> | 1.2<br /> |-<br /> | span<br /> | Specificerar för vilket tidsperspektiv grafer skall skapas. Giltiga värden är: 1day (standard), 1week, 1month, 1year.<br /> | start, end<br /> | 1.2<br /> |-<br /> | shift_g<br /> | Anger om grafen skall visa äldre data. Exempel: om span är 1day och shift_g är 1 visas en graf för igår, om shift_g är 2 visar grafen data för i förrgår etc. Standard är 0.<br /> | start, end<br /> | 1.5<br /> |-<br /> | start<br /> | Specificerar starttid för graph eller amm. Formatet är Y-m-d-H-i, ex 2011-01-30-12-31.<br /> | span, shift_g, history<br /> | 1.11<br /> |-<br /> | end<br /> | Specificerar sluttid för graph eller amm. Formatet är Y-m-d-H-i, ex 2011-01-30-12-31. Standard är nuvarande tid<br /> | span, shift_g, history<br /> | 1.11<br /> |-<br /> | history<br /> | Används för att i grafen lägga in föregående periods temperatur. Visas temperaturen för det senaste dygnet visas föregående 24h i en annan färg etc. Kan förklarliga skäl endast användas med variabeln graph.<br /> | start, end<br /> | 1.12<br /> |-<br /> | history_year<br /> | Används för att i grafen lägga in jämförelse med annat år. År anges med 4 siffror, ex 2013. Kan förklarliga skäl endast användas med variabeln graph.<br /> | start, end<br /> | 1.14<br /> |-<br /> | verbose_g<br /> | Visar min/max/medel/senaste värde i grafen. Visar även när data senast hämtades för den valda orten.<br /> |<br /> | 1.5<br /> |-<br /> | 1axis<br /> | Används för att endast visa temperaturskalan till vänster. Används med fördel i små grafer för att spara utrymme.<br /> |<br /> | 1.6<br /> |-<br /> | fontsize<br /> | Anger hur stor texten skall vara. Observera att värdet inte kan relateras till vanliga textstorlekar, du måste därför testa dig fram.<br /> |<br /> | 1.8<br /> |-<br /> | linewidth<br /> | Anger bredden på graflinjen. Giltiga värden 1 till 5. Även flyttal, ex 1.5, fungerar. Decimalkomma eller decimalpunkt spelar inte någon roll.<br /> |<br /> | 1.7<br /> |-<br /> | x<br /> | Specificerar hur bred grafen skall vara. Giltiga värden är 150-2500. 300 är standard.<br /> |<br /> | 1.2 (Tillåtna värden justerade i v 1.4,v 1.14)<br /> |-<br /> | y<br /> | Specificerar hur hög grafen skall vara. Giltiga värden är 125-2500. 200 är standard.<br /> |<br /> | 1.2 (Tillåtna värden justerade i v 1.4, v 1.14)<br /> |-<br /> | color<br /> | Anger vilken/vilka färger linjer i grafen skall ha, kommasepararead lista. Standard är #FF0000,#AADDAA,#FFCC00.<br /> |<br /> | 1.13<br /> |-<br /> | compare<br /> | Anger att order som skickats med p skall läggas in för jämförelse i samma graf. Om fler än tre orter anges måste även color definieras<br /> |<br /> | 1.13<br /> |}<br /> <br /> ==Beskrivning av returnerade fält==<br /> {| border=1 class="wikitable"<br /> |-<br /> ! Fält<br /> ! Beskrivning<br /> ! parameter som visar<br /> ! parameter som döljer<br /> ! Visas som standard<br /> ! Introducerad i API-version<br /> |-<br /> | <title><br /> | Mätpunktens namn på temperatur.nu<br /> | <br /> | <br /> | X<br /> | 1.0<br /> |-<br /> | <id><br /> | Mätpunktens id på temperatur.nu. Kan användas med parametern "p" för att hämta endast denna mätpunkts information<br /> |<br /> | simple<br /> | X<br /> | 1.0<br /> |-<br /> | <temp><br /> | Mätpunktens senaste temperatur. Om decimalkomma eller decimalpunkt skall användas styrs med parametern dc.<br /> |<br /> |<br /> | X<br /> | 1.0<br /> |-<br /> | <lat><br /> | Mätpunktens latitud i decimalt format. Om decimalkomma eller decimalpunkt skall användas styrs med parametern dc.<br /> | coordinates, verbose<br /> |<br /> |<br /> | 1.0<br /> |-<br /> | <lon><br /> | Mätpunktens longitud i decimalt format. Om decimalkomma eller decimalpunkt skall användas styrs med parametern dc.<br /> | coordinates, verbose<br /> |<br /> |<br /> | 1.0<br /> |-<br /> | <lastUpdate><br /> | Tidpunkt då informationen senast uppdaterades på temperatur.nu<br /> | verbose<br /> |<br /> |<br /> | 1.0<br /> |-<br /> | <kommun><br /> | Den kommun som mätpunkten ligger i.<br /> | verbose<br /> |<br /> |<br /> | 1.0<br /> |-<br /> | <lan><br /> | Det län som mätpunkten ligger i.<br /> | verbose<br /> |<br /> |<br /> | 1.0<br /> |-<br /> | <sourceInfo><br /> | En kort textsträng med information om vem som loggar temperaturen för mätpunkten<br /> | verbose<br /> |<br /> |<br /> | 1.8<br /> |-<br /> | <forutsattning><br /> | Textsträng med information om hur mätningarna sker - finns ej för alla mätpunkter och returernar om så är fallet ett tomt fält.<br /> | verbose<br /> |<br /> |<br /> | 1.16<br /> |-<br /> | <url><br /> | Url till mätpunktens temperatur och grafer på www.temperatur.nu<br /> | verbose<br /> |<br /> |<br /> | 1.0<br /> |-<br /> | <dist><br /> | Hur långt från de givna koordinaterna mätpunkten ligger. Enheten är kilometer. Om decimalkomma eller decimalpunkt skall användas styrs med parametern dc.<br /> | lat & lon<br /> | simple<br /> |<br /> | 1.0<br /> |-<br /> | <graph><br /> | Visar url till graph för orten. Observera att ny graf endast genereras när parametern graph används. Det går därför inte att lokalt cacha urlen i klienten. <br /> | graph (x, y, span, verbose_g, shift_g)<br /> |<br /> |<br /> | 1.2<br /> |-<br /> | <ClientVersion><br /> | Visar vilken den senaste släppta klientversionen är. Kan med fördel användas för att kontrollera om det finns någon uppdatering till klientmjukvaran.<br /> | version<br /> |<br /> |<br /> | 1.10<br /> |-<br /> | <ClientVersionSet><br /> | Visar status i samband med att informationen om klientversionen uppdaterats.<br /> | version_update<br /> |<br /> |<br /> | 1.10<br /> |-<br /> | <daily><br /> | Har underliggande fält <date>, <average>, <min>, <max> som representerar data för dygn angivet i fältet date. Dessa fält returneras när parametern daily används för att hämta statisk för flera dygn<br /> | daily, span, start, end, shift_g<br /> |<br /> |<br /> | 1.15<br /> |-<br /> | <ammRange><br /> | Visar för vilket tidsperspektiv amm (medel/min/max) har hämtats<br /> | amm, span, start, end, shift_g<br /> |<br /> |<br /> | 1.11<br /> |-<br /> | <average><br /> | Medeltemperatur i specificerat tidsperspektiv<br /> | amm, span, start, end, shift_g<br /> |<br /> |<br /> | 1.11<br /> |-<br /> | <min><br /> | Den minsta temperaturen i specificerat tidsperspektiv<br /> | amm, span, start, end, shift_g<br /> |<br /> |<br /> | 1.11<br /> |-<br /> | <minTime><br /> | Vid vilken tidpunkt <min> inträffade<br /> | amm, span, start, end, shift_g<br /> |<br /> |<br /> | 1.11<br /> |-<br /> | <max><br /> | Den högsta temperaturen i specificerat tidsperspektiv<br /> | amm, span, start, end, shift_g<br /> |<br /> |<br /> | 1.11<br /> |-<br /> | <maxTime><br /> | Vid vilken tidpunkt <max> inträffade<br /> | amm, span, start, end, shift_g<br /> |<br /> |<br /> | 1.11<br /> |-<br /> | <uptime><br /> | Mätpunktens upptid i % det senaste året<br /> | verbose<br /> |<br /> |<br /> | 1.16<br /> |-<br /> | <start><br /> | Tidpunkt när mätpunkten lades till på temperatur.nu<br /> | verbose<br /> |<br /> |<br /> | 1.16<br /> |-<br /> | <moh><br /> | Mätpunktens höjd över havsnivån (Meter above Sea Level)<br /> | verbose<br /> |<br /> |<br /> | 1.16<br /> |-<br /> | <rawdata><br /> | Temperaturdata i råformat. Varje rawdata-fält innehåller subfälten date, time, timestamp, temperatur<br /> | data<br /> |<br /> |<br /> | 1.16<br /> <br /> |}<br /> <br /> ==Exempel==<br /> <br /> Så här kan resultatet från en förfrågan på http://api.temperatur.nu/tnu_1.12.php?p=linkoping&verbose&cli=test_app se ut:<br /> <?xml version='1.0' encoding='iso-8859-1'?><br /> <rss version="2.0"><br /> <channel><br /> <title>Temperatur.nu API 1.12 - Din url är inte korrekt signerad, clientnyckeln kan tillfälligt blockeras - /tnu_1.12.php</title><br /> <link>http://wiki.temperatur.nu/index.php/Api</link><br /> <item><br /> <title>Linköping/Centrum</title><br /> <id>linkoping</id><br /> <temp>9.3</temp><br /> <lat>58.414297</lat><br /> <lon>15.628788</lon><br /> <lastUpdate>2011-11-24 08:51:25</lastUpdate><br /> <kommun>Linköping</kommun><br /> <lan>Östergötlands län</lan><br /> <sourceInfo>Temperaturdata från Stångå Hotell.</sourceInfo><br /> <url>http://www.temperatur.nu/linkoping.html</url><br /> </item><br /> </channel><br /> </rss><br /> <br /> <br /> Så här kan resultatet från en förfrågan på http://api.temperatur.nu/tnu_1.16.php?lat=58.376761&lon=15.562916&num=3&graph&cli=test_app2 se ut:<br /> <?xml version='1.0' encoding='utf-8'?><br /> <rss version="2.0"><br /> <channel><br /> <title>Temperatur.nu API 1.16 - Din url är inte korrekt signerad, clientnyckeln kan tillfälligt blockeras - /tnu_1.16.php</title><br /> <link>http://wiki.temperatur.nu/index.php/Api</link><br /> <item><br /> <title>Linköping/Slaka</title><br /> <id>slaka</id><br /> <temp>11.9</temp><br /> <dist>1.3</dist><br /> <graph>https://graph.temperatur.nu/graph/slaka-1day-300-200-0-0-0-1-8-n-0-n.png</graph><br /> </item><br /> <item><br /> <title>Linköping/Hagaberg</title><br /> <id>hagaberg</id><br /> <temp>12.1</temp><br /> <dist>3.7</dist><br /> <graph>https://graph.temperatur.nu/graph/hagaberg-1day-300-200-0-0-0-1-8-n-0-n.png</graph><br /> </item><br /> <item><br /> <title>Linköping/Valla</title><br /> <id>valla</id><br /> <temp>11.9</temp><br /> <dist>3.8</dist><br /> <graph>https://graph.temperatur.nu/graph/valla-1day-300-200-0-0-0-1-8-n-0-n.png</graph><br /> </item><br /> </channel><br /> </rss><br /> <br /> ==Signering av URLer==<br /> Förfrågningar till APIet kan signeras. Från och med version 1.11 är antalet osignerade förfrågningar begränsade till 20 per timma. Osignerade förfrågningar kommer i framtiden att begränsas för alla api-versioner. Skriver du en privat tillämpning kan du använda APIet utan att signera URLerna.<br /> <br /> Signeringen går till så här:<br /> <br /> 1. Skapa din url som vanligt.<br /> <br /> 2. Beräkna md5-/sha1-summan av urlen (utan http://) med "+clientnyckel" tillagd på slutet. Klientnyckel erhålls efter att ha mailat [mailto:support@temperatur.nu support@temperatur.nu]<br /> <br /> 3. I slutet av urlen lägger du sedan till &sign=md5-/sha1-summa<br /> <br /> I php kan det tex se ut så här om du har en signeringsnyckel för md5:<br /> $cli_key="XXXXXXXXXXXXXXXXXXXXXXXXX";<br /> $url="api.temperatur.nu/tnu_1.9.php?p=linkoping&cli=testapp"<br /> $sign=md5($url."+".$cli_key);<br /> $signed_url=$url."&sign=".$sign;<br /> <br /> I den returnerade xml-filen kan du i det första title-fältet se om förfrågan är korrekt signerad.<br /> <br /> [http://www.fileformat.info/tool/hash.htm?text= fileformat.info] är en mycket bra sida för att verifiera att de sha1-/md5-summor du tagit fram stämmer.<br /> <br /> ==Historik/ändringslogg==<br /> 2010-05-04 - Version 1.0<br /> Första releasen.<br /> <br /> 2010-05-13 - Version 1.1<br /> Variabeln cli tillagd.<br /> <br /> 2010-05-19 - Version 1.2<br /> Stöd för att hämta grafer<br /> <br /> 2010-06-09 - Version 1.3<br /> Bugfix som fixar en bugg introducerad i 1.2 (det gick inte att hämta alla orter genom att skippa variabeln p).<br /> <br /> 2010-08-04 - Version 1.4<br /> Värden för x och y justerade. Parametern cli krävs för att apiet skall returnera data.<br /> <br /> 2010-09-01 - Version 1.5<br /> Parametrar för att via mer info i grafen. Parametrar för att visa grafer för i går, förra veckan, 2 år sedan etc.<br /> <br /> 2010-09-01 - Version 1.6<br /> Parameter för att ange om 1 eller 2 y-axlar skall visas.<br /> <br /> 2010-11-22 - Version 1.7<br /> Möjlighet att välja hur tjock graflinjen skall vara.<br /> <br /> 2010-12-19 - Version 1.8<br /> CacheBust-funktion, möjlighet att ändra textstorlek samt information om vem som loggar temperaturen när verbose är specat.<br /> <br /> 2011-01-13 - Version 1.9<br /> Signeringsfunktion inlagd. Signeringsfunktionen kommer från mitten av 2011 krävas för alla tillämpningar och och kommer successivt att läggas in i alla versioner av apiet.<br /> <br /> 2011-01-17 - Version 1.10<br /> Möjlighet att via Apiet hantera informaion gällande den senaste tillgängliga klientversionen.<br /> <br /> 2011-01-30 - Version 1.11<br /> Mer flexibel specificering av tidsperspektiv för grafer. amm - möjlighet att hämta medel/min/max i ett valfritt tidsperspektiv, antalet osignerade accesser begränsat i denna version.<br /> <br /> 2011-10-08 - Version 1.12<br /> Variabeln history tillagd. Visar föregående periods temperatur i grafer.<br /> <br /> 2012-05-04 - Version 1.13<br /> Variablerna compare och color angivna, gör det möjligt att jämföra flera orter i samma graf samt helt styra vilka färger linjerna i graferna skall ha. color kan sättas även för vanliga grafer.<br /> <br /> 2013 - Version 1.14<br /> Parametern history_year som används för att jämföra data med tidigare år. Buggfixar<br /> <br /> 2014-01-26 - Version 1.15<br /> Parametern daily. Används för att hämta dygnsmedel i ett specificerat tidsspann.<br /> <br /> 2021-02-25 - Version 1.16<br /> Parametern json för att få ut data i json-format. Parametern data som används för att få ut data i råformat. Mer information returneras när parametern verbose används. Generell buggrättning<br /> <br /> [[Kategori:www.temperatur.nu]]<br /> [[Kategori:Mjukvara]]</div>

Elf98 https://wiki.temperatur.nu/index.php?title=API&diff=763 API 2021-02-25T14:04:38Z

<p>Elf98: /* Historik/ändringslogg */</p> <hr /> <div>{| align="right"<br /> | __TOC__<br /> |}<br /> Det finns ett enkelt API för att hämta senaste temperaturerna från temperatur.nu.<br /> <br /> Aktuell API-version 1.16. <br /> <br /> Data returneras i XML-format eller json-format<br /> <br /> ==Support==<br /> För support på API-funktionen, använd [http://www.temperatur.nu/forum/forslag-feedback/diskusionstrad-for-api-funktionen-t1373.html Forumet på www.temperatur.nu].<br /> <br /> ==Villkor==<br /> *Mjukvaran skall skrivas på ett sådant sätt att APIet inte automatiskt belastas med samma fråga oftare än var femte minut från en enskild klient. Klientid som bryter mot detta villkor kan komma att blockeras. <br /> *Det måste mycket tydligt framgå att temperaturerna kommer från temperatur.nu.<br /> *Där så är möjligt skall temperaturerna vara länkar till temperatur.nu.<br /> *Temperatur.nus [[Logotype|logotype]] skall finnas i applikationen, gärna så den tydligt syns när programmet används. Om detta ej är möjligt kan logotypen placeras där inställningar för applikationen görs.<br /> *APIet får ej användas för att automatiskt samla in och lagra data längre än 24h.<br /> *I de fall applikationen kommer att kosta pengar för användaren krävs särskild överenskommelse med temperatur.nu. Kontakta [mailto:support@temperatur.nu support@temperatur.nu] för mer information.<br /> *Förfrågningar till APIet kan signeras, från och med version 1.11 är osignerade förfrågningar är begränsade till ca 20/timma per klientid. Denna begränsning kommer efter hand att läggas in även på de äldre versionerna. Maila [mailto:support@temperatur.nu support@temperatur.nu] för att att erhålla en signeringsnyckel för ditt klientid. När du ansöker om en signeringsnyckel måste du ange om du vill signera med sha1 eller md5. Läs mer om hur du signerar förfrågningarna längre ner på denna sida.<br /> *Du skall skriva en beskrivning av din mjukvara i denna Wiki. På så sätt kommer fler intresserade att hitta din applikation. Klienter som inte finns beskrivna i Wikin kan komma att blockeras. [[Mjukvaror_som_använder_APIet|Här finns en lista med kända klienter]]<br /> <br /> <br /> ==Kort beskrivning==<br /> APIet är tänkt att användas av de som skapar extern mjukvara, tex applikationer för Iphone och Android.<br /> Målet är att APIet skall vara lättförståeligt och lätt att använda - feedback från användarna är av stor vikt för att kunna utveckla APIet!<br /> <br /> ==Var finns APIet?==<br /> Du accessar APIet via http://api.temperatur.nu/tnu_1.<version>.php. ex: http://api.temperatur.nu/tnu_1.12.php<br /> <br /> ==Parametrar==<br /> Generellta parametrar<br /> <br /> {| border=1 class="wikitable"<br /> |-<br /> ! Parameter<br /> ! Beskrivning<br /> ! Kan ej användas med<br /> ! Introducerad i API-version<br /> |-<br /> | json<br /> | Om angiven returneras data i json-format i stället för xml<br /> | <br /> | 1.16<br /> |-<br /> | p<br /> | Anger för vilka orter data skall returneras - kommaseparerad lista. Utelämnas parametern returneras samtliga mätpunkter.<br /> | lat, lon, num<br /> | 1.0<br /> |-<br /> | dc<br /> | Anger om decimalkomma skall användas i stället för decimalpunkt i fälten <temperatur>, <lat>, <lon> och <dist>.<br /> |<br /> | 1.0<br /> |-<br /> | simple<br /> | Minimal output, returnerar endast <title>, <id> och <temp><br /> | verbose<br /> | 1.0<br /> |-<br /> | verbose<br /> | Returnerar alla fält för orten, se beskrivning nedan<br /> | simple<br /> | 1.0<br /> |-<br /> | coordinates<br /> | Visar koordinaterna för valda orter. Kan användas tillsammans med simple för att kunna positionera orter på en karta utan att behöva hämta alla fält.<br /> | verbose<br /> | 1.0<br /> |-<br /> | lat<br /> | Används tillsammans med lon och ev num. Det spelar inte någon roll om decimal- eller kommapunkt används. När dessa parametrar används returneras de num närmaste orterna, närmaste orten först.<br /> | p<br /> | 1.0<br /> |-<br /> | lon<br /> | Används tillsammans med lat och ev num. Det spelar inte någon roll om decimal- eller kommapunkt används. När dessa parametrar används returneras de num närmaste orterna, närmaste orten först..<br /> | p<br /> | 1.0<br /> |-<br /> | num<br /> | Används tillsammans med lat och lon. Anger hur många orter som skall returneras. Standard är 1 och max är 5 (10 från v 1.12).<br /> | p<br /> | 1.0<br /> |-<br /> | cb<br /> | CacheBust. Om denna parameter finns i urlen (&cb) kommer ett randomiserat värde att läggas till i slutet av graf-urlerna. Denna parameter kan användas för att se till att inte grafen cachas lokalt hos användaren eller i någon dåligt konfigurerad proxy mellan temperatur.nu och användaren.<br /> |<br /> | 1.8<br /> |-<br /> | cli <br /> | Skall användas för att identifiera vilken klient som hämtar data. Ex "cli=tnu_widget". Från mitten av 2011 kommer signering av urlerna krävas i kombination med cli. Läs mer längre ner.<br /> |<br /> | 1.1<br /> |-<br /> | sign<br /> | Skall APIet regelbundet måste URLerna signeras. Se information längre ner på denna sida.<br /> |<br /> | 1.0 (tillagd i efterhand)<br /> |}<br /> <br /> Parametrar som är relaterade till att hämta statistik<br /> {| border=1 class="wikitable"<br /> |-<br /> ! Parameter<br /> ! Beskrivning<br /> ! Kan ej användas med<br /> ! Introducerad i API-version<br /> |-<br /> | data<br /> | Används för att hämta rådata för en mätpunkt specificerade med variabeln p.<br /> | graph<br /> | 1.16<br /> |-<br /> | amm<br /> | Används för att hämta Average, Min & Max för upp till 5 (10 från v1.12) orter specificerade med variabeln p.<br /> | graph<br /> | 1.11<br /> |-<br /> | daily<br /> | Används för att hämta dygnsmedel samt lägsta och högsta temperatur per dygn. En mätpunkt specificerad med variabeln p.<br /> | graph<br /> | 1.15<br /> |-<br /> | span<br /> | Specificerar för vilket tidsperspektiv Average, Min & Max skall skapas. Giltiga värden är: 1day (standard), 1week, 1month, 1year.<br /> | start, end<br /> | 1.2<br /> |-<br /> | shift_g<br /> |Anger om daily skall visa äldre data. Exempel: om span är 1month och shift_g är 1 hämtas data för föregående månad. Standard är 0.<br /> | start, end<br /> | 1.15<br /> |-<br /> | start<br /> | Specificerar starttid för amm. Formatet är Y-m-d-H-i, ex 2011-01-30-12-31.<br /> | span<br /> | 1.11<br /> |-<br /> | end<br /> | Specificerar sluttid för amm. Formatet är Y-m-d-H-i, ex 2011-01-30-12-31. Standard är nuvarande tid<br /> | span<br /> | 1.11<br /> |}<br /> <br /> Parametrar som är relaterade till grafgenerering:<br /> {| border=1 class="wikitable"<br /> |-<br /> ! Parameter<br /> ! Beskrivning<br /> ! Kan ej användas med<br /> ! Introducerad i API-version<br /> |-<br /> | graph<br /> | Används för att generera en graf för upp till 5 orter specificerade med variabeln p. Anges variablen compare kommer orterna att läggas in i samma graf i stället för separata.<br /> | amm<br /> | 1.2<br /> |-<br /> | span<br /> | Specificerar för vilket tidsperspektiv grafer skall skapas. Giltiga värden är: 1day (standard), 1week, 1month, 1year.<br /> | start, end<br /> | 1.2<br /> |-<br /> | shift_g<br /> | Anger om grafen skall visa äldre data. Exempel: om span är 1day och shift_g är 1 visas en graf för igår, om shift_g är 2 visar grafen data för i förrgår etc. Standard är 0.<br /> | start, end<br /> | 1.5<br /> |-<br /> | start<br /> | Specificerar starttid för graph eller amm. Formatet är Y-m-d-H-i, ex 2011-01-30-12-31.<br /> | span, shift_g, history<br /> | 1.11<br /> |-<br /> | end<br /> | Specificerar sluttid för graph eller amm. Formatet är Y-m-d-H-i, ex 2011-01-30-12-31. Standard är nuvarande tid<br /> | span, shift_g, history<br /> | 1.11<br /> |-<br /> | history<br /> | Används för att i grafen lägga in föregående periods temperatur. Visas temperaturen för det senaste dygnet visas föregående 24h i en annan färg etc. Kan förklarliga skäl endast användas med variabeln graph.<br /> | start, end<br /> | 1.12<br /> |-<br /> | history_year<br /> | Används för att i grafen lägga in jämförelse med annat år. År anges med 4 siffror, ex 2013. Kan förklarliga skäl endast användas med variabeln graph.<br /> | start, end<br /> | 1.14<br /> |-<br /> | verbose_g<br /> | Visar min/max/medel/senaste värde i grafen. Visar även när data senast hämtades för den valda orten.<br /> |<br /> | 1.5<br /> |-<br /> | 1axis<br /> | Används för att endast visa temperaturskalan till vänster. Används med fördel i små grafer för att spara utrymme.<br /> |<br /> | 1.6<br /> |-<br /> | fontsize<br /> | Anger hur stor texten skall vara. Observera att värdet inte kan relateras till vanliga textstorlekar, du måste därför testa dig fram.<br /> |<br /> | 1.8<br /> |-<br /> | linewidth<br /> | Anger bredden på graflinjen. Giltiga värden 1 till 5. Även flyttal, ex 1.5, fungerar. Decimalkomma eller decimalpunkt spelar inte någon roll.<br /> |<br /> | 1.7<br /> |-<br /> | x<br /> | Specificerar hur bred grafen skall vara. Giltiga värden är 150-2500. 300 är standard.<br /> |<br /> | 1.2 (Tillåtna värden justerade i v 1.4,v 1.14)<br /> |-<br /> | y<br /> | Specificerar hur hög grafen skall vara. Giltiga värden är 125-2500. 200 är standard.<br /> |<br /> | 1.2 (Tillåtna värden justerade i v 1.4, v 1.14)<br /> |-<br /> | color<br /> | Anger vilken/vilka färger linjer i grafen skall ha, kommasepararead lista. Standard är #FF0000,#AADDAA,#FFCC00.<br /> |<br /> | 1.13<br /> |-<br /> | compare<br /> | Anger att order som skickats med p skall läggas in för jämförelse i samma graf. Om fler än tre orter anges måste även color definieras<br /> |<br /> | 1.13<br /> |}<br /> <br /> ==Beskrivning av returnerade fält==<br /> {| border=1 class="wikitable"<br /> |-<br /> ! Fält<br /> ! Beskrivning<br /> ! parameter som visar<br /> ! parameter som döljer<br /> ! Visas som standard<br /> ! Introducerad i API-version<br /> |-<br /> | <title><br /> | Mätpunktens namn på temperatur.nu<br /> | <br /> | <br /> | X<br /> | 1.0<br /> |-<br /> | <id><br /> | Mätpunktens id på temperatur.nu. Kan användas med parametern "p" för att hämta endast denna mätpunkts information<br /> |<br /> | simple<br /> | X<br /> | 1.0<br /> |-<br /> | <temp><br /> | Mätpunktens senaste temperatur. Om decimalkomma eller decimalpunkt skall användas styrs med parametern dc.<br /> |<br /> |<br /> | X<br /> | 1.0<br /> |-<br /> | <lat><br /> | Mätpunktens latitud i decimalt format. Om decimalkomma eller decimalpunkt skall användas styrs med parametern dc.<br /> | coordinates, verbose<br /> |<br /> |<br /> | 1.0<br /> |-<br /> | <lon><br /> | Mätpunktens longitud i decimalt format. Om decimalkomma eller decimalpunkt skall användas styrs med parametern dc.<br /> | coordinates, verbose<br /> |<br /> |<br /> | 1.0<br /> |-<br /> | <lastUpdate><br /> | Tidpunkt då informationen senast uppdaterades på temperatur.nu<br /> | verbose<br /> |<br /> |<br /> | 1.0<br /> |-<br /> | <kommun><br /> | Den kommun som mätpunkten ligger i.<br /> | verbose<br /> |<br /> |<br /> | 1.0<br /> |-<br /> | <lan><br /> | Det län som mätpunkten ligger i.<br /> | verbose<br /> |<br /> |<br /> | 1.0<br /> |-<br /> | <sourceInfo><br /> | En kort textsträng med information om vem som loggar temperaturen för mätpunkten<br /> | verbose<br /> |<br /> |<br /> | 1.8<br /> |-<br /> | <forutsattning><br /> | Textsträng med information om hur mätningarna sker - finns ej för alla mätpunkter och returernar om så är fallet ett tomt fält.<br /> | verbose<br /> |<br /> |<br /> | 1.16<br /> |-<br /> | <url><br /> | Url till mätpunktens temperatur och grafer på www.temperatur.nu<br /> | verbose<br /> |<br /> |<br /> | 1.0<br /> |-<br /> | <dist><br /> | Hur långt från de givna koordinaterna mätpunkten ligger. Enheten är kilometer. Om decimalkomma eller decimalpunkt skall användas styrs med parametern dc.<br /> | lat & lon<br /> | simple<br /> |<br /> | 1.0<br /> |-<br /> | <graph><br /> | Visar url till graph för orten. Observera att ny graf endast genereras när parametern graph används. Det går därför inte att lokalt cacha urlen i klienten. <br /> | graph (x, y, span, verbose_g, shift_g)<br /> |<br /> |<br /> | 1.2<br /> |-<br /> | <ClientVersion><br /> | Visar vilken den senaste släppta klientversionen är. Kan med fördel användas för att kontrollera om det finns någon uppdatering till klientmjukvaran.<br /> | version<br /> |<br /> |<br /> | 1.10<br /> |-<br /> | <ClientVersionSet><br /> | Visar status i samband med att informationen om klientversionen uppdaterats.<br /> | version_update<br /> |<br /> |<br /> | 1.10<br /> |-<br /> | <daily><br /> | Har underliggande fält <date>, <average>, <min>, <max> som representerar data för dygn angivet i fältet date. Dessa fält returneras när parametern daily används för att hämta statisk för flera dygn<br /> | daily, span, start, end, shift_g<br /> |<br /> |<br /> | 1.15<br /> |-<br /> | <ammRange><br /> | Visar för vilket tidsperspektiv amm (medel/min/max) har hämtats<br /> | amm, span, start, end, shift_g<br /> |<br /> |<br /> | 1.11<br /> |-<br /> | <average><br /> | Medeltemperatur i specificerat tidsperspektiv<br /> | amm, span, start, end, shift_g<br /> |<br /> |<br /> | 1.11<br /> |-<br /> | <min><br /> | Den minsta temperaturen i specificerat tidsperspektiv<br /> | amm, span, start, end, shift_g<br /> |<br /> |<br /> | 1.11<br /> |-<br /> | <minTime><br /> | Vid vilken tidpunkt <min> inträffade<br /> | amm, span, start, end, shift_g<br /> |<br /> |<br /> | 1.11<br /> |-<br /> | <max><br /> | Den högsta temperaturen i specificerat tidsperspektiv<br /> | amm, span, start, end, shift_g<br /> |<br /> |<br /> | 1.11<br /> |-<br /> | <maxTime><br /> | Vid vilken tidpunkt <max> inträffade<br /> | amm, span, start, end, shift_g<br /> |<br /> |<br /> | 1.11<br /> |-<br /> | <uptime><br /> | Mätpunktens upptid i % det senaste året<br /> | verbose<br /> |<br /> |<br /> | 1.16<br /> |-<br /> | <start><br /> | Tidpunkt när mätpunkten lades till på temperatur.nu<br /> | verbose<br /> |<br /> |<br /> | 1.16<br /> |-<br /> | <moh><br /> | Mätpunktens höjd över havsnivån (Meter above Sea Level)<br /> | verbose<br /> |<br /> |<br /> | 1.16<br /> |-<br /> | <rawdata><br /> | Temperaturdata i råformat. Varje rawdata-fält innehåller subfälten date, time, timestamp, temperatur<br /> | data<br /> |<br /> |<br /> | 1.16<br /> <br /> |}<br /> <br /> ==Exempel==<br /> <br /> Så här kan resultatet från en förfrågan på http://api.temperatur.nu/tnu_1.12.php?p=linkoping&verbose&cli=test_app se ut:<br /> <?xml version='1.0' encoding='iso-8859-1'?><br /> <rss version="2.0"><br /> <channel><br /> <title>Temperatur.nu API 1.12 - Din url är inte korrekt signerad, clientnyckeln kan tillfälligt blockeras - /tnu_1.12.php</title><br /> <link>http://wiki.temperatur.nu/index.php/Api</link><br /> <item><br /> <title>Linköping/Centrum</title><br /> <id>linkoping</id><br /> <temp>9.3</temp><br /> <lat>58.414297</lat><br /> <lon>15.628788</lon><br /> <lastUpdate>2011-11-24 08:51:25</lastUpdate><br /> <kommun>Linköping</kommun><br /> <lan>Östergötlands län</lan><br /> <sourceInfo>Temperaturdata från Stångå Hotell.</sourceInfo><br /> <url>http://www.temperatur.nu/linkoping.html</url><br /> </item><br /> </channel><br /> </rss><br /> <br /> <br /> Så här kan resultatet från en förfrågan på http://api.temperatur.nu/tnu_1.12.php?lat=58.376761&lon=15.562916&num=3&graph&cli=test_app2 se ut:<br /> <?xml version='1.0' encoding='iso-8859-1'?><br /> <rss version="2.0"><br /> <channel><br /> <title>Temperatur.nu API 1.12 - Din url är inte korrekt signerad, clientnyckeln kan tillfälligt blockeras - /tnu_1.12.php</title><br /> <link>http://wiki.temperatur.nu/index.php/Api</link><br /> <item><br /> <title>Linköping/Jägarvallen</title><br /> <id>jagarvallen</id><br /> <temp>7.8</temp><br /> <dist>2.5</dist><br /> <graph>http://www2.timg.nu/graph/jagarvallen-1day-300-200-0-0-0-1-8-n.png</graph><br /> </item><br /> <item><br /> <title>Linköping/Malmen (METAR)</title><br /> <id>malmen</id><br /> <temp>8.3</temp><br /> <dist>2.8</dist><br /> <graph>http://www2.timg.nu/graph/malmen-1day-300-200-0-0-0-1-8-n.png</graph><br /> </item><br /> <item><br /> <title>Linköping/Skäggetorp</title><br /> <id>skaggetorp</id><br /> <temp>9.1</temp><br /> <dist>5.2</dist><br /> <graph>http://www2.timg.nu/graph/skaggetorp-1day-300-200-0-0-0-1-8-n.png</graph><br /> </item><br /> </channel><br /> </rss><br /> <br /> <br /> ==Signering av URLer==<br /> Förfrågningar till APIet kan signeras. Från och med version 1.11 är antalet osignerade förfrågningar begränsade till 20 per timma. Osignerade förfrågningar kommer i framtiden att begränsas för alla api-versioner. Skriver du en privat tillämpning kan du använda APIet utan att signera URLerna.<br /> <br /> Signeringen går till så här:<br /> <br /> 1. Skapa din url som vanligt.<br /> <br /> 2. Beräkna md5-/sha1-summan av urlen (utan http://) med "+clientnyckel" tillagd på slutet. Klientnyckel erhålls efter att ha mailat [mailto:support@temperatur.nu support@temperatur.nu]<br /> <br /> 3. I slutet av urlen lägger du sedan till &sign=md5-/sha1-summa<br /> <br /> I php kan det tex se ut så här om du har en signeringsnyckel för md5:<br /> $cli_key="XXXXXXXXXXXXXXXXXXXXXXXXX";<br /> $url="api.temperatur.nu/tnu_1.9.php?p=linkoping&cli=testapp"<br /> $sign=md5($url."+".$cli_key);<br /> $signed_url=$url."&sign=".$sign;<br /> <br /> I den returnerade xml-filen kan du i det första title-fältet se om förfrågan är korrekt signerad.<br /> <br /> [http://www.fileformat.info/tool/hash.htm?text= fileformat.info] är en mycket bra sida för att verifiera att de sha1-/md5-summor du tagit fram stämmer.<br /> <br /> ==Historik/ändringslogg==<br /> 2010-05-04 - Version 1.0<br /> Första releasen.<br /> <br /> 2010-05-13 - Version 1.1<br /> Variabeln cli tillagd.<br /> <br /> 2010-05-19 - Version 1.2<br /> Stöd för att hämta grafer<br /> <br /> 2010-06-09 - Version 1.3<br /> Bugfix som fixar en bugg introducerad i 1.2 (det gick inte att hämta alla orter genom att skippa variabeln p).<br /> <br /> 2010-08-04 - Version 1.4<br /> Värden för x och y justerade. Parametern cli krävs för att apiet skall returnera data.<br /> <br /> 2010-09-01 - Version 1.5<br /> Parametrar för att via mer info i grafen. Parametrar för att visa grafer för i går, förra veckan, 2 år sedan etc.<br /> <br /> 2010-09-01 - Version 1.6<br /> Parameter för att ange om 1 eller 2 y-axlar skall visas.<br /> <br /> 2010-11-22 - Version 1.7<br /> Möjlighet att välja hur tjock graflinjen skall vara.<br /> <br /> 2010-12-19 - Version 1.8<br /> CacheBust-funktion, möjlighet att ändra textstorlek samt information om vem som loggar temperaturen när verbose är specat.<br /> <br /> 2011-01-13 - Version 1.9<br /> Signeringsfunktion inlagd. Signeringsfunktionen kommer från mitten av 2011 krävas för alla tillämpningar och och kommer successivt att läggas in i alla versioner av apiet.<br /> <br /> 2011-01-17 - Version 1.10<br /> Möjlighet att via Apiet hantera informaion gällande den senaste tillgängliga klientversionen.<br /> <br /> 2011-01-30 - Version 1.11<br /> Mer flexibel specificering av tidsperspektiv för grafer. amm - möjlighet att hämta medel/min/max i ett valfritt tidsperspektiv, antalet osignerade accesser begränsat i denna version.<br /> <br /> 2011-10-08 - Version 1.12<br /> Variabeln history tillagd. Visar föregående periods temperatur i grafer.<br /> <br /> 2012-05-04 - Version 1.13<br /> Variablerna compare och color angivna, gör det möjligt att jämföra flera orter i samma graf samt helt styra vilka färger linjerna i graferna skall ha. color kan sättas även för vanliga grafer.<br /> <br /> 2013 - Version 1.14<br /> Parametern history_year som används för att jämföra data med tidigare år. Buggfixar<br /> <br /> 2014-01-26 - Version 1.15<br /> Parametern daily. Används för att hämta dygnsmedel i ett specificerat tidsspann.<br /> <br /> 2021-02-25 - Version 1.16<br /> Parametern json för att få ut data i json-format. Parametern data som används för att få ut data i råformat. Mer information returneras när parametern verbose används. Generell buggrättning<br /> <br /> [[Kategori:www.temperatur.nu]]<br /> [[Kategori:Mjukvara]]</div>

Elf98 https://wiki.temperatur.nu/index.php?title=API&diff=762 API 2021-02-24T11:15:20Z

<p>Elf98: /* Beskrivning av returnerade fält */</p> <hr /> <div>{| align="right"<br /> | __TOC__<br /> |}<br /> Det finns ett enkelt API för att hämta senaste temperaturerna från temperatur.nu.<br /> <br /> Aktuell API-version 1.16. <br /> <br /> Data returneras i XML-format eller json-format<br /> <br /> ==Support==<br /> För support på API-funktionen, använd [http://www.temperatur.nu/forum/forslag-feedback/diskusionstrad-for-api-funktionen-t1373.html Forumet på www.temperatur.nu].<br /> <br /> ==Villkor==<br /> *Mjukvaran skall skrivas på ett sådant sätt att APIet inte automatiskt belastas med samma fråga oftare än var femte minut från en enskild klient. Klientid som bryter mot detta villkor kan komma att blockeras. <br /> *Det måste mycket tydligt framgå att temperaturerna kommer från temperatur.nu.<br /> *Där så är möjligt skall temperaturerna vara länkar till temperatur.nu.<br /> *Temperatur.nus [[Logotype|logotype]] skall finnas i applikationen, gärna så den tydligt syns när programmet används. Om detta ej är möjligt kan logotypen placeras där inställningar för applikationen görs.<br /> *APIet får ej användas för att automatiskt samla in och lagra data längre än 24h.<br /> *I de fall applikationen kommer att kosta pengar för användaren krävs särskild överenskommelse med temperatur.nu. Kontakta [mailto:support@temperatur.nu support@temperatur.nu] för mer information.<br /> *Förfrågningar till APIet kan signeras, från och med version 1.11 är osignerade förfrågningar är begränsade till ca 20/timma per klientid. Denna begränsning kommer efter hand att läggas in även på de äldre versionerna. Maila [mailto:support@temperatur.nu support@temperatur.nu] för att att erhålla en signeringsnyckel för ditt klientid. När du ansöker om en signeringsnyckel måste du ange om du vill signera med sha1 eller md5. Läs mer om hur du signerar förfrågningarna längre ner på denna sida.<br /> *Du skall skriva en beskrivning av din mjukvara i denna Wiki. På så sätt kommer fler intresserade att hitta din applikation. Klienter som inte finns beskrivna i Wikin kan komma att blockeras. [[Mjukvaror_som_använder_APIet|Här finns en lista med kända klienter]]<br /> <br /> <br /> ==Kort beskrivning==<br /> APIet är tänkt att användas av de som skapar extern mjukvara, tex applikationer för Iphone och Android.<br /> Målet är att APIet skall vara lättförståeligt och lätt att använda - feedback från användarna är av stor vikt för att kunna utveckla APIet!<br /> <br /> ==Var finns APIet?==<br /> Du accessar APIet via http://api.temperatur.nu/tnu_1.<version>.php. ex: http://api.temperatur.nu/tnu_1.12.php<br /> <br /> ==Parametrar==<br /> Generellta parametrar<br /> <br /> {| border=1 class="wikitable"<br /> |-<br /> ! Parameter<br /> ! Beskrivning<br /> ! Kan ej användas med<br /> ! Introducerad i API-version<br /> |-<br /> | json<br /> | Om angiven returneras data i json-format i stället för xml<br /> | <br /> | 1.16<br /> |-<br /> | p<br /> | Anger för vilka orter data skall returneras - kommaseparerad lista. Utelämnas parametern returneras samtliga mätpunkter.<br /> | lat, lon, num<br /> | 1.0<br /> |-<br /> | dc<br /> | Anger om decimalkomma skall användas i stället för decimalpunkt i fälten <temperatur>, <lat>, <lon> och <dist>.<br /> |<br /> | 1.0<br /> |-<br /> | simple<br /> | Minimal output, returnerar endast <title>, <id> och <temp><br /> | verbose<br /> | 1.0<br /> |-<br /> | verbose<br /> | Returnerar alla fält för orten, se beskrivning nedan<br /> | simple<br /> | 1.0<br /> |-<br /> | coordinates<br /> | Visar koordinaterna för valda orter. Kan användas tillsammans med simple för att kunna positionera orter på en karta utan att behöva hämta alla fält.<br /> | verbose<br /> | 1.0<br /> |-<br /> | lat<br /> | Används tillsammans med lon och ev num. Det spelar inte någon roll om decimal- eller kommapunkt används. När dessa parametrar används returneras de num närmaste orterna, närmaste orten först.<br /> | p<br /> | 1.0<br /> |-<br /> | lon<br /> | Används tillsammans med lat och ev num. Det spelar inte någon roll om decimal- eller kommapunkt används. När dessa parametrar används returneras de num närmaste orterna, närmaste orten först..<br /> | p<br /> | 1.0<br /> |-<br /> | num<br /> | Används tillsammans med lat och lon. Anger hur många orter som skall returneras. Standard är 1 och max är 5 (10 från v 1.12).<br /> | p<br /> | 1.0<br /> |-<br /> | cb<br /> | CacheBust. Om denna parameter finns i urlen (&cb) kommer ett randomiserat värde att läggas till i slutet av graf-urlerna. Denna parameter kan användas för att se till att inte grafen cachas lokalt hos användaren eller i någon dåligt konfigurerad proxy mellan temperatur.nu och användaren.<br /> |<br /> | 1.8<br /> |-<br /> | cli <br /> | Skall användas för att identifiera vilken klient som hämtar data. Ex "cli=tnu_widget". Från mitten av 2011 kommer signering av urlerna krävas i kombination med cli. Läs mer längre ner.<br /> |<br /> | 1.1<br /> |-<br /> | sign<br /> | Skall APIet regelbundet måste URLerna signeras. Se information längre ner på denna sida.<br /> |<br /> | 1.0 (tillagd i efterhand)<br /> |}<br /> <br /> Parametrar som är relaterade till att hämta statistik<br /> {| border=1 class="wikitable"<br /> |-<br /> ! Parameter<br /> ! Beskrivning<br /> ! Kan ej användas med<br /> ! Introducerad i API-version<br /> |-<br /> | data<br /> | Används för att hämta rådata för en mätpunkt specificerade med variabeln p.<br /> | graph<br /> | 1.16<br /> |-<br /> | amm<br /> | Används för att hämta Average, Min & Max för upp till 5 (10 från v1.12) orter specificerade med variabeln p.<br /> | graph<br /> | 1.11<br /> |-<br /> | daily<br /> | Används för att hämta dygnsmedel samt lägsta och högsta temperatur per dygn. En mätpunkt specificerad med variabeln p.<br /> | graph<br /> | 1.15<br /> |-<br /> | span<br /> | Specificerar för vilket tidsperspektiv Average, Min & Max skall skapas. Giltiga värden är: 1day (standard), 1week, 1month, 1year.<br /> | start, end<br /> | 1.2<br /> |-<br /> | shift_g<br /> |Anger om daily skall visa äldre data. Exempel: om span är 1month och shift_g är 1 hämtas data för föregående månad. Standard är 0.<br /> | start, end<br /> | 1.15<br /> |-<br /> | start<br /> | Specificerar starttid för amm. Formatet är Y-m-d-H-i, ex 2011-01-30-12-31.<br /> | span<br /> | 1.11<br /> |-<br /> | end<br /> | Specificerar sluttid för amm. Formatet är Y-m-d-H-i, ex 2011-01-30-12-31. Standard är nuvarande tid<br /> | span<br /> | 1.11<br /> |}<br /> <br /> Parametrar som är relaterade till grafgenerering:<br /> {| border=1 class="wikitable"<br /> |-<br /> ! Parameter<br /> ! Beskrivning<br /> ! Kan ej användas med<br /> ! Introducerad i API-version<br /> |-<br /> | graph<br /> | Används för att generera en graf för upp till 5 orter specificerade med variabeln p. Anges variablen compare kommer orterna att läggas in i samma graf i stället för separata.<br /> | amm<br /> | 1.2<br /> |-<br /> | span<br /> | Specificerar för vilket tidsperspektiv grafer skall skapas. Giltiga värden är: 1day (standard), 1week, 1month, 1year.<br /> | start, end<br /> | 1.2<br /> |-<br /> | shift_g<br /> | Anger om grafen skall visa äldre data. Exempel: om span är 1day och shift_g är 1 visas en graf för igår, om shift_g är 2 visar grafen data för i förrgår etc. Standard är 0.<br /> | start, end<br /> | 1.5<br /> |-<br /> | start<br /> | Specificerar starttid för graph eller amm. Formatet är Y-m-d-H-i, ex 2011-01-30-12-31.<br /> | span, shift_g, history<br /> | 1.11<br /> |-<br /> | end<br /> | Specificerar sluttid för graph eller amm. Formatet är Y-m-d-H-i, ex 2011-01-30-12-31. Standard är nuvarande tid<br /> | span, shift_g, history<br /> | 1.11<br /> |-<br /> | history<br /> | Används för att i grafen lägga in föregående periods temperatur. Visas temperaturen för det senaste dygnet visas föregående 24h i en annan färg etc. Kan förklarliga skäl endast användas med variabeln graph.<br /> | start, end<br /> | 1.12<br /> |-<br /> | history_year<br /> | Används för att i grafen lägga in jämförelse med annat år. År anges med 4 siffror, ex 2013. Kan förklarliga skäl endast användas med variabeln graph.<br /> | start, end<br /> | 1.14<br /> |-<br /> | verbose_g<br /> | Visar min/max/medel/senaste värde i grafen. Visar även när data senast hämtades för den valda orten.<br /> |<br /> | 1.5<br /> |-<br /> | 1axis<br /> | Används för att endast visa temperaturskalan till vänster. Används med fördel i små grafer för att spara utrymme.<br /> |<br /> | 1.6<br /> |-<br /> | fontsize<br /> | Anger hur stor texten skall vara. Observera att värdet inte kan relateras till vanliga textstorlekar, du måste därför testa dig fram.<br /> |<br /> | 1.8<br /> |-<br /> | linewidth<br /> | Anger bredden på graflinjen. Giltiga värden 1 till 5. Även flyttal, ex 1.5, fungerar. Decimalkomma eller decimalpunkt spelar inte någon roll.<br /> |<br /> | 1.7<br /> |-<br /> | x<br /> | Specificerar hur bred grafen skall vara. Giltiga värden är 150-2500. 300 är standard.<br /> |<br /> | 1.2 (Tillåtna värden justerade i v 1.4,v 1.14)<br /> |-<br /> | y<br /> | Specificerar hur hög grafen skall vara. Giltiga värden är 125-2500. 200 är standard.<br /> |<br /> | 1.2 (Tillåtna värden justerade i v 1.4, v 1.14)<br /> |-<br /> | color<br /> | Anger vilken/vilka färger linjer i grafen skall ha, kommasepararead lista. Standard är #FF0000,#AADDAA,#FFCC00.<br /> |<br /> | 1.13<br /> |-<br /> | compare<br /> | Anger att order som skickats med p skall läggas in för jämförelse i samma graf. Om fler än tre orter anges måste även color definieras<br /> |<br /> | 1.13<br /> |}<br /> <br /> ==Beskrivning av returnerade fält==<br /> {| border=1 class="wikitable"<br /> |-<br /> ! Fält<br /> ! Beskrivning<br /> ! parameter som visar<br /> ! parameter som döljer<br /> ! Visas som standard<br /> ! Introducerad i API-version<br /> |-<br /> | <title><br /> | Mätpunktens namn på temperatur.nu<br /> | <br /> | <br /> | X<br /> | 1.0<br /> |-<br /> | <id><br /> | Mätpunktens id på temperatur.nu. Kan användas med parametern "p" för att hämta endast denna mätpunkts information<br /> |<br /> | simple<br /> | X<br /> | 1.0<br /> |-<br /> | <temp><br /> | Mätpunktens senaste temperatur. Om decimalkomma eller decimalpunkt skall användas styrs med parametern dc.<br /> |<br /> |<br /> | X<br /> | 1.0<br /> |-<br /> | <lat><br /> | Mätpunktens latitud i decimalt format. Om decimalkomma eller decimalpunkt skall användas styrs med parametern dc.<br /> | coordinates, verbose<br /> |<br /> |<br /> | 1.0<br /> |-<br /> | <lon><br /> | Mätpunktens longitud i decimalt format. Om decimalkomma eller decimalpunkt skall användas styrs med parametern dc.<br /> | coordinates, verbose<br /> |<br /> |<br /> | 1.0<br /> |-<br /> | <lastUpdate><br /> | Tidpunkt då informationen senast uppdaterades på temperatur.nu<br /> | verbose<br /> |<br /> |<br /> | 1.0<br /> |-<br /> | <kommun><br /> | Den kommun som mätpunkten ligger i.<br /> | verbose<br /> |<br /> |<br /> | 1.0<br /> |-<br /> | <lan><br /> | Det län som mätpunkten ligger i.<br /> | verbose<br /> |<br /> |<br /> | 1.0<br /> |-<br /> | <sourceInfo><br /> | En kort textsträng med information om vem som loggar temperaturen för mätpunkten<br /> | verbose<br /> |<br /> |<br /> | 1.8<br /> |-<br /> | <forutsattning><br /> | Textsträng med information om hur mätningarna sker - finns ej för alla mätpunkter och returernar om så är fallet ett tomt fält.<br /> | verbose<br /> |<br /> |<br /> | 1.16<br /> |-<br /> | <url><br /> | Url till mätpunktens temperatur och grafer på www.temperatur.nu<br /> | verbose<br /> |<br /> |<br /> | 1.0<br /> |-<br /> | <dist><br /> | Hur långt från de givna koordinaterna mätpunkten ligger. Enheten är kilometer. Om decimalkomma eller decimalpunkt skall användas styrs med parametern dc.<br /> | lat & lon<br /> | simple<br /> |<br /> | 1.0<br /> |-<br /> | <graph><br /> | Visar url till graph för orten. Observera att ny graf endast genereras när parametern graph används. Det går därför inte att lokalt cacha urlen i klienten. <br /> | graph (x, y, span, verbose_g, shift_g)<br /> |<br /> |<br /> | 1.2<br /> |-<br /> | <ClientVersion><br /> | Visar vilken den senaste släppta klientversionen är. Kan med fördel användas för att kontrollera om det finns någon uppdatering till klientmjukvaran.<br /> | version<br /> |<br /> |<br /> | 1.10<br /> |-<br /> | <ClientVersionSet><br /> | Visar status i samband med att informationen om klientversionen uppdaterats.<br /> | version_update<br /> |<br /> |<br /> | 1.10<br /> |-<br /> | <daily><br /> | Har underliggande fält <date>, <average>, <min>, <max> som representerar data för dygn angivet i fältet date. Dessa fält returneras när parametern daily används för att hämta statisk för flera dygn<br /> | daily, span, start, end, shift_g<br /> |<br /> |<br /> | 1.15<br /> |-<br /> | <ammRange><br /> | Visar för vilket tidsperspektiv amm (medel/min/max) har hämtats<br /> | amm, span, start, end, shift_g<br /> |<br /> |<br /> | 1.11<br /> |-<br /> | <average><br /> | Medeltemperatur i specificerat tidsperspektiv<br /> | amm, span, start, end, shift_g<br /> |<br /> |<br /> | 1.11<br /> |-<br /> | <min><br /> | Den minsta temperaturen i specificerat tidsperspektiv<br /> | amm, span, start, end, shift_g<br /> |<br /> |<br /> | 1.11<br /> |-<br /> | <minTime><br /> | Vid vilken tidpunkt <min> inträffade<br /> | amm, span, start, end, shift_g<br /> |<br /> |<br /> | 1.11<br /> |-<br /> | <max><br /> | Den högsta temperaturen i specificerat tidsperspektiv<br /> | amm, span, start, end, shift_g<br /> |<br /> |<br /> | 1.11<br /> |-<br /> | <maxTime><br /> | Vid vilken tidpunkt <max> inträffade<br /> | amm, span, start, end, shift_g<br /> |<br /> |<br /> | 1.11<br /> |-<br /> | <uptime><br /> | Mätpunktens upptid i % det senaste året<br /> | verbose<br /> |<br /> |<br /> | 1.16<br /> |-<br /> | <start><br /> | Tidpunkt när mätpunkten lades till på temperatur.nu<br /> | verbose<br /> |<br /> |<br /> | 1.16<br /> |-<br /> | <moh><br /> | Mätpunktens höjd över havsnivån (Meter above Sea Level)<br /> | verbose<br /> |<br /> |<br /> | 1.16<br /> |-<br /> | <rawdata><br /> | Temperaturdata i råformat. Varje rawdata-fält innehåller subfälten date, time, timestamp, temperatur<br /> | data<br /> |<br /> |<br /> | 1.16<br /> <br /> |}<br /> <br /> ==Exempel==<br /> <br /> Så här kan resultatet från en förfrågan på http://api.temperatur.nu/tnu_1.12.php?p=linkoping&verbose&cli=test_app se ut:<br /> <?xml version='1.0' encoding='iso-8859-1'?><br /> <rss version="2.0"><br /> <channel><br /> <title>Temperatur.nu API 1.12 - Din url är inte korrekt signerad, clientnyckeln kan tillfälligt blockeras - /tnu_1.12.php</title><br /> <link>http://wiki.temperatur.nu/index.php/Api</link><br /> <item><br /> <title>Linköping/Centrum</title><br /> <id>linkoping</id><br /> <temp>9.3</temp><br /> <lat>58.414297</lat><br /> <lon>15.628788</lon><br /> <lastUpdate>2011-11-24 08:51:25</lastUpdate><br /> <kommun>Linköping</kommun><br /> <lan>Östergötlands län</lan><br /> <sourceInfo>Temperaturdata från Stångå Hotell.</sourceInfo><br /> <url>http://www.temperatur.nu/linkoping.html</url><br /> </item><br /> </channel><br /> </rss><br /> <br /> <br /> Så här kan resultatet från en förfrågan på http://api.temperatur.nu/tnu_1.12.php?lat=58.376761&lon=15.562916&num=3&graph&cli=test_app2 se ut:<br /> <?xml version='1.0' encoding='iso-8859-1'?><br /> <rss version="2.0"><br /> <channel><br /> <title>Temperatur.nu API 1.12 - Din url är inte korrekt signerad, clientnyckeln kan tillfälligt blockeras - /tnu_1.12.php</title><br /> <link>http://wiki.temperatur.nu/index.php/Api</link><br /> <item><br /> <title>Linköping/Jägarvallen</title><br /> <id>jagarvallen</id><br /> <temp>7.8</temp><br /> <dist>2.5</dist><br /> <graph>http://www2.timg.nu/graph/jagarvallen-1day-300-200-0-0-0-1-8-n.png</graph><br /> </item><br /> <item><br /> <title>Linköping/Malmen (METAR)</title><br /> <id>malmen</id><br /> <temp>8.3</temp><br /> <dist>2.8</dist><br /> <graph>http://www2.timg.nu/graph/malmen-1day-300-200-0-0-0-1-8-n.png</graph><br /> </item><br /> <item><br /> <title>Linköping/Skäggetorp</title><br /> <id>skaggetorp</id><br /> <temp>9.1</temp><br /> <dist>5.2</dist><br /> <graph>http://www2.timg.nu/graph/skaggetorp-1day-300-200-0-0-0-1-8-n.png</graph><br /> </item><br /> </channel><br /> </rss><br /> <br /> <br /> ==Signering av URLer==<br /> Förfrågningar till APIet kan signeras. Från och med version 1.11 är antalet osignerade förfrågningar begränsade till 20 per timma. Osignerade förfrågningar kommer i framtiden att begränsas för alla api-versioner. Skriver du en privat tillämpning kan du använda APIet utan att signera URLerna.<br /> <br /> Signeringen går till så här:<br /> <br /> 1. Skapa din url som vanligt.<br /> <br /> 2. Beräkna md5-/sha1-summan av urlen (utan http://) med "+clientnyckel" tillagd på slutet. Klientnyckel erhålls efter att ha mailat [mailto:support@temperatur.nu support@temperatur.nu]<br /> <br /> 3. I slutet av urlen lägger du sedan till &sign=md5-/sha1-summa<br /> <br /> I php kan det tex se ut så här om du har en signeringsnyckel för md5:<br /> $cli_key="XXXXXXXXXXXXXXXXXXXXXXXXX";<br /> $url="api.temperatur.nu/tnu_1.9.php?p=linkoping&cli=testapp"<br /> $sign=md5($url."+".$cli_key);<br /> $signed_url=$url."&sign=".$sign;<br /> <br /> I den returnerade xml-filen kan du i det första title-fältet se om förfrågan är korrekt signerad.<br /> <br /> [http://www.fileformat.info/tool/hash.htm?text= fileformat.info] är en mycket bra sida för att verifiera att de sha1-/md5-summor du tagit fram stämmer.<br /> <br /> ==Historik/ändringslogg==<br /> 2010-05-04 - Version 1.0<br /> Första releasen.<br /> <br /> 2010-05-13 - Version 1.1<br /> Variabeln cli tillagd.<br /> <br /> 2010-05-19 - Version 1.2<br /> Stöd för att hämta grafer<br /> <br /> 2010-06-09 - Version 1.3<br /> Bugfix som fixar en bugg introducerad i 1.2 (det gick inte att hämta alla orter genom att skippa variabeln p).<br /> <br /> 2010-08-04 - Version 1.4<br /> Värden för x och y justerade. Parametern cli krävs för att apiet skall returnera data.<br /> <br /> 2010-09-01 - Version 1.5<br /> Parametrar för att via mer info i grafen. Parametrar för att visa grafer för i går, förra veckan, 2 år sedan etc.<br /> <br /> 2010-09-01 - Version 1.6<br /> Parameter för att ange om 1 eller 2 y-axlar skall visas.<br /> <br /> 2010-11-22 - Version 1.7<br /> Möjlighet att välja hur tjock graflinjen skall vara.<br /> <br /> 2010-12-19 - Version 1.8<br /> CacheBust-funktion, möjlighet att ändra textstorlek samt information om vem som loggar temperaturen när verbose är specat.<br /> <br /> 2011-01-13 - Version 1.9<br /> Signeringsfunktion inlagd. Signeringsfunktionen kommer från mitten av 2011 krävas för alla tillämpningar och och kommer successivt att läggas in i alla versioner av apiet.<br /> <br /> 2011-01-17 - Version 1.10<br /> Möjlighet att via Apiet hantera informaion gällande den senaste tillgängliga klientversionen.<br /> <br /> 2011-01-30 - Version 1.11<br /> Mer flexibel specificering av tidsperspektiv för grafer. amm - möjlighet att hämta medel/min/max i ett valfritt tidsperspektiv, antalet osignerade accesser begränsat i denna version.<br /> <br /> 2011-10-08 - Version 1.12<br /> Variabeln history tillagd. Visar föregående periods temperatur i grafer.<br /> <br /> 2012-05-04 - Version 1.13<br /> Variablerna compare och color angivna, gör det möjligt att jämföra flera orter i samma graf samt helt styra vilka färger linjerna i graferna skall ha. color kan sättas även för vanliga grafer.<br /> <br /> 2013 - Version 1.14<br /> Parametern history_year som används för att jämföra data med tidigare år. Buggfixar<br /> <br /> 2014-01-26 - Version 1.15<br /> Parametern daily. Används för att hämta dygnsmedel i ett specificerat tidsspann.<br /> <br /> [[Kategori:www.temperatur.nu]]<br /> [[Kategori:Mjukvara]]</div>

Elf98 https://wiki.temperatur.nu/index.php?title=API&diff=761 API 2021-02-24T10:16:16Z

<p>Elf98: /* Beskrivning av returnerade fält */</p> <hr /> <div>{| align="right"<br /> | __TOC__<br /> |}<br /> Det finns ett enkelt API för att hämta senaste temperaturerna från temperatur.nu.<br /> <br /> Aktuell API-version 1.16. <br /> <br /> Data returneras i XML-format eller json-format<br /> <br /> ==Support==<br /> För support på API-funktionen, använd [http://www.temperatur.nu/forum/forslag-feedback/diskusionstrad-for-api-funktionen-t1373.html Forumet på www.temperatur.nu].<br /> <br /> ==Villkor==<br /> *Mjukvaran skall skrivas på ett sådant sätt att APIet inte automatiskt belastas med samma fråga oftare än var femte minut från en enskild klient. Klientid som bryter mot detta villkor kan komma att blockeras. <br /> *Det måste mycket tydligt framgå att temperaturerna kommer från temperatur.nu.<br /> *Där så är möjligt skall temperaturerna vara länkar till temperatur.nu.<br /> *Temperatur.nus [[Logotype|logotype]] skall finnas i applikationen, gärna så den tydligt syns när programmet används. Om detta ej är möjligt kan logotypen placeras där inställningar för applikationen görs.<br /> *APIet får ej användas för att automatiskt samla in och lagra data längre än 24h.<br /> *I de fall applikationen kommer att kosta pengar för användaren krävs särskild överenskommelse med temperatur.nu. Kontakta [mailto:support@temperatur.nu support@temperatur.nu] för mer information.<br /> *Förfrågningar till APIet kan signeras, från och med version 1.11 är osignerade förfrågningar är begränsade till ca 20/timma per klientid. Denna begränsning kommer efter hand att läggas in även på de äldre versionerna. Maila [mailto:support@temperatur.nu support@temperatur.nu] för att att erhålla en signeringsnyckel för ditt klientid. När du ansöker om en signeringsnyckel måste du ange om du vill signera med sha1 eller md5. Läs mer om hur du signerar förfrågningarna längre ner på denna sida.<br /> *Du skall skriva en beskrivning av din mjukvara i denna Wiki. På så sätt kommer fler intresserade att hitta din applikation. Klienter som inte finns beskrivna i Wikin kan komma att blockeras. [[Mjukvaror_som_använder_APIet|Här finns en lista med kända klienter]]<br /> <br /> <br /> ==Kort beskrivning==<br /> APIet är tänkt att användas av de som skapar extern mjukvara, tex applikationer för Iphone och Android.<br /> Målet är att APIet skall vara lättförståeligt och lätt att använda - feedback från användarna är av stor vikt för att kunna utveckla APIet!<br /> <br /> ==Var finns APIet?==<br /> Du accessar APIet via http://api.temperatur.nu/tnu_1.<version>.php. ex: http://api.temperatur.nu/tnu_1.12.php<br /> <br /> ==Parametrar==<br /> Generellta parametrar<br /> <br /> {| border=1 class="wikitable"<br /> |-<br /> ! Parameter<br /> ! Beskrivning<br /> ! Kan ej användas med<br /> ! Introducerad i API-version<br /> |-<br /> | json<br /> | Om angiven returneras data i json-format i stället för xml<br /> | <br /> | 1.16<br /> |-<br /> | p<br /> | Anger för vilka orter data skall returneras - kommaseparerad lista. Utelämnas parametern returneras samtliga mätpunkter.<br /> | lat, lon, num<br /> | 1.0<br /> |-<br /> | dc<br /> | Anger om decimalkomma skall användas i stället för decimalpunkt i fälten <temperatur>, <lat>, <lon> och <dist>.<br /> |<br /> | 1.0<br /> |-<br /> | simple<br /> | Minimal output, returnerar endast <title>, <id> och <temp><br /> | verbose<br /> | 1.0<br /> |-<br /> | verbose<br /> | Returnerar alla fält för orten, se beskrivning nedan<br /> | simple<br /> | 1.0<br /> |-<br /> | coordinates<br /> | Visar koordinaterna för valda orter. Kan användas tillsammans med simple för att kunna positionera orter på en karta utan att behöva hämta alla fält.<br /> | verbose<br /> | 1.0<br /> |-<br /> | lat<br /> | Används tillsammans med lon och ev num. Det spelar inte någon roll om decimal- eller kommapunkt används. När dessa parametrar används returneras de num närmaste orterna, närmaste orten först.<br /> | p<br /> | 1.0<br /> |-<br /> | lon<br /> | Används tillsammans med lat och ev num. Det spelar inte någon roll om decimal- eller kommapunkt används. När dessa parametrar används returneras de num närmaste orterna, närmaste orten först..<br /> | p<br /> | 1.0<br /> |-<br /> | num<br /> | Används tillsammans med lat och lon. Anger hur många orter som skall returneras. Standard är 1 och max är 5 (10 från v 1.12).<br /> | p<br /> | 1.0<br /> |-<br /> | cb<br /> | CacheBust. Om denna parameter finns i urlen (&cb) kommer ett randomiserat värde att läggas till i slutet av graf-urlerna. Denna parameter kan användas för att se till att inte grafen cachas lokalt hos användaren eller i någon dåligt konfigurerad proxy mellan temperatur.nu och användaren.<br /> |<br /> | 1.8<br /> |-<br /> | cli <br /> | Skall användas för att identifiera vilken klient som hämtar data. Ex "cli=tnu_widget". Från mitten av 2011 kommer signering av urlerna krävas i kombination med cli. Läs mer längre ner.<br /> |<br /> | 1.1<br /> |-<br /> | sign<br /> | Skall APIet regelbundet måste URLerna signeras. Se information längre ner på denna sida.<br /> |<br /> | 1.0 (tillagd i efterhand)<br /> |}<br /> <br /> Parametrar som är relaterade till att hämta statistik<br /> {| border=1 class="wikitable"<br /> |-<br /> ! Parameter<br /> ! Beskrivning<br /> ! Kan ej användas med<br /> ! Introducerad i API-version<br /> |-<br /> | data<br /> | Används för att hämta rådata för en mätpunkt specificerade med variabeln p.<br /> | graph<br /> | 1.16<br /> |-<br /> | amm<br /> | Används för att hämta Average, Min & Max för upp till 5 (10 från v1.12) orter specificerade med variabeln p.<br /> | graph<br /> | 1.11<br /> |-<br /> | daily<br /> | Används för att hämta dygnsmedel samt lägsta och högsta temperatur per dygn. En mätpunkt specificerad med variabeln p.<br /> | graph<br /> | 1.15<br /> |-<br /> | span<br /> | Specificerar för vilket tidsperspektiv Average, Min & Max skall skapas. Giltiga värden är: 1day (standard), 1week, 1month, 1year.<br /> | start, end<br /> | 1.2<br /> |-<br /> | shift_g<br /> |Anger om daily skall visa äldre data. Exempel: om span är 1month och shift_g är 1 hämtas data för föregående månad. Standard är 0.<br /> | start, end<br /> | 1.15<br /> |-<br /> | start<br /> | Specificerar starttid för amm. Formatet är Y-m-d-H-i, ex 2011-01-30-12-31.<br /> | span<br /> | 1.11<br /> |-<br /> | end<br /> | Specificerar sluttid för amm. Formatet är Y-m-d-H-i, ex 2011-01-30-12-31. Standard är nuvarande tid<br /> | span<br /> | 1.11<br /> |}<br /> <br /> Parametrar som är relaterade till grafgenerering:<br /> {| border=1 class="wikitable"<br /> |-<br /> ! Parameter<br /> ! Beskrivning<br /> ! Kan ej användas med<br /> ! Introducerad i API-version<br /> |-<br /> | graph<br /> | Används för att generera en graf för upp till 5 orter specificerade med variabeln p. Anges variablen compare kommer orterna att läggas in i samma graf i stället för separata.<br /> | amm<br /> | 1.2<br /> |-<br /> | span<br /> | Specificerar för vilket tidsperspektiv grafer skall skapas. Giltiga värden är: 1day (standard), 1week, 1month, 1year.<br /> | start, end<br /> | 1.2<br /> |-<br /> | shift_g<br /> | Anger om grafen skall visa äldre data. Exempel: om span är 1day och shift_g är 1 visas en graf för igår, om shift_g är 2 visar grafen data för i förrgår etc. Standard är 0.<br /> | start, end<br /> | 1.5<br /> |-<br /> | start<br /> | Specificerar starttid för graph eller amm. Formatet är Y-m-d-H-i, ex 2011-01-30-12-31.<br /> | span, shift_g, history<br /> | 1.11<br /> |-<br /> | end<br /> | Specificerar sluttid för graph eller amm. Formatet är Y-m-d-H-i, ex 2011-01-30-12-31. Standard är nuvarande tid<br /> | span, shift_g, history<br /> | 1.11<br /> |-<br /> | history<br /> | Används för att i grafen lägga in föregående periods temperatur. Visas temperaturen för det senaste dygnet visas föregående 24h i en annan färg etc. Kan förklarliga skäl endast användas med variabeln graph.<br /> | start, end<br /> | 1.12<br /> |-<br /> | history_year<br /> | Används för att i grafen lägga in jämförelse med annat år. År anges med 4 siffror, ex 2013. Kan förklarliga skäl endast användas med variabeln graph.<br /> | start, end<br /> | 1.14<br /> |-<br /> | verbose_g<br /> | Visar min/max/medel/senaste värde i grafen. Visar även när data senast hämtades för den valda orten.<br /> |<br /> | 1.5<br /> |-<br /> | 1axis<br /> | Används för att endast visa temperaturskalan till vänster. Används med fördel i små grafer för att spara utrymme.<br /> |<br /> | 1.6<br /> |-<br /> | fontsize<br /> | Anger hur stor texten skall vara. Observera att värdet inte kan relateras till vanliga textstorlekar, du måste därför testa dig fram.<br /> |<br /> | 1.8<br /> |-<br /> | linewidth<br /> | Anger bredden på graflinjen. Giltiga värden 1 till 5. Även flyttal, ex 1.5, fungerar. Decimalkomma eller decimalpunkt spelar inte någon roll.<br /> |<br /> | 1.7<br /> |-<br /> | x<br /> | Specificerar hur bred grafen skall vara. Giltiga värden är 150-2500. 300 är standard.<br /> |<br /> | 1.2 (Tillåtna värden justerade i v 1.4,v 1.14)<br /> |-<br /> | y<br /> | Specificerar hur hög grafen skall vara. Giltiga värden är 125-2500. 200 är standard.<br /> |<br /> | 1.2 (Tillåtna värden justerade i v 1.4, v 1.14)<br /> |-<br /> | color<br /> | Anger vilken/vilka färger linjer i grafen skall ha, kommasepararead lista. Standard är #FF0000,#AADDAA,#FFCC00.<br /> |<br /> | 1.13<br /> |-<br /> | compare<br /> | Anger att order som skickats med p skall läggas in för jämförelse i samma graf. Om fler än tre orter anges måste även color definieras<br /> |<br /> | 1.13<br /> |}<br /> <br /> ==Beskrivning av returnerade fält==<br /> {| border=1 class="wikitable"<br /> |-<br /> ! Fält<br /> ! Beskrivning<br /> ! parameter som visar<br /> ! parameter som döljer<br /> ! Visas som standard<br /> ! Introducerad i API-version<br /> |-<br /> | <title><br /> | Mätpunktens namn på temperatur.nu<br /> | <br /> | <br /> | X<br /> | 1.0<br /> |-<br /> | <id><br /> | Mätpunktens id på temperatur.nu. Kan användas med parametern "p" för att hämta endast denna mätpunkts information<br /> |<br /> | simple<br /> | X<br /> | 1.0<br /> |-<br /> | <temp><br /> | Mätpunktens senaste temperatur. Om decimalkomma eller decimalpunkt skall användas styrs med parametern dc.<br /> |<br /> |<br /> | X<br /> | 1.0<br /> |-<br /> | <lat><br /> | Mätpunktens latitud i decimalt format. Om decimalkomma eller decimalpunkt skall användas styrs med parametern dc.<br /> | coordinates, verbose<br /> |<br /> |<br /> | 1.0<br /> |-<br /> | <lon><br /> | Mätpunktens longitud i decimalt format. Om decimalkomma eller decimalpunkt skall användas styrs med parametern dc.<br /> | coordinates, verbose<br /> |<br /> |<br /> | 1.0<br /> |-<br /> | <lastUpdate><br /> | Tidpunkt då informationen senast uppdaterades på temperatur.nu<br /> | verbose<br /> |<br /> |<br /> | 1.0<br /> |-<br /> | <kommun><br /> | Den kommun som mätpunkten ligger i.<br /> | verbose<br /> |<br /> |<br /> | 1.0<br /> |-<br /> | <lan><br /> | Det län som mätpunkten ligger i.<br /> | verbose<br /> |<br /> |<br /> | 1.0<br /> |-<br /> | <sourceInfo><br /> | En kort textsträng med information om vem som loggar temperaturen för mätpunkten<br /> | verbose<br /> |<br /> |<br /> | 1.8<br /> |-<br /> | <url><br /> | Url till mätpunktens temperatur och grafer på www.temperatur.nu<br /> | verbose<br /> |<br /> |<br /> | 1.0<br /> |-<br /> | <dist><br /> | Hur långt från de givna koordinaterna mätpunkten ligger. Enheten är kilometer. Om decimalkomma eller decimalpunkt skall användas styrs med parametern dc.<br /> | lat & lon<br /> | simple<br /> |<br /> | 1.0<br /> |-<br /> | <graph><br /> | Visar url till graph för orten. Observera att ny graf endast genereras när parametern graph används. Det går därför inte att lokalt cacha urlen i klienten. <br /> | graph (x, y, span, verbose_g, shift_g)<br /> |<br /> |<br /> | 1.2<br /> |-<br /> | <ClientVersion><br /> | Visar vilken den senaste släppta klientversionen är. Kan med fördel användas för att kontrollera om det finns någon uppdatering till klientmjukvaran.<br /> | version<br /> |<br /> |<br /> | 1.10<br /> |-<br /> | <ClientVersionSet><br /> | Visar status i samband med att informationen om klientversionen uppdaterats.<br /> | version_update<br /> |<br /> |<br /> | 1.10<br /> |-<br /> | <daily><br /> | Har underliggande fält <date>, <average>, <min>, <max> som representerar data för dygn angivet i fältet date. Dessa fält returneras när parametern daily används för att hämta statisk för flera dygn<br /> | daily, span, start, end, shift_g<br /> |<br /> |<br /> | 1.15<br /> |-<br /> | <ammRange><br /> | Visar för vilket tidsperspektiv amm (medel/min/max) har hämtats<br /> | amm, span, start, end, shift_g<br /> |<br /> |<br /> | 1.11<br /> |-<br /> | <average><br /> | Medeltemperatur i specificerat tidsperspektiv<br /> | amm, span, start, end, shift_g<br /> |<br /> |<br /> | 1.11<br /> |-<br /> | <min><br /> | Den minsta temperaturen i specificerat tidsperspektiv<br /> | amm, span, start, end, shift_g<br /> |<br /> |<br /> | 1.11<br /> |-<br /> | <minTime><br /> | Vid vilken tidpunkt <min> inträffade<br /> | amm, span, start, end, shift_g<br /> |<br /> |<br /> | 1.11<br /> |-<br /> | <max><br /> | Den högsta temperaturen i specificerat tidsperspektiv<br /> | amm, span, start, end, shift_g<br /> |<br /> |<br /> | 1.11<br /> |-<br /> | <maxTime><br /> | Vid vilken tidpunkt <max> inträffade<br /> | amm, span, start, end, shift_g<br /> |<br /> |<br /> | 1.11<br /> |-<br /> | <uptime><br /> | Mätpunktens upptid i % det senaste året<br /> | verbose<br /> |<br /> |<br /> | 1.16<br /> |-<br /> | <start><br /> | Tidpunkt när mätpunkten lades till på temperatur.nu<br /> | verbose<br /> |<br /> |<br /> | 1.16<br /> |-<br /> | <msl><br /> | Mätpunktens höjd över havsnivån (Meter above Sea Level)<br /> | verbose<br /> |<br /> |<br /> | 1.16<br /> |-<br /> | <rawdata><br /> | Temperaturdata i råformat. Varje rawdata-fält innehåller subfälten date, time, timestamp, temperatur<br /> | data<br /> |<br /> |<br /> | 1.16<br /> <br /> |}<br /> <br /> ==Exempel==<br /> <br /> Så här kan resultatet från en förfrågan på http://api.temperatur.nu/tnu_1.12.php?p=linkoping&verbose&cli=test_app se ut:<br /> <?xml version='1.0' encoding='iso-8859-1'?><br /> <rss version="2.0"><br /> <channel><br /> <title>Temperatur.nu API 1.12 - Din url är inte korrekt signerad, clientnyckeln kan tillfälligt blockeras - /tnu_1.12.php</title><br /> <link>http://wiki.temperatur.nu/index.php/Api</link><br /> <item><br /> <title>Linköping/Centrum</title><br /> <id>linkoping</id><br /> <temp>9.3</temp><br /> <lat>58.414297</lat><br /> <lon>15.628788</lon><br /> <lastUpdate>2011-11-24 08:51:25</lastUpdate><br /> <kommun>Linköping</kommun><br /> <lan>Östergötlands län</lan><br /> <sourceInfo>Temperaturdata från Stångå Hotell.</sourceInfo><br /> <url>http://www.temperatur.nu/linkoping.html</url><br /> </item><br /> </channel><br /> </rss><br /> <br /> <br /> Så här kan resultatet från en förfrågan på http://api.temperatur.nu/tnu_1.12.php?lat=58.376761&lon=15.562916&num=3&graph&cli=test_app2 se ut:<br /> <?xml version='1.0' encoding='iso-8859-1'?><br /> <rss version="2.0"><br /> <channel><br /> <title>Temperatur.nu API 1.12 - Din url är inte korrekt signerad, clientnyckeln kan tillfälligt blockeras - /tnu_1.12.php</title><br /> <link>http://wiki.temperatur.nu/index.php/Api</link><br /> <item><br /> <title>Linköping/Jägarvallen</title><br /> <id>jagarvallen</id><br /> <temp>7.8</temp><br /> <dist>2.5</dist><br /> <graph>http://www2.timg.nu/graph/jagarvallen-1day-300-200-0-0-0-1-8-n.png</graph><br /> </item><br /> <item><br /> <title>Linköping/Malmen (METAR)</title><br /> <id>malmen</id><br /> <temp>8.3</temp><br /> <dist>2.8</dist><br /> <graph>http://www2.timg.nu/graph/malmen-1day-300-200-0-0-0-1-8-n.png</graph><br /> </item><br /> <item><br /> <title>Linköping/Skäggetorp</title><br /> <id>skaggetorp</id><br /> <temp>9.1</temp><br /> <dist>5.2</dist><br /> <graph>http://www2.timg.nu/graph/skaggetorp-1day-300-200-0-0-0-1-8-n.png</graph><br /> </item><br /> </channel><br /> </rss><br /> <br /> <br /> ==Signering av URLer==<br /> Förfrågningar till APIet kan signeras. Från och med version 1.11 är antalet osignerade förfrågningar begränsade till 20 per timma. Osignerade förfrågningar kommer i framtiden att begränsas för alla api-versioner. Skriver du en privat tillämpning kan du använda APIet utan att signera URLerna.<br /> <br /> Signeringen går till så här:<br /> <br /> 1. Skapa din url som vanligt.<br /> <br /> 2. Beräkna md5-/sha1-summan av urlen (utan http://) med "+clientnyckel" tillagd på slutet. Klientnyckel erhålls efter att ha mailat [mailto:support@temperatur.nu support@temperatur.nu]<br /> <br /> 3. I slutet av urlen lägger du sedan till &sign=md5-/sha1-summa<br /> <br /> I php kan det tex se ut så här om du har en signeringsnyckel för md5:<br /> $cli_key="XXXXXXXXXXXXXXXXXXXXXXXXX";<br /> $url="api.temperatur.nu/tnu_1.9.php?p=linkoping&cli=testapp"<br /> $sign=md5($url."+".$cli_key);<br /> $signed_url=$url."&sign=".$sign;<br /> <br /> I den returnerade xml-filen kan du i det första title-fältet se om förfrågan är korrekt signerad.<br /> <br /> [http://www.fileformat.info/tool/hash.htm?text= fileformat.info] är en mycket bra sida för att verifiera att de sha1-/md5-summor du tagit fram stämmer.<br /> <br /> ==Historik/ändringslogg==<br /> 2010-05-04 - Version 1.0<br /> Första releasen.<br /> <br /> 2010-05-13 - Version 1.1<br /> Variabeln cli tillagd.<br /> <br /> 2010-05-19 - Version 1.2<br /> Stöd för att hämta grafer<br /> <br /> 2010-06-09 - Version 1.3<br /> Bugfix som fixar en bugg introducerad i 1.2 (det gick inte att hämta alla orter genom att skippa variabeln p).<br /> <br /> 2010-08-04 - Version 1.4<br /> Värden för x och y justerade. Parametern cli krävs för att apiet skall returnera data.<br /> <br /> 2010-09-01 - Version 1.5<br /> Parametrar för att via mer info i grafen. Parametrar för att visa grafer för i går, förra veckan, 2 år sedan etc.<br /> <br /> 2010-09-01 - Version 1.6<br /> Parameter för att ange om 1 eller 2 y-axlar skall visas.<br /> <br /> 2010-11-22 - Version 1.7<br /> Möjlighet att välja hur tjock graflinjen skall vara.<br /> <br /> 2010-12-19 - Version 1.8<br /> CacheBust-funktion, möjlighet att ändra textstorlek samt information om vem som loggar temperaturen när verbose är specat.<br /> <br /> 2011-01-13 - Version 1.9<br /> Signeringsfunktion inlagd. Signeringsfunktionen kommer från mitten av 2011 krävas för alla tillämpningar och och kommer successivt att läggas in i alla versioner av apiet.<br /> <br /> 2011-01-17 - Version 1.10<br /> Möjlighet att via Apiet hantera informaion gällande den senaste tillgängliga klientversionen.<br /> <br /> 2011-01-30 - Version 1.11<br /> Mer flexibel specificering av tidsperspektiv för grafer. amm - möjlighet att hämta medel/min/max i ett valfritt tidsperspektiv, antalet osignerade accesser begränsat i denna version.<br /> <br /> 2011-10-08 - Version 1.12<br /> Variabeln history tillagd. Visar föregående periods temperatur i grafer.<br /> <br /> 2012-05-04 - Version 1.13<br /> Variablerna compare och color angivna, gör det möjligt att jämföra flera orter i samma graf samt helt styra vilka färger linjerna i graferna skall ha. color kan sättas även för vanliga grafer.<br /> <br /> 2013 - Version 1.14<br /> Parametern history_year som används för att jämföra data med tidigare år. Buggfixar<br /> <br /> 2014-01-26 - Version 1.15<br /> Parametern daily. Används för att hämta dygnsmedel i ett specificerat tidsspann.<br /> <br /> [[Kategori:www.temperatur.nu]]<br /> [[Kategori:Mjukvara]]</div>

Elf98 https://wiki.temperatur.nu/index.php?title=API&diff=760 API 2021-02-24T10:09:32Z

<p>Elf98: /* Parametrar */</p> <hr /> <div>{| align="right"<br /> | __TOC__<br /> |}<br /> Det finns ett enkelt API för att hämta senaste temperaturerna från temperatur.nu.<br /> <br /> Aktuell API-version 1.16. <br /> <br /> Data returneras i XML-format eller json-format<br /> <br /> ==Support==<br /> För support på API-funktionen, använd [http://www.temperatur.nu/forum/forslag-feedback/diskusionstrad-for-api-funktionen-t1373.html Forumet på www.temperatur.nu].<br /> <br /> ==Villkor==<br /> *Mjukvaran skall skrivas på ett sådant sätt att APIet inte automatiskt belastas med samma fråga oftare än var femte minut från en enskild klient. Klientid som bryter mot detta villkor kan komma att blockeras. <br /> *Det måste mycket tydligt framgå att temperaturerna kommer från temperatur.nu.<br /> *Där så är möjligt skall temperaturerna vara länkar till temperatur.nu.<br /> *Temperatur.nus [[Logotype|logotype]] skall finnas i applikationen, gärna så den tydligt syns när programmet används. Om detta ej är möjligt kan logotypen placeras där inställningar för applikationen görs.<br /> *APIet får ej användas för att automatiskt samla in och lagra data längre än 24h.<br /> *I de fall applikationen kommer att kosta pengar för användaren krävs särskild överenskommelse med temperatur.nu. Kontakta [mailto:support@temperatur.nu support@temperatur.nu] för mer information.<br /> *Förfrågningar till APIet kan signeras, från och med version 1.11 är osignerade förfrågningar är begränsade till ca 20/timma per klientid. Denna begränsning kommer efter hand att läggas in även på de äldre versionerna. Maila [mailto:support@temperatur.nu support@temperatur.nu] för att att erhålla en signeringsnyckel för ditt klientid. När du ansöker om en signeringsnyckel måste du ange om du vill signera med sha1 eller md5. Läs mer om hur du signerar förfrågningarna längre ner på denna sida.<br /> *Du skall skriva en beskrivning av din mjukvara i denna Wiki. På så sätt kommer fler intresserade att hitta din applikation. Klienter som inte finns beskrivna i Wikin kan komma att blockeras. [[Mjukvaror_som_använder_APIet|Här finns en lista med kända klienter]]<br /> <br /> <br /> ==Kort beskrivning==<br /> APIet är tänkt att användas av de som skapar extern mjukvara, tex applikationer för Iphone och Android.<br /> Målet är att APIet skall vara lättförståeligt och lätt att använda - feedback från användarna är av stor vikt för att kunna utveckla APIet!<br /> <br /> ==Var finns APIet?==<br /> Du accessar APIet via http://api.temperatur.nu/tnu_1.<version>.php. ex: http://api.temperatur.nu/tnu_1.12.php<br /> <br /> ==Parametrar==<br /> Generellta parametrar<br /> <br /> {| border=1 class="wikitable"<br /> |-<br /> ! Parameter<br /> ! Beskrivning<br /> ! Kan ej användas med<br /> ! Introducerad i API-version<br /> |-<br /> | json<br /> | Om angiven returneras data i json-format i stället för xml<br /> | <br /> | 1.16<br /> |-<br /> | p<br /> | Anger för vilka orter data skall returneras - kommaseparerad lista. Utelämnas parametern returneras samtliga mätpunkter.<br /> | lat, lon, num<br /> | 1.0<br /> |-<br /> | dc<br /> | Anger om decimalkomma skall användas i stället för decimalpunkt i fälten <temperatur>, <lat>, <lon> och <dist>.<br /> |<br /> | 1.0<br /> |-<br /> | simple<br /> | Minimal output, returnerar endast <title>, <id> och <temp><br /> | verbose<br /> | 1.0<br /> |-<br /> | verbose<br /> | Returnerar alla fält för orten, se beskrivning nedan<br /> | simple<br /> | 1.0<br /> |-<br /> | coordinates<br /> | Visar koordinaterna för valda orter. Kan användas tillsammans med simple för att kunna positionera orter på en karta utan att behöva hämta alla fält.<br /> | verbose<br /> | 1.0<br /> |-<br /> | lat<br /> | Används tillsammans med lon och ev num. Det spelar inte någon roll om decimal- eller kommapunkt används. När dessa parametrar används returneras de num närmaste orterna, närmaste orten först.<br /> | p<br /> | 1.0<br /> |-<br /> | lon<br /> | Används tillsammans med lat och ev num. Det spelar inte någon roll om decimal- eller kommapunkt används. När dessa parametrar används returneras de num närmaste orterna, närmaste orten först..<br /> | p<br /> | 1.0<br /> |-<br /> | num<br /> | Används tillsammans med lat och lon. Anger hur många orter som skall returneras. Standard är 1 och max är 5 (10 från v 1.12).<br /> | p<br /> | 1.0<br /> |-<br /> | cb<br /> | CacheBust. Om denna parameter finns i urlen (&cb) kommer ett randomiserat värde att läggas till i slutet av graf-urlerna. Denna parameter kan användas för att se till att inte grafen cachas lokalt hos användaren eller i någon dåligt konfigurerad proxy mellan temperatur.nu och användaren.<br /> |<br /> | 1.8<br /> |-<br /> | cli <br /> | Skall användas för att identifiera vilken klient som hämtar data. Ex "cli=tnu_widget". Från mitten av 2011 kommer signering av urlerna krävas i kombination med cli. Läs mer längre ner.<br /> |<br /> | 1.1<br /> |-<br /> | sign<br /> | Skall APIet regelbundet måste URLerna signeras. Se information längre ner på denna sida.<br /> |<br /> | 1.0 (tillagd i efterhand)<br /> |}<br /> <br /> Parametrar som är relaterade till att hämta statistik<br /> {| border=1 class="wikitable"<br /> |-<br /> ! Parameter<br /> ! Beskrivning<br /> ! Kan ej användas med<br /> ! Introducerad i API-version<br /> |-<br /> | data<br /> | Används för att hämta rådata för en mätpunkt specificerade med variabeln p.<br /> | graph<br /> | 1.16<br /> |-<br /> | amm<br /> | Används för att hämta Average, Min & Max för upp till 5 (10 från v1.12) orter specificerade med variabeln p.<br /> | graph<br /> | 1.11<br /> |-<br /> | daily<br /> | Används för att hämta dygnsmedel samt lägsta och högsta temperatur per dygn. En mätpunkt specificerad med variabeln p.<br /> | graph<br /> | 1.15<br /> |-<br /> | span<br /> | Specificerar för vilket tidsperspektiv Average, Min & Max skall skapas. Giltiga värden är: 1day (standard), 1week, 1month, 1year.<br /> | start, end<br /> | 1.2<br /> |-<br /> | shift_g<br /> |Anger om daily skall visa äldre data. Exempel: om span är 1month och shift_g är 1 hämtas data för föregående månad. Standard är 0.<br /> | start, end<br /> | 1.15<br /> |-<br /> | start<br /> | Specificerar starttid för amm. Formatet är Y-m-d-H-i, ex 2011-01-30-12-31.<br /> | span<br /> | 1.11<br /> |-<br /> | end<br /> | Specificerar sluttid för amm. Formatet är Y-m-d-H-i, ex 2011-01-30-12-31. Standard är nuvarande tid<br /> | span<br /> | 1.11<br /> |}<br /> <br /> Parametrar som är relaterade till grafgenerering:<br /> {| border=1 class="wikitable"<br /> |-<br /> ! Parameter<br /> ! Beskrivning<br /> ! Kan ej användas med<br /> ! Introducerad i API-version<br /> |-<br /> | graph<br /> | Används för att generera en graf för upp till 5 orter specificerade med variabeln p. Anges variablen compare kommer orterna att läggas in i samma graf i stället för separata.<br /> | amm<br /> | 1.2<br /> |-<br /> | span<br /> | Specificerar för vilket tidsperspektiv grafer skall skapas. Giltiga värden är: 1day (standard), 1week, 1month, 1year.<br /> | start, end<br /> | 1.2<br /> |-<br /> | shift_g<br /> | Anger om grafen skall visa äldre data. Exempel: om span är 1day och shift_g är 1 visas en graf för igår, om shift_g är 2 visar grafen data för i förrgår etc. Standard är 0.<br /> | start, end<br /> | 1.5<br /> |-<br /> | start<br /> | Specificerar starttid för graph eller amm. Formatet är Y-m-d-H-i, ex 2011-01-30-12-31.<br /> | span, shift_g, history<br /> | 1.11<br /> |-<br /> | end<br /> | Specificerar sluttid för graph eller amm. Formatet är Y-m-d-H-i, ex 2011-01-30-12-31. Standard är nuvarande tid<br /> | span, shift_g, history<br /> | 1.11<br /> |-<br /> | history<br /> | Används för att i grafen lägga in föregående periods temperatur. Visas temperaturen för det senaste dygnet visas föregående 24h i en annan färg etc. Kan förklarliga skäl endast användas med variabeln graph.<br /> | start, end<br /> | 1.12<br /> |-<br /> | history_year<br /> | Används för att i grafen lägga in jämförelse med annat år. År anges med 4 siffror, ex 2013. Kan förklarliga skäl endast användas med variabeln graph.<br /> | start, end<br /> | 1.14<br /> |-<br /> | verbose_g<br /> | Visar min/max/medel/senaste värde i grafen. Visar även när data senast hämtades för den valda orten.<br /> |<br /> | 1.5<br /> |-<br /> | 1axis<br /> | Används för att endast visa temperaturskalan till vänster. Används med fördel i små grafer för att spara utrymme.<br /> |<br /> | 1.6<br /> |-<br /> | fontsize<br /> | Anger hur stor texten skall vara. Observera att värdet inte kan relateras till vanliga textstorlekar, du måste därför testa dig fram.<br /> |<br /> | 1.8<br /> |-<br /> | linewidth<br /> | Anger bredden på graflinjen. Giltiga värden 1 till 5. Även flyttal, ex 1.5, fungerar. Decimalkomma eller decimalpunkt spelar inte någon roll.<br /> |<br /> | 1.7<br /> |-<br /> | x<br /> | Specificerar hur bred grafen skall vara. Giltiga värden är 150-2500. 300 är standard.<br /> |<br /> | 1.2 (Tillåtna värden justerade i v 1.4,v 1.14)<br /> |-<br /> | y<br /> | Specificerar hur hög grafen skall vara. Giltiga värden är 125-2500. 200 är standard.<br /> |<br /> | 1.2 (Tillåtna värden justerade i v 1.4, v 1.14)<br /> |-<br /> | color<br /> | Anger vilken/vilka färger linjer i grafen skall ha, kommasepararead lista. Standard är #FF0000,#AADDAA,#FFCC00.<br /> |<br /> | 1.13<br /> |-<br /> | compare<br /> | Anger att order som skickats med p skall läggas in för jämförelse i samma graf. Om fler än tre orter anges måste även color definieras<br /> |<br /> | 1.13<br /> |}<br /> <br /> ==Beskrivning av returnerade fält==<br /> {| border=1 class="wikitable"<br /> |-<br /> ! Fält<br /> ! Beskrivning<br /> ! parameter som visar<br /> ! parameter som döljer<br /> ! Visas som standard<br /> ! Introducerad i API-version<br /> |-<br /> | <title><br /> | Mätpunktens namn på temperatur.nu<br /> | <br /> | <br /> | X<br /> | 1.0<br /> |-<br /> | <id><br /> | Mätpunktens id på temperatur.nu. Kan användas med parametern "p" för att hämta endast denna mätpunkts information<br /> |<br /> | simple<br /> | X<br /> | 1.0<br /> |-<br /> | <temp><br /> | Mätpunktens senaste temperatur. Om decimalkomma eller decimalpunkt skall användas styrs med parametern dc.<br /> |<br /> |<br /> | X<br /> | 1.0<br /> |-<br /> | <lat><br /> | Mätpunktens latitud i decimalt format. Om decimalkomma eller decimalpunkt skall användas styrs med parametern dc.<br /> | coordinates, verbose<br /> |<br /> |<br /> | 1.0<br /> |-<br /> | <lon><br /> | Mätpunktens longitud i decimalt format. Om decimalkomma eller decimalpunkt skall användas styrs med parametern dc.<br /> | coordinates, verbose<br /> |<br /> |<br /> | 1.0<br /> |-<br /> | <lastUpdate><br /> | Tidpunkt då informationen senast uppdaterades på temperatur.nu<br /> | verbose<br /> |<br /> |<br /> | 1.0<br /> |-<br /> | <kommun><br /> | Den kommun som mätpunkten ligger i.<br /> | verbose<br /> |<br /> |<br /> | 1.0<br /> |-<br /> | <lan><br /> | Det län som mätpunkten ligger i.<br /> | verbose<br /> |<br /> |<br /> | 1.0<br /> |-<br /> | <sourceInfo><br /> | En kort textsträng med information om vem som loggar temperaturen för mätpunkten<br /> | verbose<br /> |<br /> |<br /> | 1.8<br /> |-<br /> | <url><br /> | Url till mätpunktens temperatur och grafer på www.temperatur.nu<br /> | verbose<br /> |<br /> |<br /> | 1.0<br /> |-<br /> | <dist><br /> | Hur långt från de givna koordinaterna mätpunkten ligger. Enheten är kilometer. Om decimalkomma eller decimalpunkt skall användas styrs med parametern dc.<br /> | lat & lon<br /> | simple<br /> |<br /> | 1.0<br /> |-<br /> | <graph><br /> | Visar url till graph för orten. Observera att ny graf endast genereras när parametern graph används. Det går därför inte att lokalt cacha urlen i klienten. <br /> | graph (x, y, span, verbose_g, shift_g)<br /> |<br /> |<br /> | 1.2<br /> |-<br /> | <ClientVersion><br /> | Visar vilken den senaste släppta klientversionen är. Kan med fördel användas för att kontrollera om det finns någon uppdatering till klientmjukvaran.<br /> | version<br /> |<br /> |<br /> | 1.10<br /> |-<br /> | <ClientVersionSet><br /> | Visar status i samband med att informationen om klientversionen uppdaterats.<br /> | version_update<br /> |<br /> |<br /> | 1.10<br /> |-<br /> | <daily><br /> | Har underliggande fält <date>, <average>, <min>, <max> som representerar data för dygn angivet i fältet date. Dessa fält returneras när parametern daily används för att hämta statisk för flera dygn<br /> | daily, span, start, end, shift_g<br /> |<br /> |<br /> | 1.15<br /> |-<br /> | <ammRange><br /> | Visar för vilket tidsperspektiv amm (medel/min/max) har hämtats<br /> | amm, span, start, end, shift_g<br /> |<br /> |<br /> | 1.11<br /> |-<br /> | <average><br /> | Medeltemperatur i specificerat tidsperspektiv<br /> | amm, span, start, end, shift_g<br /> |<br /> |<br /> | 1.11<br /> |-<br /> | <min><br /> | Den minsta temperaturen i specificerat tidsperspektiv<br /> | amm, span, start, end, shift_g<br /> |<br /> |<br /> | 1.11<br /> |-<br /> | <minTime><br /> | Vid vilken tidpunkt <min> inträffade<br /> | amm, span, start, end, shift_g<br /> |<br /> |<br /> | 1.11<br /> |-<br /> | <max><br /> | Den högsta temperaturen i specificerat tidsperspektiv<br /> | amm, span, start, end, shift_g<br /> |<br /> |<br /> | 1.11<br /> |-<br /> | <maxTime><br /> | Vid vilken tidpunkt <max> inträffade<br /> | amm, span, start, end, shift_g<br /> |<br /> |<br /> | 1.11<br /> <br /> |}<br /> <br /> ==Exempel==<br /> <br /> Så här kan resultatet från en förfrågan på http://api.temperatur.nu/tnu_1.12.php?p=linkoping&verbose&cli=test_app se ut:<br /> <?xml version='1.0' encoding='iso-8859-1'?><br /> <rss version="2.0"><br /> <channel><br /> <title>Temperatur.nu API 1.12 - Din url är inte korrekt signerad, clientnyckeln kan tillfälligt blockeras - /tnu_1.12.php</title><br /> <link>http://wiki.temperatur.nu/index.php/Api</link><br /> <item><br /> <title>Linköping/Centrum</title><br /> <id>linkoping</id><br /> <temp>9.3</temp><br /> <lat>58.414297</lat><br /> <lon>15.628788</lon><br /> <lastUpdate>2011-11-24 08:51:25</lastUpdate><br /> <kommun>Linköping</kommun><br /> <lan>Östergötlands län</lan><br /> <sourceInfo>Temperaturdata från Stångå Hotell.</sourceInfo><br /> <url>http://www.temperatur.nu/linkoping.html</url><br /> </item><br /> </channel><br /> </rss><br /> <br /> <br /> Så här kan resultatet från en förfrågan på http://api.temperatur.nu/tnu_1.12.php?lat=58.376761&lon=15.562916&num=3&graph&cli=test_app2 se ut:<br /> <?xml version='1.0' encoding='iso-8859-1'?><br /> <rss version="2.0"><br /> <channel><br /> <title>Temperatur.nu API 1.12 - Din url är inte korrekt signerad, clientnyckeln kan tillfälligt blockeras - /tnu_1.12.php</title><br /> <link>http://wiki.temperatur.nu/index.php/Api</link><br /> <item><br /> <title>Linköping/Jägarvallen</title><br /> <id>jagarvallen</id><br /> <temp>7.8</temp><br /> <dist>2.5</dist><br /> <graph>http://www2.timg.nu/graph/jagarvallen-1day-300-200-0-0-0-1-8-n.png</graph><br /> </item><br /> <item><br /> <title>Linköping/Malmen (METAR)</title><br /> <id>malmen</id><br /> <temp>8.3</temp><br /> <dist>2.8</dist><br /> <graph>http://www2.timg.nu/graph/malmen-1day-300-200-0-0-0-1-8-n.png</graph><br /> </item><br /> <item><br /> <title>Linköping/Skäggetorp</title><br /> <id>skaggetorp</id><br /> <temp>9.1</temp><br /> <dist>5.2</dist><br /> <graph>http://www2.timg.nu/graph/skaggetorp-1day-300-200-0-0-0-1-8-n.png</graph><br /> </item><br /> </channel><br /> </rss><br /> <br /> <br /> ==Signering av URLer==<br /> Förfrågningar till APIet kan signeras. Från och med version 1.11 är antalet osignerade förfrågningar begränsade till 20 per timma. Osignerade förfrågningar kommer i framtiden att begränsas för alla api-versioner. Skriver du en privat tillämpning kan du använda APIet utan att signera URLerna.<br /> <br /> Signeringen går till så här:<br /> <br /> 1. Skapa din url som vanligt.<br /> <br /> 2. Beräkna md5-/sha1-summan av urlen (utan http://) med "+clientnyckel" tillagd på slutet. Klientnyckel erhålls efter att ha mailat [mailto:support@temperatur.nu support@temperatur.nu]<br /> <br /> 3. I slutet av urlen lägger du sedan till &sign=md5-/sha1-summa<br /> <br /> I php kan det tex se ut så här om du har en signeringsnyckel för md5:<br /> $cli_key="XXXXXXXXXXXXXXXXXXXXXXXXX";<br /> $url="api.temperatur.nu/tnu_1.9.php?p=linkoping&cli=testapp"<br /> $sign=md5($url."+".$cli_key);<br /> $signed_url=$url."&sign=".$sign;<br /> <br /> I den returnerade xml-filen kan du i det första title-fältet se om förfrågan är korrekt signerad.<br /> <br /> [http://www.fileformat.info/tool/hash.htm?text= fileformat.info] är en mycket bra sida för att verifiera att de sha1-/md5-summor du tagit fram stämmer.<br /> <br /> ==Historik/ändringslogg==<br /> 2010-05-04 - Version 1.0<br /> Första releasen.<br /> <br /> 2010-05-13 - Version 1.1<br /> Variabeln cli tillagd.<br /> <br /> 2010-05-19 - Version 1.2<br /> Stöd för att hämta grafer<br /> <br /> 2010-06-09 - Version 1.3<br /> Bugfix som fixar en bugg introducerad i 1.2 (det gick inte att hämta alla orter genom att skippa variabeln p).<br /> <br /> 2010-08-04 - Version 1.4<br /> Värden för x och y justerade. Parametern cli krävs för att apiet skall returnera data.<br /> <br /> 2010-09-01 - Version 1.5<br /> Parametrar för att via mer info i grafen. Parametrar för att visa grafer för i går, förra veckan, 2 år sedan etc.<br /> <br /> 2010-09-01 - Version 1.6<br /> Parameter för att ange om 1 eller 2 y-axlar skall visas.<br /> <br /> 2010-11-22 - Version 1.7<br /> Möjlighet att välja hur tjock graflinjen skall vara.<br /> <br /> 2010-12-19 - Version 1.8<br /> CacheBust-funktion, möjlighet att ändra textstorlek samt information om vem som loggar temperaturen när verbose är specat.<br /> <br /> 2011-01-13 - Version 1.9<br /> Signeringsfunktion inlagd. Signeringsfunktionen kommer från mitten av 2011 krävas för alla tillämpningar och och kommer successivt att läggas in i alla versioner av apiet.<br /> <br /> 2011-01-17 - Version 1.10<br /> Möjlighet att via Apiet hantera informaion gällande den senaste tillgängliga klientversionen.<br /> <br /> 2011-01-30 - Version 1.11<br /> Mer flexibel specificering av tidsperspektiv för grafer. amm - möjlighet att hämta medel/min/max i ett valfritt tidsperspektiv, antalet osignerade accesser begränsat i denna version.<br /> <br /> 2011-10-08 - Version 1.12<br /> Variabeln history tillagd. Visar föregående periods temperatur i grafer.<br /> <br /> 2012-05-04 - Version 1.13<br /> Variablerna compare och color angivna, gör det möjligt att jämföra flera orter i samma graf samt helt styra vilka färger linjerna i graferna skall ha. color kan sättas även för vanliga grafer.<br /> <br /> 2013 - Version 1.14<br /> Parametern history_year som används för att jämföra data med tidigare år. Buggfixar<br /> <br /> 2014-01-26 - Version 1.15<br /> Parametern daily. Används för att hämta dygnsmedel i ett specificerat tidsspann.<br /> <br /> [[Kategori:www.temperatur.nu]]<br /> [[Kategori:Mjukvara]]</div>

Elf98 https://wiki.temperatur.nu/index.php?title=API&diff=759 API 2021-02-24T10:06:15Z

<p>Elf98: /* Parametrar */</p> <hr /> <div>{| align="right"<br /> | __TOC__<br /> |}<br /> Det finns ett enkelt API för att hämta senaste temperaturerna från temperatur.nu.<br /> <br /> Aktuell API-version 1.16. <br /> <br /> Data returneras i XML-format eller json-format<br /> <br /> ==Support==<br /> För support på API-funktionen, använd [http://www.temperatur.nu/forum/forslag-feedback/diskusionstrad-for-api-funktionen-t1373.html Forumet på www.temperatur.nu].<br /> <br /> ==Villkor==<br /> *Mjukvaran skall skrivas på ett sådant sätt att APIet inte automatiskt belastas med samma fråga oftare än var femte minut från en enskild klient. Klientid som bryter mot detta villkor kan komma att blockeras. <br /> *Det måste mycket tydligt framgå att temperaturerna kommer från temperatur.nu.<br /> *Där så är möjligt skall temperaturerna vara länkar till temperatur.nu.<br /> *Temperatur.nus [[Logotype|logotype]] skall finnas i applikationen, gärna så den tydligt syns när programmet används. Om detta ej är möjligt kan logotypen placeras där inställningar för applikationen görs.<br /> *APIet får ej användas för att automatiskt samla in och lagra data längre än 24h.<br /> *I de fall applikationen kommer att kosta pengar för användaren krävs särskild överenskommelse med temperatur.nu. Kontakta [mailto:support@temperatur.nu support@temperatur.nu] för mer information.<br /> *Förfrågningar till APIet kan signeras, från och med version 1.11 är osignerade förfrågningar är begränsade till ca 20/timma per klientid. Denna begränsning kommer efter hand att läggas in även på de äldre versionerna. Maila [mailto:support@temperatur.nu support@temperatur.nu] för att att erhålla en signeringsnyckel för ditt klientid. När du ansöker om en signeringsnyckel måste du ange om du vill signera med sha1 eller md5. Läs mer om hur du signerar förfrågningarna längre ner på denna sida.<br /> *Du skall skriva en beskrivning av din mjukvara i denna Wiki. På så sätt kommer fler intresserade att hitta din applikation. Klienter som inte finns beskrivna i Wikin kan komma att blockeras. [[Mjukvaror_som_använder_APIet|Här finns en lista med kända klienter]]<br /> <br /> <br /> ==Kort beskrivning==<br /> APIet är tänkt att användas av de som skapar extern mjukvara, tex applikationer för Iphone och Android.<br /> Målet är att APIet skall vara lättförståeligt och lätt att använda - feedback från användarna är av stor vikt för att kunna utveckla APIet!<br /> <br /> ==Var finns APIet?==<br /> Du accessar APIet via http://api.temperatur.nu/tnu_1.<version>.php. ex: http://api.temperatur.nu/tnu_1.12.php<br /> <br /> ==Parametrar==<br /> Generellta parametrar<br /> <br /> {| border=1 class="wikitable"<br /> |-<br /> ! Parameter<br /> ! Beskrivning<br /> ! Kan ej användas med<br /> ! Introducerad i API-version<br /> |-<br /> | json<br /> | Om angiven returneras data i json-format i stället för xml<br /> | <br /> | 1.16<br /> |-<br /> | p<br /> | Anger för vilka orter data skall returneras - kommaseparerad lista. Utelämnas parametern returneras samtliga mätpunkter.<br /> | lat, lon, num<br /> | 1.0<br /> |-<br /> | dc<br /> | Anger om decimalkomma skall användas i stället för decimalpunkt i fälten <temperatur>, <lat>, <lon> och <dist>.<br /> |<br /> | 1.0<br /> |-<br /> | simple<br /> | Minimal output, returnerar endast <title>, <id> och <temp><br /> | verbose<br /> | 1.0<br /> |-<br /> | verbose<br /> | Returnerar alla fält för orten, se beskrivning nedan<br /> | simple<br /> | 1.0<br /> |-<br /> | coordinates<br /> | Visar koordinaterna för valda orter. Kan användas tillsammans med simple för att kunna positionera orter på en karta utan att behöva hämta alla fält.<br /> | verbose<br /> | 1.0<br /> |-<br /> | lat<br /> | Används tillsammans med lon och ev num. Det spelar inte någon roll om decimal- eller kommapunkt används. När dessa parametrar används returneras de num närmaste orterna, närmaste orten först.<br /> | p<br /> | 1.0<br /> |-<br /> | lon<br /> | Används tillsammans med lat och ev num. Det spelar inte någon roll om decimal- eller kommapunkt används. När dessa parametrar används returneras de num närmaste orterna, närmaste orten först..<br /> | p<br /> | 1.0<br /> |-<br /> | num<br /> | Används tillsammans med lat och lon. Anger hur många orter som skall returneras. Standard är 1 och max är 5 (10 från v 1.12).<br /> | p<br /> | 1.0<br /> |-<br /> | cb<br /> | CacheBust. Om denna parameter finns i urlen (&cb) kommer ett randomiserat värde att läggas till i slutet av graf-urlerna. Denna parameter kan användas för att se till att inte grafen cachas lokalt hos användaren eller i någon dåligt konfigurerad proxy mellan temperatur.nu och användaren.<br /> |<br /> | 1.8<br /> |-<br /> | cli <br /> | Skall användas för att identifiera vilken klient som hämtar data. Ex "cli=tnu_widget". Från mitten av 2011 kommer signering av urlerna krävas i kombination med cli. Läs mer längre ner.<br /> |<br /> | 1.1<br /> |-<br /> | sign<br /> | Skall APIet regelbundet måste URLerna signeras. Se information längre ner på denna sida.<br /> |<br /> | 1.0 (tillagd i efterhand)<br /> |}<br /> <br /> Parametrar som är relaterade till att hämta statistik<br /> {| border=1 class="wikitable"<br /> |-<br /> ! Parameter<br /> ! Beskrivning<br /> ! Kan ej användas med<br /> ! Introducerad i API-version<br /> |-<br /> | amm<br /> | Används för att hämta Average, Min & Max för upp till 5 (10 från v1.12) orter specificerade med variabeln p.<br /> | graph<br /> | 1.11<br /> |-<br /> | daily<br /> | Används för att hämta dygnsmedel samt lägsta och högsta temperatur per dygn. En mätpunkt spcificerad med variabeln p.<br /> | graph<br /> | 1.15<br /> |-<br /> | span<br /> | Specificerar för vilket tidsperspektiv Average, Min & Max skall skapas. Giltiga värden är: 1day (standard), 1week, 1month, 1year.<br /> | start, end<br /> | 1.2<br /> |-<br /> | shift_g<br /> |Anger om daily skall visa äldre data. Exempel: om span är 1month och shift_g är 1 hämtas data för föregående månad. Standard är 0.<br /> | start, end<br /> | 1.15<br /> |-<br /> | start<br /> | Specificerar starttid för amm. Formatet är Y-m-d-H-i, ex 2011-01-30-12-31.<br /> | span<br /> | 1.11<br /> |-<br /> | end<br /> | Specificerar sluttid för amm. Formatet är Y-m-d-H-i, ex 2011-01-30-12-31. Standard är nuvarande tid<br /> | span<br /> | 1.11<br /> |}<br /> <br /> Parametrar som är relaterade till grafgenerering:<br /> {| border=1 class="wikitable"<br /> |-<br /> ! Parameter<br /> ! Beskrivning<br /> ! Kan ej användas med<br /> ! Introducerad i API-version<br /> |-<br /> | graph<br /> | Används för att generera en graf för upp till 5 orter specificerade med variabeln p. Anges variablen compare kommer orterna att läggas in i samma graf i stället för separata.<br /> | amm<br /> | 1.2<br /> |-<br /> | span<br /> | Specificerar för vilket tidsperspektiv grafer skall skapas. Giltiga värden är: 1day (standard), 1week, 1month, 1year.<br /> | start, end<br /> | 1.2<br /> |-<br /> | shift_g<br /> | Anger om grafen skall visa äldre data. Exempel: om span är 1day och shift_g är 1 visas en graf för igår, om shift_g är 2 visar grafen data för i förrgår etc. Standard är 0.<br /> | start, end<br /> | 1.5<br /> |-<br /> | start<br /> | Specificerar starttid för graph eller amm. Formatet är Y-m-d-H-i, ex 2011-01-30-12-31.<br /> | span, shift_g, history<br /> | 1.11<br /> |-<br /> | end<br /> | Specificerar sluttid för graph eller amm. Formatet är Y-m-d-H-i, ex 2011-01-30-12-31. Standard är nuvarande tid<br /> | span, shift_g, history<br /> | 1.11<br /> |-<br /> | history<br /> | Används för att i grafen lägga in föregående periods temperatur. Visas temperaturen för det senaste dygnet visas föregående 24h i en annan färg etc. Kan förklarliga skäl endast användas med variabeln graph.<br /> | start, end<br /> | 1.12<br /> |-<br /> | history_year<br /> | Används för att i grafen lägga in jämförelse med annat år. År anges med 4 siffror, ex 2013. Kan förklarliga skäl endast användas med variabeln graph.<br /> | start, end<br /> | 1.14<br /> |-<br /> | verbose_g<br /> | Visar min/max/medel/senaste värde i grafen. Visar även när data senast hämtades för den valda orten.<br /> |<br /> | 1.5<br /> |-<br /> | 1axis<br /> | Används för att endast visa temperaturskalan till vänster. Används med fördel i små grafer för att spara utrymme.<br /> |<br /> | 1.6<br /> |-<br /> | fontsize<br /> | Anger hur stor texten skall vara. Observera att värdet inte kan relateras till vanliga textstorlekar, du måste därför testa dig fram.<br /> |<br /> | 1.8<br /> |-<br /> | linewidth<br /> | Anger bredden på graflinjen. Giltiga värden 1 till 5. Även flyttal, ex 1.5, fungerar. Decimalkomma eller decimalpunkt spelar inte någon roll.<br /> |<br /> | 1.7<br /> |-<br /> | x<br /> | Specificerar hur bred grafen skall vara. Giltiga värden är 150-2500. 300 är standard.<br /> |<br /> | 1.2 (Tillåtna värden justerade i v 1.4,v 1.14)<br /> |-<br /> | y<br /> | Specificerar hur hög grafen skall vara. Giltiga värden är 125-2500. 200 är standard.<br /> |<br /> | 1.2 (Tillåtna värden justerade i v 1.4, v 1.14)<br /> |-<br /> | color<br /> | Anger vilken/vilka färger linjer i grafen skall ha, kommasepararead lista. Standard är #FF0000,#AADDAA,#FFCC00.<br /> |<br /> | 1.13<br /> |-<br /> | compare<br /> | Anger att order som skickats med p skall läggas in för jämförelse i samma graf. Om fler än tre orter anges måste även color definieras<br /> |<br /> | 1.13<br /> |}<br /> <br /> ==Beskrivning av returnerade fält==<br /> {| border=1 class="wikitable"<br /> |-<br /> ! Fält<br /> ! Beskrivning<br /> ! parameter som visar<br /> ! parameter som döljer<br /> ! Visas som standard<br /> ! Introducerad i API-version<br /> |-<br /> | <title><br /> | Mätpunktens namn på temperatur.nu<br /> | <br /> | <br /> | X<br /> | 1.0<br /> |-<br /> | <id><br /> | Mätpunktens id på temperatur.nu. Kan användas med parametern "p" för att hämta endast denna mätpunkts information<br /> |<br /> | simple<br /> | X<br /> | 1.0<br /> |-<br /> | <temp><br /> | Mätpunktens senaste temperatur. Om decimalkomma eller decimalpunkt skall användas styrs med parametern dc.<br /> |<br /> |<br /> | X<br /> | 1.0<br /> |-<br /> | <lat><br /> | Mätpunktens latitud i decimalt format. Om decimalkomma eller decimalpunkt skall användas styrs med parametern dc.<br /> | coordinates, verbose<br /> |<br /> |<br /> | 1.0<br /> |-<br /> | <lon><br /> | Mätpunktens longitud i decimalt format. Om decimalkomma eller decimalpunkt skall användas styrs med parametern dc.<br /> | coordinates, verbose<br /> |<br /> |<br /> | 1.0<br /> |-<br /> | <lastUpdate><br /> | Tidpunkt då informationen senast uppdaterades på temperatur.nu<br /> | verbose<br /> |<br /> |<br /> | 1.0<br /> |-<br /> | <kommun><br /> | Den kommun som mätpunkten ligger i.<br /> | verbose<br /> |<br /> |<br /> | 1.0<br /> |-<br /> | <lan><br /> | Det län som mätpunkten ligger i.<br /> | verbose<br /> |<br /> |<br /> | 1.0<br /> |-<br /> | <sourceInfo><br /> | En kort textsträng med information om vem som loggar temperaturen för mätpunkten<br /> | verbose<br /> |<br /> |<br /> | 1.8<br /> |-<br /> | <url><br /> | Url till mätpunktens temperatur och grafer på www.temperatur.nu<br /> | verbose<br /> |<br /> |<br /> | 1.0<br /> |-<br /> | <dist><br /> | Hur långt från de givna koordinaterna mätpunkten ligger. Enheten är kilometer. Om decimalkomma eller decimalpunkt skall användas styrs med parametern dc.<br /> | lat & lon<br /> | simple<br /> |<br /> | 1.0<br /> |-<br /> | <graph><br /> | Visar url till graph för orten. Observera att ny graf endast genereras när parametern graph används. Det går därför inte att lokalt cacha urlen i klienten. <br /> | graph (x, y, span, verbose_g, shift_g)<br /> |<br /> |<br /> | 1.2<br /> |-<br /> | <ClientVersion><br /> | Visar vilken den senaste släppta klientversionen är. Kan med fördel användas för att kontrollera om det finns någon uppdatering till klientmjukvaran.<br /> | version<br /> |<br /> |<br /> | 1.10<br /> |-<br /> | <ClientVersionSet><br /> | Visar status i samband med att informationen om klientversionen uppdaterats.<br /> | version_update<br /> |<br /> |<br /> | 1.10<br /> |-<br /> | <daily><br /> | Har underliggande fält <date>, <average>, <min>, <max> som representerar data för dygn angivet i fältet date. Dessa fält returneras när parametern daily används för att hämta statisk för flera dygn<br /> | daily, span, start, end, shift_g<br /> |<br /> |<br /> | 1.15<br /> |-<br /> | <ammRange><br /> | Visar för vilket tidsperspektiv amm (medel/min/max) har hämtats<br /> | amm, span, start, end, shift_g<br /> |<br /> |<br /> | 1.11<br /> |-<br /> | <average><br /> | Medeltemperatur i specificerat tidsperspektiv<br /> | amm, span, start, end, shift_g<br /> |<br /> |<br /> | 1.11<br /> |-<br /> | <min><br /> | Den minsta temperaturen i specificerat tidsperspektiv<br /> | amm, span, start, end, shift_g<br /> |<br /> |<br /> | 1.11<br /> |-<br /> | <minTime><br /> | Vid vilken tidpunkt <min> inträffade<br /> | amm, span, start, end, shift_g<br /> |<br /> |<br /> | 1.11<br /> |-<br /> | <max><br /> | Den högsta temperaturen i specificerat tidsperspektiv<br /> | amm, span, start, end, shift_g<br /> |<br /> |<br /> | 1.11<br /> |-<br /> | <maxTime><br /> | Vid vilken tidpunkt <max> inträffade<br /> | amm, span, start, end, shift_g<br /> |<br /> |<br /> | 1.11<br /> <br /> |}<br /> <br /> ==Exempel==<br /> <br /> Så här kan resultatet från en förfrågan på http://api.temperatur.nu/tnu_1.12.php?p=linkoping&verbose&cli=test_app se ut:<br /> <?xml version='1.0' encoding='iso-8859-1'?><br /> <rss version="2.0"><br /> <channel><br /> <title>Temperatur.nu API 1.12 - Din url är inte korrekt signerad, clientnyckeln kan tillfälligt blockeras - /tnu_1.12.php</title><br /> <link>http://wiki.temperatur.nu/index.php/Api</link><br /> <item><br /> <title>Linköping/Centrum</title><br /> <id>linkoping</id><br /> <temp>9.3</temp><br /> <lat>58.414297</lat><br /> <lon>15.628788</lon><br /> <lastUpdate>2011-11-24 08:51:25</lastUpdate><br /> <kommun>Linköping</kommun><br /> <lan>Östergötlands län</lan><br /> <sourceInfo>Temperaturdata från Stångå Hotell.</sourceInfo><br /> <url>http://www.temperatur.nu/linkoping.html</url><br /> </item><br /> </channel><br /> </rss><br /> <br /> <br /> Så här kan resultatet från en förfrågan på http://api.temperatur.nu/tnu_1.12.php?lat=58.376761&lon=15.562916&num=3&graph&cli=test_app2 se ut:<br /> <?xml version='1.0' encoding='iso-8859-1'?><br /> <rss version="2.0"><br /> <channel><br /> <title>Temperatur.nu API 1.12 - Din url är inte korrekt signerad, clientnyckeln kan tillfälligt blockeras - /tnu_1.12.php</title><br /> <link>http://wiki.temperatur.nu/index.php/Api</link><br /> <item><br /> <title>Linköping/Jägarvallen</title><br /> <id>jagarvallen</id><br /> <temp>7.8</temp><br /> <dist>2.5</dist><br /> <graph>http://www2.timg.nu/graph/jagarvallen-1day-300-200-0-0-0-1-8-n.png</graph><br /> </item><br /> <item><br /> <title>Linköping/Malmen (METAR)</title><br /> <id>malmen</id><br /> <temp>8.3</temp><br /> <dist>2.8</dist><br /> <graph>http://www2.timg.nu/graph/malmen-1day-300-200-0-0-0-1-8-n.png</graph><br /> </item><br /> <item><br /> <title>Linköping/Skäggetorp</title><br /> <id>skaggetorp</id><br /> <temp>9.1</temp><br /> <dist>5.2</dist><br /> <graph>http://www2.timg.nu/graph/skaggetorp-1day-300-200-0-0-0-1-8-n.png</graph><br /> </item><br /> </channel><br /> </rss><br /> <br /> <br /> ==Signering av URLer==<br /> Förfrågningar till APIet kan signeras. Från och med version 1.11 är antalet osignerade förfrågningar begränsade till 20 per timma. Osignerade förfrågningar kommer i framtiden att begränsas för alla api-versioner. Skriver du en privat tillämpning kan du använda APIet utan att signera URLerna.<br /> <br /> Signeringen går till så här:<br /> <br /> 1. Skapa din url som vanligt.<br /> <br /> 2. Beräkna md5-/sha1-summan av urlen (utan http://) med "+clientnyckel" tillagd på slutet. Klientnyckel erhålls efter att ha mailat [mailto:support@temperatur.nu support@temperatur.nu]<br /> <br /> 3. I slutet av urlen lägger du sedan till &sign=md5-/sha1-summa<br /> <br /> I php kan det tex se ut så här om du har en signeringsnyckel för md5:<br /> $cli_key="XXXXXXXXXXXXXXXXXXXXXXXXX";<br /> $url="api.temperatur.nu/tnu_1.9.php?p=linkoping&cli=testapp"<br /> $sign=md5($url."+".$cli_key);<br /> $signed_url=$url."&sign=".$sign;<br /> <br /> I den returnerade xml-filen kan du i det första title-fältet se om förfrågan är korrekt signerad.<br /> <br /> [http://www.fileformat.info/tool/hash.htm?text= fileformat.info] är en mycket bra sida för att verifiera att de sha1-/md5-summor du tagit fram stämmer.<br /> <br /> ==Historik/ändringslogg==<br /> 2010-05-04 - Version 1.0<br /> Första releasen.<br /> <br /> 2010-05-13 - Version 1.1<br /> Variabeln cli tillagd.<br /> <br /> 2010-05-19 - Version 1.2<br /> Stöd för att hämta grafer<br /> <br /> 2010-06-09 - Version 1.3<br /> Bugfix som fixar en bugg introducerad i 1.2 (det gick inte att hämta alla orter genom att skippa variabeln p).<br /> <br /> 2010-08-04 - Version 1.4<br /> Värden för x och y justerade. Parametern cli krävs för att apiet skall returnera data.<br /> <br /> 2010-09-01 - Version 1.5<br /> Parametrar för att via mer info i grafen. Parametrar för att visa grafer för i går, förra veckan, 2 år sedan etc.<br /> <br /> 2010-09-01 - Version 1.6<br /> Parameter för att ange om 1 eller 2 y-axlar skall visas.<br /> <br /> 2010-11-22 - Version 1.7<br /> Möjlighet att välja hur tjock graflinjen skall vara.<br /> <br /> 2010-12-19 - Version 1.8<br /> CacheBust-funktion, möjlighet att ändra textstorlek samt information om vem som loggar temperaturen när verbose är specat.<br /> <br /> 2011-01-13 - Version 1.9<br /> Signeringsfunktion inlagd. Signeringsfunktionen kommer från mitten av 2011 krävas för alla tillämpningar och och kommer successivt att läggas in i alla versioner av apiet.<br /> <br /> 2011-01-17 - Version 1.10<br /> Möjlighet att via Apiet hantera informaion gällande den senaste tillgängliga klientversionen.<br /> <br /> 2011-01-30 - Version 1.11<br /> Mer flexibel specificering av tidsperspektiv för grafer. amm - möjlighet att hämta medel/min/max i ett valfritt tidsperspektiv, antalet osignerade accesser begränsat i denna version.<br /> <br /> 2011-10-08 - Version 1.12<br /> Variabeln history tillagd. Visar föregående periods temperatur i grafer.<br /> <br /> 2012-05-04 - Version 1.13<br /> Variablerna compare och color angivna, gör det möjligt att jämföra flera orter i samma graf samt helt styra vilka färger linjerna i graferna skall ha. color kan sättas även för vanliga grafer.<br /> <br /> 2013 - Version 1.14<br /> Parametern history_year som används för att jämföra data med tidigare år. Buggfixar<br /> <br /> 2014-01-26 - Version 1.15<br /> Parametern daily. Används för att hämta dygnsmedel i ett specificerat tidsspann.<br /> <br /> [[Kategori:www.temperatur.nu]]<br /> [[Kategori:Mjukvara]]</div>

Elf98 https://wiki.temperatur.nu/index.php?title=API&diff=758 API 2021-02-24T10:04:56Z

<p>Elf98: </p> <hr /> <div>{| align="right"<br /> | __TOC__<br /> |}<br /> Det finns ett enkelt API för att hämta senaste temperaturerna från temperatur.nu.<br /> <br /> Aktuell API-version 1.16. <br /> <br /> Data returneras i XML-format eller json-format<br /> <br /> ==Support==<br /> För support på API-funktionen, använd [http://www.temperatur.nu/forum/forslag-feedback/diskusionstrad-for-api-funktionen-t1373.html Forumet på www.temperatur.nu].<br /> <br /> ==Villkor==<br /> *Mjukvaran skall skrivas på ett sådant sätt att APIet inte automatiskt belastas med samma fråga oftare än var femte minut från en enskild klient. Klientid som bryter mot detta villkor kan komma att blockeras. <br /> *Det måste mycket tydligt framgå att temperaturerna kommer från temperatur.nu.<br /> *Där så är möjligt skall temperaturerna vara länkar till temperatur.nu.<br /> *Temperatur.nus [[Logotype|logotype]] skall finnas i applikationen, gärna så den tydligt syns när programmet används. Om detta ej är möjligt kan logotypen placeras där inställningar för applikationen görs.<br /> *APIet får ej användas för att automatiskt samla in och lagra data längre än 24h.<br /> *I de fall applikationen kommer att kosta pengar för användaren krävs särskild överenskommelse med temperatur.nu. Kontakta [mailto:support@temperatur.nu support@temperatur.nu] för mer information.<br /> *Förfrågningar till APIet kan signeras, från och med version 1.11 är osignerade förfrågningar är begränsade till ca 20/timma per klientid. Denna begränsning kommer efter hand att läggas in även på de äldre versionerna. Maila [mailto:support@temperatur.nu support@temperatur.nu] för att att erhålla en signeringsnyckel för ditt klientid. När du ansöker om en signeringsnyckel måste du ange om du vill signera med sha1 eller md5. Läs mer om hur du signerar förfrågningarna längre ner på denna sida.<br /> *Du skall skriva en beskrivning av din mjukvara i denna Wiki. På så sätt kommer fler intresserade att hitta din applikation. Klienter som inte finns beskrivna i Wikin kan komma att blockeras. [[Mjukvaror_som_använder_APIet|Här finns en lista med kända klienter]]<br /> <br /> <br /> ==Kort beskrivning==<br /> APIet är tänkt att användas av de som skapar extern mjukvara, tex applikationer för Iphone och Android.<br /> Målet är att APIet skall vara lättförståeligt och lätt att använda - feedback från användarna är av stor vikt för att kunna utveckla APIet!<br /> <br /> ==Var finns APIet?==<br /> Du accessar APIet via http://api.temperatur.nu/tnu_1.<version>.php. ex: http://api.temperatur.nu/tnu_1.12.php<br /> <br /> ==Parametrar==<br /> Generellta parametrar<br /> <br /> {| border=1 class="wikitable"<br /> |-<br /> ! Parameter<br /> ! Beskrivning<br /> ! Kan ej användas med<br /> ! Introducerad i API-version<br /> |-<br /> | p<br /> | Anger för vilka orter data skall returneras - kommaseparerad lista. Utelämnas parametern returneras samtliga mätpunkter.<br /> | lat, lon, num<br /> | 1.0<br /> |-<br /> | dc<br /> | Anger om decimalkomma skall användas i stället för decimalpunkt i fälten <temperatur>, <lat>, <lon> och <dist>.<br /> |<br /> | 1.0<br /> |-<br /> | simple<br /> | Minimal output, returnerar endast <title>, <id> och <temp><br /> | verbose<br /> | 1.0<br /> |-<br /> | verbose<br /> | Returnerar alla fält för orten, se beskrivning nedan<br /> | simple<br /> | 1.0<br /> |-<br /> | coordinates<br /> | Visar koordinaterna för valda orter. Kan användas tillsammans med simple för att kunna positionera orter på en karta utan att behöva hämta alla fält.<br /> | verbose<br /> | 1.0<br /> |-<br /> | lat<br /> | Används tillsammans med lon och ev num. Det spelar inte någon roll om decimal- eller kommapunkt används. När dessa parametrar används returneras de num närmaste orterna, närmaste orten först.<br /> | p<br /> | 1.0<br /> |-<br /> | lon<br /> | Används tillsammans med lat och ev num. Det spelar inte någon roll om decimal- eller kommapunkt används. När dessa parametrar används returneras de num närmaste orterna, närmaste orten först..<br /> | p<br /> | 1.0<br /> |-<br /> | num<br /> | Används tillsammans med lat och lon. Anger hur många orter som skall returneras. Standard är 1 och max är 5 (10 från v 1.12).<br /> | p<br /> | 1.0<br /> |-<br /> | cb<br /> | CacheBust. Om denna parameter finns i urlen (&cb) kommer ett randomiserat värde att läggas till i slutet av graf-urlerna. Denna parameter kan användas för att se till att inte grafen cachas lokalt hos användaren eller i någon dåligt konfigurerad proxy mellan temperatur.nu och användaren.<br /> |<br /> | 1.8<br /> |-<br /> | cli <br /> | Skall användas för att identifiera vilken klient som hämtar data. Ex "cli=tnu_widget". Från mitten av 2011 kommer signering av urlerna krävas i kombination med cli. Läs mer längre ner.<br /> |<br /> | 1.1<br /> |-<br /> | sign<br /> | Skall APIet regelbundet måste URLerna signeras. Se information längre ner på denna sida.<br /> |<br /> | 1.0 (tillagd i efterhand)<br /> |}<br /> <br /> Parametrar som är relaterade till att hämta statistik<br /> {| border=1 class="wikitable"<br /> |-<br /> ! Parameter<br /> ! Beskrivning<br /> ! Kan ej användas med<br /> ! Introducerad i API-version<br /> |-<br /> | amm<br /> | Används för att hämta Average, Min & Max för upp till 5 (10 från v1.12) orter specificerade med variabeln p.<br /> | graph<br /> | 1.11<br /> |-<br /> | daily<br /> | Används för att hämta dygnsmedel samt lägsta och högsta temperatur per dygn. En mätpunkt spcificerad med variabeln p.<br /> | graph<br /> | 1.15<br /> |-<br /> | span<br /> | Specificerar för vilket tidsperspektiv Average, Min & Max skall skapas. Giltiga värden är: 1day (standard), 1week, 1month, 1year.<br /> | start, end<br /> | 1.2<br /> |-<br /> | shift_g<br /> |Anger om daily skall visa äldre data. Exempel: om span är 1month och shift_g är 1 hämtas data för föregående månad. Standard är 0.<br /> | start, end<br /> | 1.15<br /> |-<br /> | start<br /> | Specificerar starttid för amm. Formatet är Y-m-d-H-i, ex 2011-01-30-12-31.<br /> | span<br /> | 1.11<br /> |-<br /> | end<br /> | Specificerar sluttid för amm. Formatet är Y-m-d-H-i, ex 2011-01-30-12-31. Standard är nuvarande tid<br /> | span<br /> | 1.11<br /> |}<br /> <br /> Parametrar som är relaterade till grafgenerering:<br /> {| border=1 class="wikitable"<br /> |-<br /> ! Parameter<br /> ! Beskrivning<br /> ! Kan ej användas med<br /> ! Introducerad i API-version<br /> |-<br /> | graph<br /> | Används för att generera en graf för upp till 5 orter specificerade med variabeln p. Anges variablen compare kommer orterna att läggas in i samma graf i stället för separata.<br /> | amm<br /> | 1.2<br /> |-<br /> | span<br /> | Specificerar för vilket tidsperspektiv grafer skall skapas. Giltiga värden är: 1day (standard), 1week, 1month, 1year.<br /> | start, end<br /> | 1.2<br /> |-<br /> | shift_g<br /> | Anger om grafen skall visa äldre data. Exempel: om span är 1day och shift_g är 1 visas en graf för igår, om shift_g är 2 visar grafen data för i förrgår etc. Standard är 0.<br /> | start, end<br /> | 1.5<br /> |-<br /> | start<br /> | Specificerar starttid för graph eller amm. Formatet är Y-m-d-H-i, ex 2011-01-30-12-31.<br /> | span, shift_g, history<br /> | 1.11<br /> |-<br /> | end<br /> | Specificerar sluttid för graph eller amm. Formatet är Y-m-d-H-i, ex 2011-01-30-12-31. Standard är nuvarande tid<br /> | span, shift_g, history<br /> | 1.11<br /> |-<br /> | history<br /> | Används för att i grafen lägga in föregående periods temperatur. Visas temperaturen för det senaste dygnet visas föregående 24h i en annan färg etc. Kan förklarliga skäl endast användas med variabeln graph.<br /> | start, end<br /> | 1.12<br /> |-<br /> | history_year<br /> | Används för att i grafen lägga in jämförelse med annat år. År anges med 4 siffror, ex 2013. Kan förklarliga skäl endast användas med variabeln graph.<br /> | start, end<br /> | 1.14<br /> |-<br /> | verbose_g<br /> | Visar min/max/medel/senaste värde i grafen. Visar även när data senast hämtades för den valda orten.<br /> |<br /> | 1.5<br /> |-<br /> | 1axis<br /> | Används för att endast visa temperaturskalan till vänster. Används med fördel i små grafer för att spara utrymme.<br /> |<br /> | 1.6<br /> |-<br /> | fontsize<br /> | Anger hur stor texten skall vara. Observera att värdet inte kan relateras till vanliga textstorlekar, du måste därför testa dig fram.<br /> |<br /> | 1.8<br /> |-<br /> | linewidth<br /> | Anger bredden på graflinjen. Giltiga värden 1 till 5. Även flyttal, ex 1.5, fungerar. Decimalkomma eller decimalpunkt spelar inte någon roll.<br /> |<br /> | 1.7<br /> |-<br /> | x<br /> | Specificerar hur bred grafen skall vara. Giltiga värden är 150-2500. 300 är standard.<br /> |<br /> | 1.2 (Tillåtna värden justerade i v 1.4,v 1.14)<br /> |-<br /> | y<br /> | Specificerar hur hög grafen skall vara. Giltiga värden är 125-2500. 200 är standard.<br /> |<br /> | 1.2 (Tillåtna värden justerade i v 1.4, v 1.14)<br /> |-<br /> | color<br /> | Anger vilken/vilka färger linjer i grafen skall ha, kommasepararead lista. Standard är #FF0000,#AADDAA,#FFCC00.<br /> |<br /> | 1.13<br /> |-<br /> | compare<br /> | Anger att order som skickats med p skall läggas in för jämförelse i samma graf. Om fler än tre orter anges måste även color definieras<br /> |<br /> | 1.13<br /> |}<br /> <br /> ==Beskrivning av returnerade fält==<br /> {| border=1 class="wikitable"<br /> |-<br /> ! Fält<br /> ! Beskrivning<br /> ! parameter som visar<br /> ! parameter som döljer<br /> ! Visas som standard<br /> ! Introducerad i API-version<br /> |-<br /> | <title><br /> | Mätpunktens namn på temperatur.nu<br /> | <br /> | <br /> | X<br /> | 1.0<br /> |-<br /> | <id><br /> | Mätpunktens id på temperatur.nu. Kan användas med parametern "p" för att hämta endast denna mätpunkts information<br /> |<br /> | simple<br /> | X<br /> | 1.0<br /> |-<br /> | <temp><br /> | Mätpunktens senaste temperatur. Om decimalkomma eller decimalpunkt skall användas styrs med parametern dc.<br /> |<br /> |<br /> | X<br /> | 1.0<br /> |-<br /> | <lat><br /> | Mätpunktens latitud i decimalt format. Om decimalkomma eller decimalpunkt skall användas styrs med parametern dc.<br /> | coordinates, verbose<br /> |<br /> |<br /> | 1.0<br /> |-<br /> | <lon><br /> | Mätpunktens longitud i decimalt format. Om decimalkomma eller decimalpunkt skall användas styrs med parametern dc.<br /> | coordinates, verbose<br /> |<br /> |<br /> | 1.0<br /> |-<br /> | <lastUpdate><br /> | Tidpunkt då informationen senast uppdaterades på temperatur.nu<br /> | verbose<br /> |<br /> |<br /> | 1.0<br /> |-<br /> | <kommun><br /> | Den kommun som mätpunkten ligger i.<br /> | verbose<br /> |<br /> |<br /> | 1.0<br /> |-<br /> | <lan><br /> | Det län som mätpunkten ligger i.<br /> | verbose<br /> |<br /> |<br /> | 1.0<br /> |-<br /> | <sourceInfo><br /> | En kort textsträng med information om vem som loggar temperaturen för mätpunkten<br /> | verbose<br /> |<br /> |<br /> | 1.8<br /> |-<br /> | <url><br /> | Url till mätpunktens temperatur och grafer på www.temperatur.nu<br /> | verbose<br /> |<br /> |<br /> | 1.0<br /> |-<br /> | <dist><br /> | Hur långt från de givna koordinaterna mätpunkten ligger. Enheten är kilometer. Om decimalkomma eller decimalpunkt skall användas styrs med parametern dc.<br /> | lat & lon<br /> | simple<br /> |<br /> | 1.0<br /> |-<br /> | <graph><br /> | Visar url till graph för orten. Observera att ny graf endast genereras när parametern graph används. Det går därför inte att lokalt cacha urlen i klienten. <br /> | graph (x, y, span, verbose_g, shift_g)<br /> |<br /> |<br /> | 1.2<br /> |-<br /> | <ClientVersion><br /> | Visar vilken den senaste släppta klientversionen är. Kan med fördel användas för att kontrollera om det finns någon uppdatering till klientmjukvaran.<br /> | version<br /> |<br /> |<br /> | 1.10<br /> |-<br /> | <ClientVersionSet><br /> | Visar status i samband med att informationen om klientversionen uppdaterats.<br /> | version_update<br /> |<br /> |<br /> | 1.10<br /> |-<br /> | <daily><br /> | Har underliggande fält <date>, <average>, <min>, <max> som representerar data för dygn angivet i fältet date. Dessa fält returneras när parametern daily används för att hämta statisk för flera dygn<br /> | daily, span, start, end, shift_g<br /> |<br /> |<br /> | 1.15<br /> |-<br /> | <ammRange><br /> | Visar för vilket tidsperspektiv amm (medel/min/max) har hämtats<br /> | amm, span, start, end, shift_g<br /> |<br /> |<br /> | 1.11<br /> |-<br /> | <average><br /> | Medeltemperatur i specificerat tidsperspektiv<br /> | amm, span, start, end, shift_g<br /> |<br /> |<br /> | 1.11<br /> |-<br /> | <min><br /> | Den minsta temperaturen i specificerat tidsperspektiv<br /> | amm, span, start, end, shift_g<br /> |<br /> |<br /> | 1.11<br /> |-<br /> | <minTime><br /> | Vid vilken tidpunkt <min> inträffade<br /> | amm, span, start, end, shift_g<br /> |<br /> |<br /> | 1.11<br /> |-<br /> | <max><br /> | Den högsta temperaturen i specificerat tidsperspektiv<br /> | amm, span, start, end, shift_g<br /> |<br /> |<br /> | 1.11<br /> |-<br /> | <maxTime><br /> | Vid vilken tidpunkt <max> inträffade<br /> | amm, span, start, end, shift_g<br /> |<br /> |<br /> | 1.11<br /> <br /> |}<br /> <br /> ==Exempel==<br /> <br /> Så här kan resultatet från en förfrågan på http://api.temperatur.nu/tnu_1.12.php?p=linkoping&verbose&cli=test_app se ut:<br /> <?xml version='1.0' encoding='iso-8859-1'?><br /> <rss version="2.0"><br /> <channel><br /> <title>Temperatur.nu API 1.12 - Din url är inte korrekt signerad, clientnyckeln kan tillfälligt blockeras - /tnu_1.12.php</title><br /> <link>http://wiki.temperatur.nu/index.php/Api</link><br /> <item><br /> <title>Linköping/Centrum</title><br /> <id>linkoping</id><br /> <temp>9.3</temp><br /> <lat>58.414297</lat><br /> <lon>15.628788</lon><br /> <lastUpdate>2011-11-24 08:51:25</lastUpdate><br /> <kommun>Linköping</kommun><br /> <lan>Östergötlands län</lan><br /> <sourceInfo>Temperaturdata från Stångå Hotell.</sourceInfo><br /> <url>http://www.temperatur.nu/linkoping.html</url><br /> </item><br /> </channel><br /> </rss><br /> <br /> <br /> Så här kan resultatet från en förfrågan på http://api.temperatur.nu/tnu_1.12.php?lat=58.376761&lon=15.562916&num=3&graph&cli=test_app2 se ut:<br /> <?xml version='1.0' encoding='iso-8859-1'?><br /> <rss version="2.0"><br /> <channel><br /> <title>Temperatur.nu API 1.12 - Din url är inte korrekt signerad, clientnyckeln kan tillfälligt blockeras - /tnu_1.12.php</title><br /> <link>http://wiki.temperatur.nu/index.php/Api</link><br /> <item><br /> <title>Linköping/Jägarvallen</title><br /> <id>jagarvallen</id><br /> <temp>7.8</temp><br /> <dist>2.5</dist><br /> <graph>http://www2.timg.nu/graph/jagarvallen-1day-300-200-0-0-0-1-8-n.png</graph><br /> </item><br /> <item><br /> <title>Linköping/Malmen (METAR)</title><br /> <id>malmen</id><br /> <temp>8.3</temp><br /> <dist>2.8</dist><br /> <graph>http://www2.timg.nu/graph/malmen-1day-300-200-0-0-0-1-8-n.png</graph><br /> </item><br /> <item><br /> <title>Linköping/Skäggetorp</title><br /> <id>skaggetorp</id><br /> <temp>9.1</temp><br /> <dist>5.2</dist><br /> <graph>http://www2.timg.nu/graph/skaggetorp-1day-300-200-0-0-0-1-8-n.png</graph><br /> </item><br /> </channel><br /> </rss><br /> <br /> <br /> ==Signering av URLer==<br /> Förfrågningar till APIet kan signeras. Från och med version 1.11 är antalet osignerade förfrågningar begränsade till 20 per timma. Osignerade förfrågningar kommer i framtiden att begränsas för alla api-versioner. Skriver du en privat tillämpning kan du använda APIet utan att signera URLerna.<br /> <br /> Signeringen går till så här:<br /> <br /> 1. Skapa din url som vanligt.<br /> <br /> 2. Beräkna md5-/sha1-summan av urlen (utan http://) med "+clientnyckel" tillagd på slutet. Klientnyckel erhålls efter att ha mailat [mailto:support@temperatur.nu support@temperatur.nu]<br /> <br /> 3. I slutet av urlen lägger du sedan till &sign=md5-/sha1-summa<br /> <br /> I php kan det tex se ut så här om du har en signeringsnyckel för md5:<br /> $cli_key="XXXXXXXXXXXXXXXXXXXXXXXXX";<br /> $url="api.temperatur.nu/tnu_1.9.php?p=linkoping&cli=testapp"<br /> $sign=md5($url."+".$cli_key);<br /> $signed_url=$url."&sign=".$sign;<br /> <br /> I den returnerade xml-filen kan du i det första title-fältet se om förfrågan är korrekt signerad.<br /> <br /> [http://www.fileformat.info/tool/hash.htm?text= fileformat.info] är en mycket bra sida för att verifiera att de sha1-/md5-summor du tagit fram stämmer.<br /> <br /> ==Historik/ändringslogg==<br /> 2010-05-04 - Version 1.0<br /> Första releasen.<br /> <br /> 2010-05-13 - Version 1.1<br /> Variabeln cli tillagd.<br /> <br /> 2010-05-19 - Version 1.2<br /> Stöd för att hämta grafer<br /> <br /> 2010-06-09 - Version 1.3<br /> Bugfix som fixar en bugg introducerad i 1.2 (det gick inte att hämta alla orter genom att skippa variabeln p).<br /> <br /> 2010-08-04 - Version 1.4<br /> Värden för x och y justerade. Parametern cli krävs för att apiet skall returnera data.<br /> <br /> 2010-09-01 - Version 1.5<br /> Parametrar för att via mer info i grafen. Parametrar för att visa grafer för i går, förra veckan, 2 år sedan etc.<br /> <br /> 2010-09-01 - Version 1.6<br /> Parameter för att ange om 1 eller 2 y-axlar skall visas.<br /> <br /> 2010-11-22 - Version 1.7<br /> Möjlighet att välja hur tjock graflinjen skall vara.<br /> <br /> 2010-12-19 - Version 1.8<br /> CacheBust-funktion, möjlighet att ändra textstorlek samt information om vem som loggar temperaturen när verbose är specat.<br /> <br /> 2011-01-13 - Version 1.9<br /> Signeringsfunktion inlagd. Signeringsfunktionen kommer från mitten av 2011 krävas för alla tillämpningar och och kommer successivt att läggas in i alla versioner av apiet.<br /> <br /> 2011-01-17 - Version 1.10<br /> Möjlighet att via Apiet hantera informaion gällande den senaste tillgängliga klientversionen.<br /> <br /> 2011-01-30 - Version 1.11<br /> Mer flexibel specificering av tidsperspektiv för grafer. amm - möjlighet att hämta medel/min/max i ett valfritt tidsperspektiv, antalet osignerade accesser begränsat i denna version.<br /> <br /> 2011-10-08 - Version 1.12<br /> Variabeln history tillagd. Visar föregående periods temperatur i grafer.<br /> <br /> 2012-05-04 - Version 1.13<br /> Variablerna compare och color angivna, gör det möjligt att jämföra flera orter i samma graf samt helt styra vilka färger linjerna i graferna skall ha. color kan sättas även för vanliga grafer.<br /> <br /> 2013 - Version 1.14<br /> Parametern history_year som används för att jämföra data med tidigare år. Buggfixar<br /> <br /> 2014-01-26 - Version 1.15<br /> Parametern daily. Används för att hämta dygnsmedel i ett specificerat tidsspann.<br /> <br /> [[Kategori:www.temperatur.nu]]<br /> [[Kategori:Mjukvara]]</div>

Elf98 https://wiki.temperatur.nu/index.php?title=API&diff=757 API 2020-01-10T08:10:56Z

<p>Elf98: /* Parametrar */ Tog bort information runt versionshantering. Ingen har använt funktionen.</p> <hr /> <div>{| align="right"<br /> | __TOC__<br /> |}<br /> Det finns ett enkelt API för att hämta senaste temperaturerna från temperatur.nu.<br /> <br /> Aktuell API-version 1.15. <br /> <br /> Data returneras i XML-format<br /> <br /> ==Support==<br /> För support på API-funktionen, använd [http://www.temperatur.nu/forum/forslag-feedback/diskusionstrad-for-api-funktionen-t1373.html Forumet på www.temperatur.nu].<br /> <br /> ==Villkor==<br /> *Mjukvaran skall skrivas på ett sådant sätt att APIet inte automatiskt belastas med samma fråga oftare än var femte minut från en enskild klient. Klientid som bryter mot detta villkor kan komma att blockeras. <br /> *Det måste mycket tydligt framgå att temperaturerna kommer från temperatur.nu.<br /> *Där så är möjligt skall temperaturerna vara länkar till temperatur.nu.<br /> *Temperatur.nus [[Logotype|logotype]] skall finnas i applikationen, gärna så den tydligt syns när programmet används. Om detta ej är möjligt kan logotypen placeras där inställningar för applikationen görs.<br /> *APIet får ej användas för att automatiskt samla in och lagra data längre än 24h.<br /> *I de fall applikationen kommer att kosta pengar för användaren krävs särskild överenskommelse med temperatur.nu. Kontakta [mailto:support@temperatur.nu support@temperatur.nu] för mer information.<br /> *Förfrågningar till APIet kan signeras, från och med version 1.11 är osignerade förfrågningar är begränsade till ca 20/timma per klientid. Denna begränsning kommer efter hand att läggas in även på de äldre versionerna. Maila [mailto:support@temperatur.nu support@temperatur.nu] för att att erhålla en signeringsnyckel för ditt klientid. När du ansöker om en signeringsnyckel måste du ange om du vill signera med sha1 eller md5. Läs mer om hur du signerar förfrågningarna längre ner på denna sida.<br /> *Du skall skriva en beskrivning av din mjukvara i denna Wiki. På så sätt kommer fler intresserade att hitta din applikation. Klienter som inte finns beskrivna i Wikin kan komma att blockeras. [[Mjukvaror_som_använder_APIet|Här finns en lista med kända klienter]]<br /> <br /> <br /> ==Kort beskrivning==<br /> APIet är tänkt att användas av de som skapar extern mjukvara, tex applikationer för Iphone och Android.<br /> Målet är att APIet skall vara lättförståeligt och lätt att använda - feedback från användarna är av stor vikt för att kunna utveckla APIet!<br /> <br /> ==Var finns APIet?==<br /> Du accessar APIet via http://api.temperatur.nu/tnu_1.<version>.php. ex: http://api.temperatur.nu/tnu_1.12.php<br /> <br /> ==Parametrar==<br /> Generellta parametrar<br /> <br /> {| border=1 class="wikitable"<br /> |-<br /> ! Parameter<br /> ! Beskrivning<br /> ! Kan ej användas med<br /> ! Introducerad i API-version<br /> |-<br /> | p<br /> | Anger för vilka orter data skall returneras - kommaseparerad lista. Utelämnas parametern returneras samtliga mätpunkter.<br /> | lat, lon, num<br /> | 1.0<br /> |-<br /> | dc<br /> | Anger om decimalkomma skall användas i stället för decimalpunkt i fälten <temperatur>, <lat>, <lon> och <dist>.<br /> |<br /> | 1.0<br /> |-<br /> | simple<br /> | Minimal output, returnerar endast <title>, <id> och <temp><br /> | verbose<br /> | 1.0<br /> |-<br /> | verbose<br /> | Returnerar alla fält för orten, se beskrivning nedan<br /> | simple<br /> | 1.0<br /> |-<br /> | coordinates<br /> | Visar koordinaterna för valda orter. Kan användas tillsammans med simple för att kunna positionera orter på en karta utan att behöva hämta alla fält.<br /> | verbose<br /> | 1.0<br /> |-<br /> | lat<br /> | Används tillsammans med lon och ev num. Det spelar inte någon roll om decimal- eller kommapunkt används. När dessa parametrar används returneras de num närmaste orterna, närmaste orten först.<br /> | p<br /> | 1.0<br /> |-<br /> | lon<br /> | Används tillsammans med lat och ev num. Det spelar inte någon roll om decimal- eller kommapunkt används. När dessa parametrar används returneras de num närmaste orterna, närmaste orten först..<br /> | p<br /> | 1.0<br /> |-<br /> | num<br /> | Används tillsammans med lat och lon. Anger hur många orter som skall returneras. Standard är 1 och max är 5 (10 från v 1.12).<br /> | p<br /> | 1.0<br /> |-<br /> | cb<br /> | CacheBust. Om denna parameter finns i urlen (&cb) kommer ett randomiserat värde att läggas till i slutet av graf-urlerna. Denna parameter kan användas för att se till att inte grafen cachas lokalt hos användaren eller i någon dåligt konfigurerad proxy mellan temperatur.nu och användaren.<br /> |<br /> | 1.8<br /> |-<br /> | cli <br /> | Skall användas för att identifiera vilken klient som hämtar data. Ex "cli=tnu_widget". Från mitten av 2011 kommer signering av urlerna krävas i kombination med cli. Läs mer längre ner.<br /> |<br /> | 1.1<br /> |-<br /> | sign<br /> | Skall APIet regelbundet måste URLerna signeras. Se information längre ner på denna sida.<br /> |<br /> | 1.0 (tillagd i efterhand)<br /> |}<br /> <br /> Parametrar som är relaterade till att hämta statistik<br /> {| border=1 class="wikitable"<br /> |-<br /> ! Parameter<br /> ! Beskrivning<br /> ! Kan ej användas med<br /> ! Introducerad i API-version<br /> |-<br /> | amm<br /> | Används för att hämta Average, Min & Max för upp till 5 (10 från v1.12) orter specificerade med variabeln p.<br /> | graph<br /> | 1.11<br /> |-<br /> | daily<br /> | Används för att hämta dygnsmedel samt lägsta och högsta temperatur per dygn. En mätpunkt spcificerad med variabeln p.<br /> | graph<br /> | 1.15<br /> |-<br /> | span<br /> | Specificerar för vilket tidsperspektiv Average, Min & Max skall skapas. Giltiga värden är: 1day (standard), 1week, 1month, 1year.<br /> | start, end<br /> | 1.2<br /> |-<br /> | shift_g<br /> |Anger om daily skall visa äldre data. Exempel: om span är 1month och shift_g är 1 hämtas data för föregående månad. Standard är 0.<br /> | start, end<br /> | 1.15<br /> |-<br /> | start<br /> | Specificerar starttid för amm. Formatet är Y-m-d-H-i, ex 2011-01-30-12-31.<br /> | span<br /> | 1.11<br /> |-<br /> | end<br /> | Specificerar sluttid för amm. Formatet är Y-m-d-H-i, ex 2011-01-30-12-31. Standard är nuvarande tid<br /> | span<br /> | 1.11<br /> |}<br /> <br /> Parametrar som är relaterade till grafgenerering:<br /> {| border=1 class="wikitable"<br /> |-<br /> ! Parameter<br /> ! Beskrivning<br /> ! Kan ej användas med<br /> ! Introducerad i API-version<br /> |-<br /> | graph<br /> | Används för att generera en graf för upp till 5 orter specificerade med variabeln p. Anges variablen compare kommer orterna att läggas in i samma graf i stället för separata.<br /> | amm<br /> | 1.2<br /> |-<br /> | span<br /> | Specificerar för vilket tidsperspektiv grafer skall skapas. Giltiga värden är: 1day (standard), 1week, 1month, 1year.<br /> | start, end<br /> | 1.2<br /> |-<br /> | shift_g<br /> | Anger om grafen skall visa äldre data. Exempel: om span är 1day och shift_g är 1 visas en graf för igår, om shift_g är 2 visar grafen data för i förrgår etc. Standard är 0.<br /> | start, end<br /> | 1.5<br /> |-<br /> | start<br /> | Specificerar starttid för graph eller amm. Formatet är Y-m-d-H-i, ex 2011-01-30-12-31.<br /> | span, shift_g, history<br /> | 1.11<br /> |-<br /> | end<br /> | Specificerar sluttid för graph eller amm. Formatet är Y-m-d-H-i, ex 2011-01-30-12-31. Standard är nuvarande tid<br /> | span, shift_g, history<br /> | 1.11<br /> |-<br /> | history<br /> | Används för att i grafen lägga in föregående periods temperatur. Visas temperaturen för det senaste dygnet visas föregående 24h i en annan färg etc. Kan förklarliga skäl endast användas med variabeln graph.<br /> | start, end<br /> | 1.12<br /> |-<br /> | history_year<br /> | Används för att i grafen lägga in jämförelse med annat år. År anges med 4 siffror, ex 2013. Kan förklarliga skäl endast användas med variabeln graph.<br /> | start, end<br /> | 1.14<br /> |-<br /> | verbose_g<br /> | Visar min/max/medel/senaste värde i grafen. Visar även när data senast hämtades för den valda orten.<br /> |<br /> | 1.5<br /> |-<br /> | 1axis<br /> | Används för att endast visa temperaturskalan till vänster. Används med fördel i små grafer för att spara utrymme.<br /> |<br /> | 1.6<br /> |-<br /> | fontsize<br /> | Anger hur stor texten skall vara. Observera att värdet inte kan relateras till vanliga textstorlekar, du måste därför testa dig fram.<br /> |<br /> | 1.8<br /> |-<br /> | linewidth<br /> | Anger bredden på graflinjen. Giltiga värden 1 till 5. Även flyttal, ex 1.5, fungerar. Decimalkomma eller decimalpunkt spelar inte någon roll.<br /> |<br /> | 1.7<br /> |-<br /> | x<br /> | Specificerar hur bred grafen skall vara. Giltiga värden är 150-2500. 300 är standard.<br /> |<br /> | 1.2 (Tillåtna värden justerade i v 1.4,v 1.14)<br /> |-<br /> | y<br /> | Specificerar hur hög grafen skall vara. Giltiga värden är 125-2500. 200 är standard.<br /> |<br /> | 1.2 (Tillåtna värden justerade i v 1.4, v 1.14)<br /> |-<br /> | color<br /> | Anger vilken/vilka färger linjer i grafen skall ha, kommasepararead lista. Standard är #FF0000,#AADDAA,#FFCC00.<br /> |<br /> | 1.13<br /> |-<br /> | compare<br /> | Anger att order som skickats med p skall läggas in för jämförelse i samma graf. Om fler än tre orter anges måste även color definieras<br /> |<br /> | 1.13<br /> |}<br /> <br /> ==Beskrivning av returnerade fält==<br /> {| border=1 class="wikitable"<br /> |-<br /> ! Fält<br /> ! Beskrivning<br /> ! parameter som visar<br /> ! parameter som döljer<br /> ! Visas som standard<br /> ! Introducerad i API-version<br /> |-<br /> | <title><br /> | Mätpunktens namn på temperatur.nu<br /> | <br /> | <br /> | X<br /> | 1.0<br /> |-<br /> | <id><br /> | Mätpunktens id på temperatur.nu. Kan användas med parametern "p" för att hämta endast denna mätpunkts information<br /> |<br /> | simple<br /> | X<br /> | 1.0<br /> |-<br /> | <temp><br /> | Mätpunktens senaste temperatur. Om decimalkomma eller decimalpunkt skall användas styrs med parametern dc.<br /> |<br /> |<br /> | X<br /> | 1.0<br /> |-<br /> | <lat><br /> | Mätpunktens latitud i decimalt format. Om decimalkomma eller decimalpunkt skall användas styrs med parametern dc.<br /> | coordinates, verbose<br /> |<br /> |<br /> | 1.0<br /> |-<br /> | <lon><br /> | Mätpunktens longitud i decimalt format. Om decimalkomma eller decimalpunkt skall användas styrs med parametern dc.<br /> | coordinates, verbose<br /> |<br /> |<br /> | 1.0<br /> |-<br /> | <lastUpdate><br /> | Tidpunkt då informationen senast uppdaterades på temperatur.nu<br /> | verbose<br /> |<br /> |<br /> | 1.0<br /> |-<br /> | <kommun><br /> | Den kommun som mätpunkten ligger i.<br /> | verbose<br /> |<br /> |<br /> | 1.0<br /> |-<br /> | <lan><br /> | Det län som mätpunkten ligger i.<br /> | verbose<br /> |<br /> |<br /> | 1.0<br /> |-<br /> | <sourceInfo><br /> | En kort textsträng med information om vem som loggar temperaturen för mätpunkten<br /> | verbose<br /> |<br /> |<br /> | 1.8<br /> |-<br /> | <url><br /> | Url till mätpunktens temperatur och grafer på www.temperatur.nu<br /> | verbose<br /> |<br /> |<br /> | 1.0<br /> |-<br /> | <dist><br /> | Hur långt från de givna koordinaterna mätpunkten ligger. Enheten är kilometer. Om decimalkomma eller decimalpunkt skall användas styrs med parametern dc.<br /> | lat & lon<br /> | simple<br /> |<br /> | 1.0<br /> |-<br /> | <graph><br /> | Visar url till graph för orten. Observera att ny graf endast genereras när parametern graph används. Det går därför inte att lokalt cacha urlen i klienten. <br /> | graph (x, y, span, verbose_g, shift_g)<br /> |<br /> |<br /> | 1.2<br /> |-<br /> | <ClientVersion><br /> | Visar vilken den senaste släppta klientversionen är. Kan med fördel användas för att kontrollera om det finns någon uppdatering till klientmjukvaran.<br /> | version<br /> |<br /> |<br /> | 1.10<br /> |-<br /> | <ClientVersionSet><br /> | Visar status i samband med att informationen om klientversionen uppdaterats.<br /> | version_update<br /> |<br /> |<br /> | 1.10<br /> |-<br /> | <daily><br /> | Har underliggande fält <date>, <average>, <min>, <max> som representerar data för dygn angivet i fältet date. Dessa fält returneras när parametern daily används för att hämta statisk för flera dygn<br /> | daily, span, start, end, shift_g<br /> |<br /> |<br /> | 1.15<br /> |-<br /> | <ammRange><br /> | Visar för vilket tidsperspektiv amm (medel/min/max) har hämtats<br /> | amm, span, start, end, shift_g<br /> |<br /> |<br /> | 1.11<br /> |-<br /> | <average><br /> | Medeltemperatur i specificerat tidsperspektiv<br /> | amm, span, start, end, shift_g<br /> |<br /> |<br /> | 1.11<br /> |-<br /> | <min><br /> | Den minsta temperaturen i specificerat tidsperspektiv<br /> | amm, span, start, end, shift_g<br /> |<br /> |<br /> | 1.11<br /> |-<br /> | <minTime><br /> | Vid vilken tidpunkt <min> inträffade<br /> | amm, span, start, end, shift_g<br /> |<br /> |<br /> | 1.11<br /> |-<br /> | <max><br /> | Den högsta temperaturen i specificerat tidsperspektiv<br /> | amm, span, start, end, shift_g<br /> |<br /> |<br /> | 1.11<br /> |-<br /> | <maxTime><br /> | Vid vilken tidpunkt <max> inträffade<br /> | amm, span, start, end, shift_g<br /> |<br /> |<br /> | 1.11<br /> <br /> |}<br /> <br /> ==Exempel==<br /> <br /> Så här kan resultatet från en förfrågan på http://api.temperatur.nu/tnu_1.12.php?p=linkoping&verbose&cli=test_app se ut:<br /> <?xml version='1.0' encoding='iso-8859-1'?><br /> <rss version="2.0"><br /> <channel><br /> <title>Temperatur.nu API 1.12 - Din url är inte korrekt signerad, clientnyckeln kan tillfälligt blockeras - /tnu_1.12.php</title><br /> <link>http://wiki.temperatur.nu/index.php/Api</link><br /> <item><br /> <title>Linköping/Centrum</title><br /> <id>linkoping</id><br /> <temp>9.3</temp><br /> <lat>58.414297</lat><br /> <lon>15.628788</lon><br /> <lastUpdate>2011-11-24 08:51:25</lastUpdate><br /> <kommun>Linköping</kommun><br /> <lan>Östergötlands län</lan><br /> <sourceInfo>Temperaturdata från Stångå Hotell.</sourceInfo><br /> <url>http://www.temperatur.nu/linkoping.html</url><br /> </item><br /> </channel><br /> </rss><br /> <br /> <br /> Så här kan resultatet från en förfrågan på http://api.temperatur.nu/tnu_1.12.php?lat=58.376761&lon=15.562916&num=3&graph&cli=test_app2 se ut:<br /> <?xml version='1.0' encoding='iso-8859-1'?><br /> <rss version="2.0"><br /> <channel><br /> <title>Temperatur.nu API 1.12 - Din url är inte korrekt signerad, clientnyckeln kan tillfälligt blockeras - /tnu_1.12.php</title><br /> <link>http://wiki.temperatur.nu/index.php/Api</link><br /> <item><br /> <title>Linköping/Jägarvallen</title><br /> <id>jagarvallen</id><br /> <temp>7.8</temp><br /> <dist>2.5</dist><br /> <graph>http://www2.timg.nu/graph/jagarvallen-1day-300-200-0-0-0-1-8-n.png</graph><br /> </item><br /> <item><br /> <title>Linköping/Malmen (METAR)</title><br /> <id>malmen</id><br /> <temp>8.3</temp><br /> <dist>2.8</dist><br /> <graph>http://www2.timg.nu/graph/malmen-1day-300-200-0-0-0-1-8-n.png</graph><br /> </item><br /> <item><br /> <title>Linköping/Skäggetorp</title><br /> <id>skaggetorp</id><br /> <temp>9.1</temp><br /> <dist>5.2</dist><br /> <graph>http://www2.timg.nu/graph/skaggetorp-1day-300-200-0-0-0-1-8-n.png</graph><br /> </item><br /> </channel><br /> </rss><br /> <br /> <br /> ==Signering av URLer==<br /> Förfrågningar till APIet kan signeras. Från och med version 1.11 är antalet osignerade förfrågningar begränsade till 20 per timma. Osignerade förfrågningar kommer i framtiden att begränsas för alla api-versioner. Skriver du en privat tillämpning kan du använda APIet utan att signera URLerna.<br /> <br /> Signeringen går till så här:<br /> <br /> 1. Skapa din url som vanligt.<br /> <br /> 2. Beräkna md5-/sha1-summan av urlen (utan http://) med "+clientnyckel" tillagd på slutet. Klientnyckel erhålls efter att ha mailat [mailto:support@temperatur.nu support@temperatur.nu]<br /> <br /> 3. I slutet av urlen lägger du sedan till &sign=md5-/sha1-summa<br /> <br /> I php kan det tex se ut så här om du har en signeringsnyckel för md5:<br /> $cli_key="XXXXXXXXXXXXXXXXXXXXXXXXX";<br /> $url="api.temperatur.nu/tnu_1.9.php?p=linkoping&cli=testapp"<br /> $sign=md5($url."+".$cli_key);<br /> $signed_url=$url."&sign=".$sign;<br /> <br /> I den returnerade xml-filen kan du i det första title-fältet se om förfrågan är korrekt signerad.<br /> <br /> [http://www.fileformat.info/tool/hash.htm?text= fileformat.info] är en mycket bra sida för att verifiera att de sha1-/md5-summor du tagit fram stämmer.<br /> <br /> ==Historik/ändringslogg==<br /> 2010-05-04 - Version 1.0<br /> Första releasen.<br /> <br /> 2010-05-13 - Version 1.1<br /> Variabeln cli tillagd.<br /> <br /> 2010-05-19 - Version 1.2<br /> Stöd för att hämta grafer<br /> <br /> 2010-06-09 - Version 1.3<br /> Bugfix som fixar en bugg introducerad i 1.2 (det gick inte att hämta alla orter genom att skippa variabeln p).<br /> <br /> 2010-08-04 - Version 1.4<br /> Värden för x och y justerade. Parametern cli krävs för att apiet skall returnera data.<br /> <br /> 2010-09-01 - Version 1.5<br /> Parametrar för att via mer info i grafen. Parametrar för att visa grafer för i går, förra veckan, 2 år sedan etc.<br /> <br /> 2010-09-01 - Version 1.6<br /> Parameter för att ange om 1 eller 2 y-axlar skall visas.<br /> <br /> 2010-11-22 - Version 1.7<br /> Möjlighet att välja hur tjock graflinjen skall vara.<br /> <br /> 2010-12-19 - Version 1.8<br /> CacheBust-funktion, möjlighet att ändra textstorlek samt information om vem som loggar temperaturen när verbose är specat.<br /> <br /> 2011-01-13 - Version 1.9<br /> Signeringsfunktion inlagd. Signeringsfunktionen kommer från mitten av 2011 krävas för alla tillämpningar och och kommer successivt att läggas in i alla versioner av apiet.<br /> <br /> 2011-01-17 - Version 1.10<br /> Möjlighet att via Apiet hantera informaion gällande den senaste tillgängliga klientversionen.<br /> <br /> 2011-01-30 - Version 1.11<br /> Mer flexibel specificering av tidsperspektiv för grafer. amm - möjlighet att hämta medel/min/max i ett valfritt tidsperspektiv, antalet osignerade accesser begränsat i denna version.<br /> <br /> 2011-10-08 - Version 1.12<br /> Variabeln history tillagd. Visar föregående periods temperatur i grafer.<br /> <br /> 2012-05-04 - Version 1.13<br /> Variablerna compare och color angivna, gör det möjligt att jämföra flera orter i samma graf samt helt styra vilka färger linjerna i graferna skall ha. color kan sättas även för vanliga grafer.<br /> <br /> 2013 - Version 1.14<br /> Parametern history_year som används för att jämföra data med tidigare år. Buggfixar<br /> <br /> 2014-01-26 - Version 1.15<br /> Parametern daily. Används för att hämta dygnsmedel i ett specificerat tidsspann.<br /> <br /> [[Kategori:www.temperatur.nu]]<br /> [[Kategori:Mjukvara]]</div>

Elf98 https://wiki.temperatur.nu/index.php?title=API&diff=756 API 2020-01-10T08:09:46Z

<p>Elf98: Gör version 755 av Elf98 (diskussion) ogjord</p> <hr /> <div>{| align="right"<br /> | __TOC__<br /> |}<br /> Det finns ett enkelt API för att hämta senaste temperaturerna från temperatur.nu.<br /> <br /> Aktuell API-version 1.15. <br /> <br /> Data returneras i XML-format<br /> <br /> ==Support==<br /> För support på API-funktionen, använd [http://www.temperatur.nu/forum/forslag-feedback/diskusionstrad-for-api-funktionen-t1373.html Forumet på www.temperatur.nu].<br /> <br /> ==Villkor==<br /> *Mjukvaran skall skrivas på ett sådant sätt att APIet inte automatiskt belastas med samma fråga oftare än var femte minut från en enskild klient. Klientid som bryter mot detta villkor kan komma att blockeras. <br /> *Det måste mycket tydligt framgå att temperaturerna kommer från temperatur.nu.<br /> *Där så är möjligt skall temperaturerna vara länkar till temperatur.nu.<br /> *Temperatur.nus [[Logotype|logotype]] skall finnas i applikationen, gärna så den tydligt syns när programmet används. Om detta ej är möjligt kan logotypen placeras där inställningar för applikationen görs.<br /> *APIet får ej användas för att automatiskt samla in och lagra data längre än 24h.<br /> *I de fall applikationen kommer att kosta pengar för användaren krävs särskild överenskommelse med temperatur.nu. Kontakta [mailto:support@temperatur.nu support@temperatur.nu] för mer information.<br /> *Förfrågningar till APIet kan signeras, från och med version 1.11 är osignerade förfrågningar är begränsade till ca 20/timma per klientid. Denna begränsning kommer efter hand att läggas in även på de äldre versionerna. Maila [mailto:support@temperatur.nu support@temperatur.nu] för att att erhålla en signeringsnyckel för ditt klientid. När du ansöker om en signeringsnyckel måste du ange om du vill signera med sha1 eller md5. Läs mer om hur du signerar förfrågningarna längre ner på denna sida.<br /> *Du skall skriva en beskrivning av din mjukvara i denna Wiki. På så sätt kommer fler intresserade att hitta din applikation. Klienter som inte finns beskrivna i Wikin kan komma att blockeras. [[Mjukvaror_som_använder_APIet|Här finns en lista med kända klienter]]<br /> <br /> <br /> ==Kort beskrivning==<br /> APIet är tänkt att användas av de som skapar extern mjukvara, tex applikationer för Iphone och Android.<br /> Målet är att APIet skall vara lättförståeligt och lätt att använda - feedback från användarna är av stor vikt för att kunna utveckla APIet!<br /> <br /> ==Var finns APIet?==<br /> Du accessar APIet via http://api.temperatur.nu/tnu_1.<version>.php. ex: http://api.temperatur.nu/tnu_1.12.php<br /> <br /> ==Parametrar==<br /> Generellta parametrar<br /> <br /> {| border=1 class="wikitable"<br /> |-<br /> ! Parameter<br /> ! Beskrivning<br /> ! Kan ej användas med<br /> ! Introducerad i API-version<br /> |-<br /> | p<br /> | Anger för vilka orter data skall returneras - kommaseparerad lista. Utelämnas parametern returneras samtliga mätpunkter.<br /> | lat, lon, num<br /> | 1.0<br /> |-<br /> | dc<br /> | Anger om decimalkomma skall användas i stället för decimalpunkt i fälten <temperatur>, <lat>, <lon> och <dist>.<br /> |<br /> | 1.0<br /> |-<br /> | simple<br /> | Minimal output, returnerar endast <title>, <id> och <temp><br /> | verbose<br /> | 1.0<br /> |-<br /> | verbose<br /> | Returnerar alla fält för orten, se beskrivning nedan<br /> | simple<br /> | 1.0<br /> |-<br /> | coordinates<br /> | Visar koordinaterna för valda orter. Kan användas tillsammans med simple för att kunna positionera orter på en karta utan att behöva hämta alla fält.<br /> | verbose<br /> | 1.0<br /> |-<br /> | lat<br /> | Används tillsammans med lon och ev num. Det spelar inte någon roll om decimal- eller kommapunkt används. När dessa parametrar används returneras de num närmaste orterna, närmaste orten först.<br /> | p<br /> | 1.0<br /> |-<br /> | lon<br /> | Används tillsammans med lat och ev num. Det spelar inte någon roll om decimal- eller kommapunkt används. När dessa parametrar används returneras de num närmaste orterna, närmaste orten först..<br /> | p<br /> | 1.0<br /> |-<br /> | num<br /> | Används tillsammans med lat och lon. Anger hur många orter som skall returneras. Standard är 1 och max är 5 (10 från v 1.12).<br /> | p<br /> | 1.0<br /> |-<br /> | cb<br /> | CacheBust. Om denna parameter finns i urlen (&cb) kommer ett randomiserat värde att läggas till i slutet av graf-urlerna. Denna parameter kan användas för att se till att inte grafen cachas lokalt hos användaren eller i någon dåligt konfigurerad proxy mellan temperatur.nu och användaren.<br /> |<br /> | 1.8<br /> |-<br /> | cli <br /> | Skall användas för att identifiera vilken klient som hämtar data. Ex "cli=tnu_widget". Från mitten av 2011 kommer signering av urlerna krävas i kombination med cli. Läs mer längre ner.<br /> |<br /> | 1.1<br /> |-<br /> | sign<br /> | Skall APIet regelbundet måste URLerna signeras. Se information längre ner på denna sida.<br /> |<br /> | 1.0 (tillagd i efterhand)<br /> |-<br /> | version<br /> | Returnerar senaste klientversionen, kan användas för att enkelt meddela klienterna att det finns nya uppdateringar till mjukvaran.<br /> | Alla andra parametrar förutom cli och sign ignoreras<br /> | 1.10<br /> |-<br /> | version_update<br /> | Denna parameter skall normalt aldrig vara inlagd i någon mjukvara utan används av utvecklaren för att uppdatera databasen på temperatur.nu i samband med att en ny version av klientmjukvaran släpps. Urlen måste vara signerad för att kunna uppdatera informationen.<br /> | Alla andra parametrar förutom cli och sign ignoreras<br /> | 1.10<br /> |}<br /> <br /> Parametrar som är relaterade till att hämta statistik<br /> {| border=1 class="wikitable"<br /> |-<br /> ! Parameter<br /> ! Beskrivning<br /> ! Kan ej användas med<br /> ! Introducerad i API-version<br /> |-<br /> | amm<br /> | Används för att hämta Average, Min & Max för upp till 5 (10 från v1.12) orter specificerade med variabeln p.<br /> | graph<br /> | 1.11<br /> |-<br /> | daily<br /> | Används för att hämta dygnsmedel samt lägsta och högsta temperatur per dygn. En mätpunkt spcificerad med variabeln p.<br /> | graph<br /> | 1.15<br /> |-<br /> | span<br /> | Specificerar för vilket tidsperspektiv Average, Min & Max skall skapas. Giltiga värden är: 1day (standard), 1week, 1month, 1year.<br /> | start, end<br /> | 1.2<br /> |-<br /> | shift_g<br /> |Anger om daily skall visa äldre data. Exempel: om span är 1month och shift_g är 1 hämtas data för föregående månad. Standard är 0.<br /> | start, end<br /> | 1.15<br /> |-<br /> | start<br /> | Specificerar starttid för amm. Formatet är Y-m-d-H-i, ex 2011-01-30-12-31.<br /> | span<br /> | 1.11<br /> |-<br /> | end<br /> | Specificerar sluttid för amm. Formatet är Y-m-d-H-i, ex 2011-01-30-12-31. Standard är nuvarande tid<br /> | span<br /> | 1.11<br /> |}<br /> <br /> Parametrar som är relaterade till grafgenerering:<br /> {| border=1 class="wikitable"<br /> |-<br /> ! Parameter<br /> ! Beskrivning<br /> ! Kan ej användas med<br /> ! Introducerad i API-version<br /> |-<br /> | graph<br /> | Används för att generera en graf för upp till 5 orter specificerade med variabeln p. Anges variablen compare kommer orterna att läggas in i samma graf i stället för separata.<br /> | amm<br /> | 1.2<br /> |-<br /> | span<br /> | Specificerar för vilket tidsperspektiv grafer skall skapas. Giltiga värden är: 1day (standard), 1week, 1month, 1year.<br /> | start, end<br /> | 1.2<br /> |-<br /> | shift_g<br /> | Anger om grafen skall visa äldre data. Exempel: om span är 1day och shift_g är 1 visas en graf för igår, om shift_g är 2 visar grafen data för i förrgår etc. Standard är 0.<br /> | start, end<br /> | 1.5<br /> |-<br /> | start<br /> | Specificerar starttid för graph eller amm. Formatet är Y-m-d-H-i, ex 2011-01-30-12-31.<br /> | span, shift_g, history<br /> | 1.11<br /> |-<br /> | end<br /> | Specificerar sluttid för graph eller amm. Formatet är Y-m-d-H-i, ex 2011-01-30-12-31. Standard är nuvarande tid<br /> | span, shift_g, history<br /> | 1.11<br /> |-<br /> | history<br /> | Används för att i grafen lägga in föregående periods temperatur. Visas temperaturen för det senaste dygnet visas föregående 24h i en annan färg etc. Kan förklarliga skäl endast användas med variabeln graph.<br /> | start, end<br /> | 1.12<br /> |-<br /> | history_year<br /> | Används för att i grafen lägga in jämförelse med annat år. År anges med 4 siffror, ex 2013. Kan förklarliga skäl endast användas med variabeln graph.<br /> | start, end<br /> | 1.14<br /> |-<br /> | verbose_g<br /> | Visar min/max/medel/senaste värde i grafen. Visar även när data senast hämtades för den valda orten.<br /> |<br /> | 1.5<br /> |-<br /> | 1axis<br /> | Används för att endast visa temperaturskalan till vänster. Används med fördel i små grafer för att spara utrymme.<br /> |<br /> | 1.6<br /> |-<br /> | fontsize<br /> | Anger hur stor texten skall vara. Observera att värdet inte kan relateras till vanliga textstorlekar, du måste därför testa dig fram.<br /> |<br /> | 1.8<br /> |-<br /> | linewidth<br /> | Anger bredden på graflinjen. Giltiga värden 1 till 5. Även flyttal, ex 1.5, fungerar. Decimalkomma eller decimalpunkt spelar inte någon roll.<br /> |<br /> | 1.7<br /> |-<br /> | x<br /> | Specificerar hur bred grafen skall vara. Giltiga värden är 150-2500. 300 är standard.<br /> |<br /> | 1.2 (Tillåtna värden justerade i v 1.4,v 1.14)<br /> |-<br /> | y<br /> | Specificerar hur hög grafen skall vara. Giltiga värden är 125-2500. 200 är standard.<br /> |<br /> | 1.2 (Tillåtna värden justerade i v 1.4, v 1.14)<br /> |-<br /> | color<br /> | Anger vilken/vilka färger linjer i grafen skall ha, kommasepararead lista. Standard är #FF0000,#AADDAA,#FFCC00.<br /> |<br /> | 1.13<br /> |-<br /> | compare<br /> | Anger att order som skickats med p skall läggas in för jämförelse i samma graf. Om fler än tre orter anges måste även color definieras<br /> |<br /> | 1.13<br /> |}<br /> ==Beskrivning av returnerade fält==<br /> {| border=1 class="wikitable"<br /> |-<br /> ! Fält<br /> ! Beskrivning<br /> ! parameter som visar<br /> ! parameter som döljer<br /> ! Visas som standard<br /> ! Introducerad i API-version<br /> |-<br /> | <title><br /> | Mätpunktens namn på temperatur.nu<br /> | <br /> | <br /> | X<br /> | 1.0<br /> |-<br /> | <id><br /> | Mätpunktens id på temperatur.nu. Kan användas med parametern "p" för att hämta endast denna mätpunkts information<br /> |<br /> | simple<br /> | X<br /> | 1.0<br /> |-<br /> | <temp><br /> | Mätpunktens senaste temperatur. Om decimalkomma eller decimalpunkt skall användas styrs med parametern dc.<br /> |<br /> |<br /> | X<br /> | 1.0<br /> |-<br /> | <lat><br /> | Mätpunktens latitud i decimalt format. Om decimalkomma eller decimalpunkt skall användas styrs med parametern dc.<br /> | coordinates, verbose<br /> |<br /> |<br /> | 1.0<br /> |-<br /> | <lon><br /> | Mätpunktens longitud i decimalt format. Om decimalkomma eller decimalpunkt skall användas styrs med parametern dc.<br /> | coordinates, verbose<br /> |<br /> |<br /> | 1.0<br /> |-<br /> | <lastUpdate><br /> | Tidpunkt då informationen senast uppdaterades på temperatur.nu<br /> | verbose<br /> |<br /> |<br /> | 1.0<br /> |-<br /> | <kommun><br /> | Den kommun som mätpunkten ligger i.<br /> | verbose<br /> |<br /> |<br /> | 1.0<br /> |-<br /> | <lan><br /> | Det län som mätpunkten ligger i.<br /> | verbose<br /> |<br /> |<br /> | 1.0<br /> |-<br /> | <sourceInfo><br /> | En kort textsträng med information om vem som loggar temperaturen för mätpunkten<br /> | verbose<br /> |<br /> |<br /> | 1.8<br /> |-<br /> | <url><br /> | Url till mätpunktens temperatur och grafer på www.temperatur.nu<br /> | verbose<br /> |<br /> |<br /> | 1.0<br /> |-<br /> | <dist><br /> | Hur långt från de givna koordinaterna mätpunkten ligger. Enheten är kilometer. Om decimalkomma eller decimalpunkt skall användas styrs med parametern dc.<br /> | lat & lon<br /> | simple<br /> |<br /> | 1.0<br /> |-<br /> | <graph><br /> | Visar url till graph för orten. Observera att ny graf endast genereras när parametern graph används. Det går därför inte att lokalt cacha urlen i klienten. <br /> | graph (x, y, span, verbose_g, shift_g)<br /> |<br /> |<br /> | 1.2<br /> |-<br /> | <ClientVersion><br /> | Visar vilken den senaste släppta klientversionen är. Kan med fördel användas för att kontrollera om det finns någon uppdatering till klientmjukvaran.<br /> | version<br /> |<br /> |<br /> | 1.10<br /> |-<br /> | <ClientVersionSet><br /> | Visar status i samband med att informationen om klientversionen uppdaterats.<br /> | version_update<br /> |<br /> |<br /> | 1.10<br /> |-<br /> | <daily><br /> | Har underliggande fält <date>, <average>, <min>, <max> som representerar data för dygn angivet i fältet date. Dessa fält returneras när parametern daily används för att hämta statisk för flera dygn<br /> | daily, span, start, end, shift_g<br /> |<br /> |<br /> | 1.15<br /> |-<br /> | <ammRange><br /> | Visar för vilket tidsperspektiv amm (medel/min/max) har hämtats<br /> | amm, span, start, end, shift_g<br /> |<br /> |<br /> | 1.11<br /> |-<br /> | <average><br /> | Medeltemperatur i specificerat tidsperspektiv<br /> | amm, span, start, end, shift_g<br /> |<br /> |<br /> | 1.11<br /> |-<br /> | <min><br /> | Den minsta temperaturen i specificerat tidsperspektiv<br /> | amm, span, start, end, shift_g<br /> |<br /> |<br /> | 1.11<br /> |-<br /> | <minTime><br /> | Vid vilken tidpunkt <min> inträffade<br /> | amm, span, start, end, shift_g<br /> |<br /> |<br /> | 1.11<br /> |-<br /> | <max><br /> | Den högsta temperaturen i specificerat tidsperspektiv<br /> | amm, span, start, end, shift_g<br /> |<br /> |<br /> | 1.11<br /> |-<br /> | <maxTime><br /> | Vid vilken tidpunkt <max> inträffade<br /> | amm, span, start, end, shift_g<br /> |<br /> |<br /> | 1.11<br /> <br /> |}<br /> <br /> ==Exempel==<br /> <br /> Så här kan resultatet från en förfrågan på http://api.temperatur.nu/tnu_1.12.php?p=linkoping&verbose&cli=test_app se ut:<br /> <?xml version='1.0' encoding='iso-8859-1'?><br /> <rss version="2.0"><br /> <channel><br /> <title>Temperatur.nu API 1.12 - Din url är inte korrekt signerad, clientnyckeln kan tillfälligt blockeras - /tnu_1.12.php</title><br /> <link>http://wiki.temperatur.nu/index.php/Api</link><br /> <item><br /> <title>Linköping/Centrum</title><br /> <id>linkoping</id><br /> <temp>9.3</temp><br /> <lat>58.414297</lat><br /> <lon>15.628788</lon><br /> <lastUpdate>2011-11-24 08:51:25</lastUpdate><br /> <kommun>Linköping</kommun><br /> <lan>Östergötlands län</lan><br /> <sourceInfo>Temperaturdata från Stångå Hotell.</sourceInfo><br /> <url>http://www.temperatur.nu/linkoping.html</url><br /> </item><br /> </channel><br /> </rss><br /> <br /> <br /> Så här kan resultatet från en förfrågan på http://api.temperatur.nu/tnu_1.12.php?lat=58.376761&lon=15.562916&num=3&graph&cli=test_app2 se ut:<br /> <?xml version='1.0' encoding='iso-8859-1'?><br /> <rss version="2.0"><br /> <channel><br /> <title>Temperatur.nu API 1.12 - Din url är inte korrekt signerad, clientnyckeln kan tillfälligt blockeras - /tnu_1.12.php</title><br /> <link>http://wiki.temperatur.nu/index.php/Api</link><br /> <item><br /> <title>Linköping/Jägarvallen</title><br /> <id>jagarvallen</id><br /> <temp>7.8</temp><br /> <dist>2.5</dist><br /> <graph>http://www2.timg.nu/graph/jagarvallen-1day-300-200-0-0-0-1-8-n.png</graph><br /> </item><br /> <item><br /> <title>Linköping/Malmen (METAR)</title><br /> <id>malmen</id><br /> <temp>8.3</temp><br /> <dist>2.8</dist><br /> <graph>http://www2.timg.nu/graph/malmen-1day-300-200-0-0-0-1-8-n.png</graph><br /> </item><br /> <item><br /> <title>Linköping/Skäggetorp</title><br /> <id>skaggetorp</id><br /> <temp>9.1</temp><br /> <dist>5.2</dist><br /> <graph>http://www2.timg.nu/graph/skaggetorp-1day-300-200-0-0-0-1-8-n.png</graph><br /> </item><br /> </channel><br /> </rss><br /> <br /> <br /> ==Signering av URLer==<br /> Förfrågningar till APIet kan signeras. Från och med version 1.11 är antalet osignerade förfrågningar begränsade till 20 per timma. Osignerade förfrågningar kommer i framtiden att begränsas för alla api-versioner. Skriver du en privat tillämpning kan du använda APIet utan att signera URLerna.<br /> <br /> Signeringen går till så här:<br /> <br /> 1. Skapa din url som vanligt.<br /> <br /> 2. Beräkna md5-/sha1-summan av urlen (utan http://) med "+clientnyckel" tillagd på slutet. Klientnyckel erhålls efter att ha mailat [mailto:support@temperatur.nu support@temperatur.nu]<br /> <br /> 3. I slutet av urlen lägger du sedan till &sign=md5-/sha1-summa<br /> <br /> I php kan det tex se ut så här om du har en signeringsnyckel för md5:<br /> $cli_key="XXXXXXXXXXXXXXXXXXXXXXXXX";<br /> $url="api.temperatur.nu/tnu_1.9.php?p=linkoping&cli=testapp"<br /> $sign=md5($url."+".$cli_key);<br /> $signed_url=$url."&sign=".$sign;<br /> <br /> I den returnerade xml-filen kan du i det första title-fältet se om förfrågan är korrekt signerad.<br /> <br /> [http://www.fileformat.info/tool/hash.htm?text= fileformat.info] är en mycket bra sida för att verifiera att de sha1-/md5-summor du tagit fram stämmer.<br /> <br /> ==Historik/ändringslogg==<br /> 2010-05-04 - Version 1.0<br /> Första releasen.<br /> <br /> 2010-05-13 - Version 1.1<br /> Variabeln cli tillagd.<br /> <br /> 2010-05-19 - Version 1.2<br /> Stöd för att hämta grafer<br /> <br /> 2010-06-09 - Version 1.3<br /> Bugfix som fixar en bugg introducerad i 1.2 (det gick inte att hämta alla orter genom att skippa variabeln p).<br /> <br /> 2010-08-04 - Version 1.4<br /> Värden för x och y justerade. Parametern cli krävs för att apiet skall returnera data.<br /> <br /> 2010-09-01 - Version 1.5<br /> Parametrar för att via mer info i grafen. Parametrar för att visa grafer för i går, förra veckan, 2 år sedan etc.<br /> <br /> 2010-09-01 - Version 1.6<br /> Parameter för att ange om 1 eller 2 y-axlar skall visas.<br /> <br /> 2010-11-22 - Version 1.7<br /> Möjlighet att välja hur tjock graflinjen skall vara.<br /> <br /> 2010-12-19 - Version 1.8<br /> CacheBust-funktion, möjlighet att ändra textstorlek samt information om vem som loggar temperaturen när verbose är specat.<br /> <br /> 2011-01-13 - Version 1.9<br /> Signeringsfunktion inlagd. Signeringsfunktionen kommer från mitten av 2011 krävas för alla tillämpningar och och kommer successivt att läggas in i alla versioner av apiet.<br /> <br /> 2011-01-17 - Version 1.10<br /> Möjlighet att via Apiet hantera informaion gällande den senaste tillgängliga klientversionen.<br /> <br /> 2011-01-30 - Version 1.11<br /> Mer flexibel specificering av tidsperspektiv för grafer. amm - möjlighet att hämta medel/min/max i ett valfritt tidsperspektiv, antalet osignerade accesser begränsat i denna version.<br /> <br /> 2011-10-08 - Version 1.12<br /> Variabeln history tillagd. Visar föregående periods temperatur i grafer.<br /> <br /> 2012-05-04 - Version 1.13<br /> Variablerna compare och color angivna, gör det möjligt att jämföra flera orter i samma graf samt helt styra vilka färger linjerna i graferna skall ha. color kan sättas även för vanliga grafer.<br /> <br /> 2013 - Version 1.14<br /> Parametern history_year som används för att jämföra data med tidigare år. Buggfixar<br /> <br /> 2014-01-26 - Version 1.15<br /> Parametern daily. Används för att hämta dygnsmedel i ett specificerat tidsspann.<br /> <br /> [[Kategori:www.temperatur.nu]]<br /> [[Kategori:Mjukvara]]</div>

Elf98 https://wiki.temperatur.nu/index.php?title=API&diff=755 API 2020-01-10T08:09:03Z

<p>Elf98: /* Parametrar */ Tagit bort information runt versionshantering - meningslöst och ingen använde funktionen.</p> <hr /> <div>{| align="right"<br /> | __TOC__<br /> |}<br /> Det finns ett enkelt API för att hämta senaste temperaturerna från temperatur.nu.<br /> <br /> Aktuell API-version 1.15. <br /> <br /> Data returneras i XML-format<br /> <br /> ==Support==<br /> För support på API-funktionen, använd [http://www.temperatur.nu/forum/forslag-feedback/diskusionstrad-for-api-funktionen-t1373.html Forumet på www.temperatur.nu].<br /> <br /> ==Villkor==<br /> *Mjukvaran skall skrivas på ett sådant sätt att APIet inte automatiskt belastas med samma fråga oftare än var femte minut från en enskild klient. Klientid som bryter mot detta villkor kan komma att blockeras. <br /> *Det måste mycket tydligt framgå att temperaturerna kommer från temperatur.nu.<br /> *Där så är möjligt skall temperaturerna vara länkar till temperatur.nu.<br /> *Temperatur.nus [[Logotype|logotype]] skall finnas i applikationen, gärna så den tydligt syns när programmet används. Om detta ej är möjligt kan logotypen placeras där inställningar för applikationen görs.<br /> *APIet får ej användas för att automatiskt samla in och lagra data längre än 24h.<br /> *I de fall applikationen kommer att kosta pengar för användaren krävs särskild överenskommelse med temperatur.nu. Kontakta [mailto:support@temperatur.nu support@temperatur.nu] för mer information.<br /> *Förfrågningar till APIet kan signeras, från och med version 1.11 är osignerade förfrågningar är begränsade till ca 20/timma per klientid. Denna begränsning kommer efter hand att läggas in även på de äldre versionerna. Maila [mailto:support@temperatur.nu support@temperatur.nu] för att att erhålla en signeringsnyckel för ditt klientid. När du ansöker om en signeringsnyckel måste du ange om du vill signera med sha1 eller md5. Läs mer om hur du signerar förfrågningarna längre ner på denna sida.<br /> *Du skall skriva en beskrivning av din mjukvara i denna Wiki. På så sätt kommer fler intresserade att hitta din applikation. Klienter som inte finns beskrivna i Wikin kan komma att blockeras. [[Mjukvaror_som_använder_APIet|Här finns en lista med kända klienter]]<br /> <br /> <br /> ==Kort beskrivning==<br /> APIet är tänkt att användas av de som skapar extern mjukvara, tex applikationer för Iphone och Android.<br /> Målet är att APIet skall vara lättförståeligt och lätt att använda - feedback från användarna är av stor vikt för att kunna utveckla APIet!<br /> <br /> ==Var finns APIet?==<br /> Du accessar APIet via http://api.temperatur.nu/tnu_1.<version>.php. ex: http://api.temperatur.nu/tnu_1.12.php<br /> <br /> ==Parametrar==<br /> Generellta parametrar<br /> <br /> {| border=1 class="wikitable"<br /> |-<br /> ! Parameter<br /> ! Beskrivning<br /> ! Kan ej användas med<br /> ! Introducerad i API-version<br /> |-<br /> | p<br /> | Anger för vilka orter data skall returneras - kommaseparerad lista. Utelämnas parametern returneras samtliga mätpunkter.<br /> | lat, lon, num<br /> | 1.0<br /> |-<br /> | dc<br /> | Anger om decimalkomma skall användas i stället för decimalpunkt i fälten <temperatur>, <lat>, <lon> och <dist>.<br /> |<br /> | 1.0<br /> |-<br /> | simple<br /> | Minimal output, returnerar endast <title>, <id> och <temp><br /> | verbose<br /> | 1.0<br /> |-<br /> | verbose<br /> | Returnerar alla fält för orten, se beskrivning nedan<br /> | simple<br /> | 1.0<br /> |-<br /> | coordinates<br /> | Visar koordinaterna för valda orter. Kan användas tillsammans med simple för att kunna positionera orter på en karta utan att behöva hämta alla fält.<br /> | verbose<br /> | 1.0<br /> |-<br /> | lat<br /> | Används tillsammans med lon och ev num. Det spelar inte någon roll om decimal- eller kommapunkt används. När dessa parametrar används returneras de num närmaste orterna, närmaste orten först.<br /> | p<br /> | 1.0<br /> |-<br /> | lon<br /> | Används tillsammans med lat och ev num. Det spelar inte någon roll om decimal- eller kommapunkt används. När dessa parametrar används returneras de num närmaste orterna, närmaste orten först..<br /> | p<br /> | 1.0<br /> |-<br /> | num<br /> | Används tillsammans med lat och lon. Anger hur många orter som skall returneras. Standard är 1 och max är 5 (10 från v 1.12).<br /> | p<br /> | 1.0<br /> |-<br /> | cb<br /> | CacheBust. Om denna parameter finns i urlen (&cb) kommer ett randomiserat värde att läggas till i slutet av graf-urlerna. Denna parameter kan användas för att se till att inte grafen cachas lokalt hos användaren eller i någon dåligt konfigurerad proxy mellan temperatur.nu och användaren.<br /> |<br /> | 1.8<br /> |-<br /> | cli <br /> | Skall användas för att identifiera vilken klient som hämtar data. Ex "cli=tnu_widget". Från mitten av 2011 kommer signering av urlerna krävas i kombination med cli. Läs mer längre ner.<br /> |<br /> | 1.1<br /> |-<br /> | sign<br /> | Skall APIet regelbundet måste URLerna signeras. Se information längre ner på denna sida.<br /> |<br /> | 1.0 (tillagd i efterhand)<br /> |-<br /> | version<br /> | Returnerar senaste klientversionen, kan användas för att enkelt meddela klienterna att det finns nya uppdateringar till mjukvaran.<br /> | Alla andra parametrar förutom cli och sign ignoreras<br /> | 1.10<br /> |-<br /> | version_update<br /> | Denna parameter skall normalt aldrig vara inlagd i någon mjukvara utan används av utvecklaren för att uppdatera databasen på temperatur.nu i samband med att en ny version av klientmjukvaran släpps. Urlen måste vara signerad för att kunna uppdatera informationen.<br /> | Alla andra parametrar förutom cli och sign ignoreras<br /> | 1.10<br /> |}<br /> <br /> Parametrar som är relaterade till att hämta statistik<br /> {| border=1 class="wikitable"<br /> |-<br /> ! Parameter<br /> ! Beskrivning<br /> ! Kan ej användas med<br /> ! Introducerad i API-version<br /> |-<br /> | amm<br /> | Används för att hämta Average, Min & Max för upp till 5 (10 från v1.12) orter specificerade med variabeln p.<br /> | graph<br /> | 1.11<br /> |-<br /> | daily<br /> | Används för att hämta dygnsmedel samt lägsta och högsta temperatur per dygn. En mätpunkt spcificerad med variabeln p.<br /> | graph<br /> | 1.15<br /> |-<br /> | span<br /> | Specificerar för vilket tidsperspektiv Average, Min & Max skall skapas. Giltiga värden är: 1day (standard), 1week, 1month, 1year.<br /> | start, end<br /> | 1.2<br /> |-<br /> | shift_g<br /> |Anger om daily skall visa äldre data. Exempel: om span är 1month och shift_g är 1 hämtas data för föregående månad. Standard är 0.<br /> | start, end<br /> | 1.15<br /> |-<br /> | start<br /> | Specificerar starttid för amm. Formatet är Y-m-d-H-i, ex 2011-01-30-12-31.<br /> | span<br /> | 1.11<br /> |-<br /> | end<br /> | Specificerar sluttid för amm. Formatet är Y-m-d-H-i, ex 2011-01-30-12-31. Standard är nuvarande tid<br /> | span<br /> | 1.11<br /> |}<br /> <br /> Parametrar som är relaterade till grafgenerering:<br /> {| border=1 class="wikitable"<br /> |-<br /> ! Parameter<br /> ! Beskrivning<br /> ! Kan ej användas med<br /> ! Introducerad i API-version<br /> |-<br /> | graph<br /> | Används för att generera en graf för upp till 5 orter specificerade med variabeln p. Anges variablen compare kommer orterna att läggas in i samma graf i stället för separata.<br /> | amm<br /> | 1.2<br /> |-<br /> | span<br /> | Specificerar för vilket tidsperspektiv grafer skall skapas. Giltiga värden är: 1day (standard), 1week, 1month, 1year.<br /> | start, end<br /> | 1.2<br /> |-<br /> | shift_g<br /> | Anger om grafen skall visa äldre data. Exempel: om span är 1day och shift_g är 1 visas en graf för igår, om shift_g är 2 visar grafen data för i förrgår etc. Standard är 0.<br /> | start, end<br /> | 1.5<br /> |-<br /> | start<br /> | Specificerar starttid för graph eller amm. Formatet är Y-m-d-H-i, ex 2011-01-30-12-31.<br /> | span, shift_g, history<br /> | 1.11<br /> |-<br /> | end<br /> | Specificerar sluttid för graph eller amm. Formatet är Y-m-d-H-i, ex 2011-01-30-12-31. Standard är nuvarande tid<br /> | span, shift_g, history<br /> | 1.11<br /> |-<br /> | history<br /> | Används för att i grafen lägga in föregående periods temperatur. Visas temperaturen för det senaste dygnet visas föregående 24h i en annan färg etc. Kan förklarliga skäl endast användas med variabeln graph.<br /> | start, end<br /> | 1.12<br /> |-<br /> | history_year<br /> | Används för att i grafen lägga in jämförelse med annat år. År anges med 4 siffror, ex 2013. Kan förklarliga skäl endast användas med variabeln graph.<br /> | start, end<br /> | 1.14<br /> |-<br /> | verbose_g<br /> | Visar min/max/medel/senaste värde i grafen. Visar även när data senast hämtades för den valda orten.<br /> |<br /> | 1.5<br /> |-<br /> | 1axis<br /> | Används för att endast visa temperaturskalan till vänster. Används med fördel i små grafer för att spara utrymme.<br /> |<br /> | 1.6<br /> |-<br /> | fontsize<br /> | Anger hur stor texten skall vara. Observera att värdet inte kan relateras till vanliga textstorlekar, du måste därför testa dig fram.<br /> |<br /> | 1.8<br /> |-<br /> | linewidth<br /> | Anger bredden på graflinjen. Giltiga värden 1 till 5. Även flyttal, ex 1.5, fungerar. Decimalkomma eller decimalpunkt spelar inte någon roll.<br /> |<br /> | 1.7<br /> |-<br /> | x<br /> | Specificerar hur bred grafen skall vara. Giltiga värden är 150-2500. 300 är standard.<br /> |<br /> | 1.2 (Tillåtna värden justerade i v 1.4,v 1.14)<br /> |-<br /> | y<br /> | Specificerar hur hög grafen skall vara. Giltiga värden är 125-2500. 200 är standard.<br /> |<br /> | 1.2 (Tillåtna värden justerade i v 1.4, v 1.14)<br /> |-<br /> | color<br /> | Anger vilken/vilka färger linjer i grafen skall ha, kommasepararead lista. Standard är #FF0000,#AADDAA,#FFCC00.<br /> |<br /> | 1.13<br /> |-<br /> | compare<br /> | Anger att order som skickats med p skall läggas in för jämförelse i samma graf. Om fler än tre orter anges måste även color definieras<br /> |<br /> | 1.13<br /> |}<br /> <br /> ==Beskrivning av returnerade fält==<br /> {| border=1 class="wikitable"<br /> |-<br /> ! Fält<br /> ! Beskrivning<br /> ! parameter som visar<br /> ! parameter som döljer<br /> ! Visas som standard<br /> ! Introducerad i API-version<br /> |-<br /> | <title><br /> | Mätpunktens namn på temperatur.nu<br /> | <br /> | <br /> | X<br /> | 1.0<br /> |-<br /> | <id><br /> | Mätpunktens id på temperatur.nu. Kan användas med parametern "p" för att hämta endast denna mätpunkts information<br /> |<br /> | simple<br /> | X<br /> | 1.0<br /> |-<br /> | <temp><br /> | Mätpunktens senaste temperatur. Om decimalkomma eller decimalpunkt skall användas styrs med parametern dc.<br /> |<br /> |<br /> | X<br /> | 1.0<br /> |-<br /> | <lat><br /> | Mätpunktens latitud i decimalt format. Om decimalkomma eller decimalpunkt skall användas styrs med parametern dc.<br /> | coordinates, verbose<br /> |<br /> |<br /> | 1.0<br /> |-<br /> | <lon><br /> | Mätpunktens longitud i decimalt format. Om decimalkomma eller decimalpunkt skall användas styrs med parametern dc.<br /> | coordinates, verbose<br /> |<br /> |<br /> | 1.0<br /> |-<br /> | <lastUpdate><br /> | Tidpunkt då informationen senast uppdaterades på temperatur.nu<br /> | verbose<br /> |<br /> |<br /> | 1.0<br /> |-<br /> | <kommun><br /> | Den kommun som mätpunkten ligger i.<br /> | verbose<br /> |<br /> |<br /> | 1.0<br /> |-<br /> | <lan><br /> | Det län som mätpunkten ligger i.<br /> | verbose<br /> |<br /> |<br /> | 1.0<br /> |-<br /> | <sourceInfo><br /> | En kort textsträng med information om vem som loggar temperaturen för mätpunkten<br /> | verbose<br /> |<br /> |<br /> | 1.8<br /> |-<br /> | <url><br /> | Url till mätpunktens temperatur och grafer på www.temperatur.nu<br /> | verbose<br /> |<br /> |<br /> | 1.0<br /> |-<br /> | <dist><br /> | Hur långt från de givna koordinaterna mätpunkten ligger. Enheten är kilometer. Om decimalkomma eller decimalpunkt skall användas styrs med parametern dc.<br /> | lat & lon<br /> | simple<br /> |<br /> | 1.0<br /> |-<br /> | <graph><br /> | Visar url till graph för orten. Observera att ny graf endast genereras när parametern graph används. Det går därför inte att lokalt cacha urlen i klienten. <br /> | graph (x, y, span, verbose_g, shift_g)<br /> |<br /> |<br /> | 1.2<br /> |-<br /> | <ClientVersion><br /> | Visar vilken den senaste släppta klientversionen är. Kan med fördel användas för att kontrollera om det finns någon uppdatering till klientmjukvaran.<br /> | version<br /> |<br /> |<br /> | 1.10<br /> |-<br /> | <ClientVersionSet><br /> | Visar status i samband med att informationen om klientversionen uppdaterats.<br /> | version_update<br /> |<br /> |<br /> | 1.10<br /> |-<br /> | <daily><br /> | Har underliggande fält <date>, <average>, <min>, <max> som representerar data för dygn angivet i fältet date. Dessa fält returneras när parametern daily används för att hämta statisk för flera dygn<br /> | daily, span, start, end, shift_g<br /> |<br /> |<br /> | 1.15<br /> |-<br /> | <ammRange><br /> | Visar för vilket tidsperspektiv amm (medel/min/max) har hämtats<br /> | amm, span, start, end, shift_g<br /> |<br /> |<br /> | 1.11<br /> |-<br /> | <average><br /> | Medeltemperatur i specificerat tidsperspektiv<br /> | amm, span, start, end, shift_g<br /> |<br /> |<br /> | 1.11<br /> |-<br /> | <min><br /> | Den minsta temperaturen i specificerat tidsperspektiv<br /> | amm, span, start, end, shift_g<br /> |<br /> |<br /> | 1.11<br /> |-<br /> | <minTime><br /> | Vid vilken tidpunkt <min> inträffade<br /> | amm, span, start, end, shift_g<br /> |<br /> |<br /> | 1.11<br /> |-<br /> | <max><br /> | Den högsta temperaturen i specificerat tidsperspektiv<br /> | amm, span, start, end, shift_g<br /> |<br /> |<br /> | 1.11<br /> |-<br /> | <maxTime><br /> | Vid vilken tidpunkt <max> inträffade<br /> | amm, span, start, end, shift_g<br /> |<br /> |<br /> | 1.11<br /> <br /> |}<br /> <br /> ==Exempel==<br /> <br /> Så här kan resultatet från en förfrågan på http://api.temperatur.nu/tnu_1.12.php?p=linkoping&verbose&cli=test_app se ut:<br /> <?xml version='1.0' encoding='iso-8859-1'?><br /> <rss version="2.0"><br /> <channel><br /> <title>Temperatur.nu API 1.12 - Din url är inte korrekt signerad, clientnyckeln kan tillfälligt blockeras - /tnu_1.12.php</title><br /> <link>http://wiki.temperatur.nu/index.php/Api</link><br /> <item><br /> <title>Linköping/Centrum</title><br /> <id>linkoping</id><br /> <temp>9.3</temp><br /> <lat>58.414297</lat><br /> <lon>15.628788</lon><br /> <lastUpdate>2011-11-24 08:51:25</lastUpdate><br /> <kommun>Linköping</kommun><br /> <lan>Östergötlands län</lan><br /> <sourceInfo>Temperaturdata från Stångå Hotell.</sourceInfo><br /> <url>http://www.temperatur.nu/linkoping.html</url><br /> </item><br /> </channel><br /> </rss><br /> <br /> <br /> Så här kan resultatet från en förfrågan på http://api.temperatur.nu/tnu_1.12.php?lat=58.376761&lon=15.562916&num=3&graph&cli=test_app2 se ut:<br /> <?xml version='1.0' encoding='iso-8859-1'?><br /> <rss version="2.0"><br /> <channel><br /> <title>Temperatur.nu API 1.12 - Din url är inte korrekt signerad, clientnyckeln kan tillfälligt blockeras - /tnu_1.12.php</title><br /> <link>http://wiki.temperatur.nu/index.php/Api</link><br /> <item><br /> <title>Linköping/Jägarvallen</title><br /> <id>jagarvallen</id><br /> <temp>7.8</temp><br /> <dist>2.5</dist><br /> <graph>http://www2.timg.nu/graph/jagarvallen-1day-300-200-0-0-0-1-8-n.png</graph><br /> </item><br /> <item><br /> <title>Linköping/Malmen (METAR)</title><br /> <id>malmen</id><br /> <temp>8.3</temp><br /> <dist>2.8</dist><br /> <graph>http://www2.timg.nu/graph/malmen-1day-300-200-0-0-0-1-8-n.png</graph><br /> </item><br /> <item><br /> <title>Linköping/Skäggetorp</title><br /> <id>skaggetorp</id><br /> <temp>9.1</temp><br /> <dist>5.2</dist><br /> <graph>http://www2.timg.nu/graph/skaggetorp-1day-300-200-0-0-0-1-8-n.png</graph><br /> </item><br /> </channel><br /> </rss><br /> <br /> <br /> ==Signering av URLer==<br /> Förfrågningar till APIet kan signeras. Från och med version 1.11 är antalet osignerade förfrågningar begränsade till 20 per timma. Osignerade förfrågningar kommer i framtiden att begränsas för alla api-versioner. Skriver du en privat tillämpning kan du använda APIet utan att signera URLerna.<br /> <br /> Signeringen går till så här:<br /> <br /> 1. Skapa din url som vanligt.<br /> <br /> 2. Beräkna md5-/sha1-summan av urlen (utan http://) med "+clientnyckel" tillagd på slutet. Klientnyckel erhålls efter att ha mailat [mailto:support@temperatur.nu support@temperatur.nu]<br /> <br /> 3. I slutet av urlen lägger du sedan till &sign=md5-/sha1-summa<br /> <br /> I php kan det tex se ut så här om du har en signeringsnyckel för md5:<br /> $cli_key="XXXXXXXXXXXXXXXXXXXXXXXXX";<br /> $url="api.temperatur.nu/tnu_1.9.php?p=linkoping&cli=testapp"<br /> $sign=md5($url."+".$cli_key);<br /> $signed_url=$url."&sign=".$sign;<br /> <br /> I den returnerade xml-filen kan du i det första title-fältet se om förfrågan är korrekt signerad.<br /> <br /> [http://www.fileformat.info/tool/hash.htm?text= fileformat.info] är en mycket bra sida för att verifiera att de sha1-/md5-summor du tagit fram stämmer.<br /> <br /> ==Historik/ändringslogg==<br /> 2010-05-04 - Version 1.0<br /> Första releasen.<br /> <br /> 2010-05-13 - Version 1.1<br /> Variabeln cli tillagd.<br /> <br /> 2010-05-19 - Version 1.2<br /> Stöd för att hämta grafer<br /> <br /> 2010-06-09 - Version 1.3<br /> Bugfix som fixar en bugg introducerad i 1.2 (det gick inte att hämta alla orter genom att skippa variabeln p).<br /> <br /> 2010-08-04 - Version 1.4<br /> Värden för x och y justerade. Parametern cli krävs för att apiet skall returnera data.<br /> <br /> 2010-09-01 - Version 1.5<br /> Parametrar för att via mer info i grafen. Parametrar för att visa grafer för i går, förra veckan, 2 år sedan etc.<br /> <br /> 2010-09-01 - Version 1.6<br /> Parameter för att ange om 1 eller 2 y-axlar skall visas.<br /> <br /> 2010-11-22 - Version 1.7<br /> Möjlighet att välja hur tjock graflinjen skall vara.<br /> <br /> 2010-12-19 - Version 1.8<br /> CacheBust-funktion, möjlighet att ändra textstorlek samt information om vem som loggar temperaturen när verbose är specat.<br /> <br /> 2011-01-13 - Version 1.9<br /> Signeringsfunktion inlagd. Signeringsfunktionen kommer från mitten av 2011 krävas för alla tillämpningar och och kommer successivt att läggas in i alla versioner av apiet.<br /> <br /> 2011-01-17 - Version 1.10<br /> Möjlighet att via Apiet hantera informaion gällande den senaste tillgängliga klientversionen.<br /> <br /> 2011-01-30 - Version 1.11<br /> Mer flexibel specificering av tidsperspektiv för grafer. amm - möjlighet att hämta medel/min/max i ett valfritt tidsperspektiv, antalet osignerade accesser begränsat i denna version.<br /> <br /> 2011-10-08 - Version 1.12<br /> Variabeln history tillagd. Visar föregående periods temperatur i grafer.<br /> <br /> 2012-05-04 - Version 1.13<br /> Variablerna compare och color angivna, gör det möjligt att jämföra flera orter i samma graf samt helt styra vilka färger linjerna i graferna skall ha. color kan sättas även för vanliga grafer.<br /> <br /> 2013 - Version 1.14<br /> Parametern history_year som används för att jämföra data med tidigare år. Buggfixar<br /> <br /> 2014-01-26 - Version 1.15<br /> Parametern daily. Används för att hämta dygnsmedel i ett specificerat tidsspann.<br /> <br /> [[Kategori:www.temperatur.nu]]<br /> [[Kategori:Mjukvara]]</div>

Elf98 https://wiki.temperatur.nu/index.php?title=API&diff=754 API 2019-10-12T14:38:12Z

<p>Elf98: </p> <hr /> <div>{| align="right"<br /> | __TOC__<br /> |}<br /> Det finns ett enkelt API för att hämta senaste temperaturerna från temperatur.nu.<br /> <br /> Aktuell API-version 1.15. <br /> <br /> Data returneras i XML-format<br /> <br /> ==Support==<br /> För support på API-funktionen, använd [http://www.temperatur.nu/forum/forslag-feedback/diskusionstrad-for-api-funktionen-t1373.html Forumet på www.temperatur.nu].<br /> <br /> ==Villkor==<br /> *Mjukvaran skall skrivas på ett sådant sätt att APIet inte automatiskt belastas med samma fråga oftare än var femte minut från en enskild klient. Klientid som bryter mot detta villkor kan komma att blockeras. <br /> *Det måste mycket tydligt framgå att temperaturerna kommer från temperatur.nu.<br /> *Där så är möjligt skall temperaturerna vara länkar till temperatur.nu.<br /> *Temperatur.nus [[Logotype|logotype]] skall finnas i applikationen, gärna så den tydligt syns när programmet används. Om detta ej är möjligt kan logotypen placeras där inställningar för applikationen görs.<br /> *APIet får ej användas för att automatiskt samla in och lagra data längre än 24h.<br /> *I de fall applikationen kommer att kosta pengar för användaren krävs särskild överenskommelse med temperatur.nu. Kontakta [mailto:support@temperatur.nu support@temperatur.nu] för mer information.<br /> *Förfrågningar till APIet kan signeras, från och med version 1.11 är osignerade förfrågningar är begränsade till ca 20/timma per klientid. Denna begränsning kommer efter hand att läggas in även på de äldre versionerna. Maila [mailto:support@temperatur.nu support@temperatur.nu] för att att erhålla en signeringsnyckel för ditt klientid. När du ansöker om en signeringsnyckel måste du ange om du vill signera med sha1 eller md5. Läs mer om hur du signerar förfrågningarna längre ner på denna sida.<br /> *Du skall skriva en beskrivning av din mjukvara i denna Wiki. På så sätt kommer fler intresserade att hitta din applikation. Klienter som inte finns beskrivna i Wikin kan komma att blockeras. [[Mjukvaror_som_använder_APIet|Här finns en lista med kända klienter]]<br /> <br /> <br /> ==Kort beskrivning==<br /> APIet är tänkt att användas av de som skapar extern mjukvara, tex applikationer för Iphone och Android.<br /> Målet är att APIet skall vara lättförståeligt och lätt att använda - feedback från användarna är av stor vikt för att kunna utveckla APIet!<br /> <br /> ==Var finns APIet?==<br /> Du accessar APIet via http://api.temperatur.nu/tnu_1.<version>.php. ex: http://api.temperatur.nu/tnu_1.12.php<br /> <br /> ==Parametrar==<br /> Generellta parametrar<br /> <br /> {| border=1 class="wikitable"<br /> |-<br /> ! Parameter<br /> ! Beskrivning<br /> ! Kan ej användas med<br /> ! Introducerad i API-version<br /> |-<br /> | p<br /> | Anger för vilka orter data skall returneras - kommaseparerad lista. Utelämnas parametern returneras samtliga mätpunkter.<br /> | lat, lon, num<br /> | 1.0<br /> |-<br /> | dc<br /> | Anger om decimalkomma skall användas i stället för decimalpunkt i fälten <temperatur>, <lat>, <lon> och <dist>.<br /> |<br /> | 1.0<br /> |-<br /> | simple<br /> | Minimal output, returnerar endast <title>, <id> och <temp><br /> | verbose<br /> | 1.0<br /> |-<br /> | verbose<br /> | Returnerar alla fält för orten, se beskrivning nedan<br /> | simple<br /> | 1.0<br /> |-<br /> | coordinates<br /> | Visar koordinaterna för valda orter. Kan användas tillsammans med simple för att kunna positionera orter på en karta utan att behöva hämta alla fält.<br /> | verbose<br /> | 1.0<br /> |-<br /> | lat<br /> | Används tillsammans med lon och ev num. Det spelar inte någon roll om decimal- eller kommapunkt används. När dessa parametrar används returneras de num närmaste orterna, närmaste orten först.<br /> | p<br /> | 1.0<br /> |-<br /> | lon<br /> | Används tillsammans med lat och ev num. Det spelar inte någon roll om decimal- eller kommapunkt används. När dessa parametrar används returneras de num närmaste orterna, närmaste orten först..<br /> | p<br /> | 1.0<br /> |-<br /> | num<br /> | Används tillsammans med lat och lon. Anger hur många orter som skall returneras. Standard är 1 och max är 5 (10 från v 1.12).<br /> | p<br /> | 1.0<br /> |-<br /> | cb<br /> | CacheBust. Om denna parameter finns i urlen (&cb) kommer ett randomiserat värde att läggas till i slutet av graf-urlerna. Denna parameter kan användas för att se till att inte grafen cachas lokalt hos användaren eller i någon dåligt konfigurerad proxy mellan temperatur.nu och användaren.<br /> |<br /> | 1.8<br /> |-<br /> | cli <br /> | Skall användas för att identifiera vilken klient som hämtar data. Ex "cli=tnu_widget". Från mitten av 2011 kommer signering av urlerna krävas i kombination med cli. Läs mer längre ner.<br /> |<br /> | 1.1<br /> |-<br /> | sign<br /> | Skall APIet regelbundet måste URLerna signeras. Se information längre ner på denna sida.<br /> |<br /> | 1.0 (tillagd i efterhand)<br /> |-<br /> | version<br /> | Returnerar senaste klientversionen, kan användas för att enkelt meddela klienterna att det finns nya uppdateringar till mjukvaran.<br /> | Alla andra parametrar förutom cli och sign ignoreras<br /> | 1.10<br /> |-<br /> | version_update<br /> | Denna parameter skall normalt aldrig vara inlagd i någon mjukvara utan används av utvecklaren för att uppdatera databasen på temperatur.nu i samband med att en ny version av klientmjukvaran släpps. Urlen måste vara signerad för att kunna uppdatera informationen.<br /> | Alla andra parametrar förutom cli och sign ignoreras<br /> | 1.10<br /> |}<br /> <br /> Parametrar som är relaterade till att hämta statistik<br /> {| border=1 class="wikitable"<br /> |-<br /> ! Parameter<br /> ! Beskrivning<br /> ! Kan ej användas med<br /> ! Introducerad i API-version<br /> |-<br /> | amm<br /> | Används för att hämta Average, Min & Max för upp till 5 (10 från v1.12) orter specificerade med variabeln p.<br /> | graph<br /> | 1.11<br /> |-<br /> | daily<br /> | Används för att hämta dygnsmedel samt lägsta och högsta temperatur per dygn. En mätpunkt spcificerad med variabeln p.<br /> | graph<br /> | 1.15<br /> |-<br /> | span<br /> | Specificerar för vilket tidsperspektiv Average, Min & Max skall skapas. Giltiga värden är: 1day (standard), 1week, 1month, 1year.<br /> | start, end<br /> | 1.2<br /> |-<br /> | shift_g<br /> |Anger om daily skall visa äldre data. Exempel: om span är 1month och shift_g är 1 hämtas data för föregående månad. Standard är 0.<br /> | start, end<br /> | 1.15<br /> |-<br /> | start<br /> | Specificerar starttid för amm. Formatet är Y-m-d-H-i, ex 2011-01-30-12-31.<br /> | span<br /> | 1.11<br /> |-<br /> | end<br /> | Specificerar sluttid för amm. Formatet är Y-m-d-H-i, ex 2011-01-30-12-31. Standard är nuvarande tid<br /> | span<br /> | 1.11<br /> |}<br /> <br /> Parametrar som är relaterade till grafgenerering:<br /> {| border=1 class="wikitable"<br /> |-<br /> ! Parameter<br /> ! Beskrivning<br /> ! Kan ej användas med<br /> ! Introducerad i API-version<br /> |-<br /> | graph<br /> | Används för att generera en graf för upp till 5 orter specificerade med variabeln p. Anges variablen compare kommer orterna att läggas in i samma graf i stället för separata.<br /> | amm<br /> | 1.2<br /> |-<br /> | span<br /> | Specificerar för vilket tidsperspektiv grafer skall skapas. Giltiga värden är: 1day (standard), 1week, 1month, 1year.<br /> | start, end<br /> | 1.2<br /> |-<br /> | shift_g<br /> | Anger om grafen skall visa äldre data. Exempel: om span är 1day och shift_g är 1 visas en graf för igår, om shift_g är 2 visar grafen data för i förrgår etc. Standard är 0.<br /> | start, end<br /> | 1.5<br /> |-<br /> | start<br /> | Specificerar starttid för graph eller amm. Formatet är Y-m-d-H-i, ex 2011-01-30-12-31.<br /> | span, shift_g, history<br /> | 1.11<br /> |-<br /> | end<br /> | Specificerar sluttid för graph eller amm. Formatet är Y-m-d-H-i, ex 2011-01-30-12-31. Standard är nuvarande tid<br /> | span, shift_g, history<br /> | 1.11<br /> |-<br /> | history<br /> | Används för att i grafen lägga in föregående periods temperatur. Visas temperaturen för det senaste dygnet visas föregående 24h i en annan färg etc. Kan förklarliga skäl endast användas med variabeln graph.<br /> | start, end<br /> | 1.12<br /> |-<br /> | history_year<br /> | Används för att i grafen lägga in jämförelse med annat år. År anges med 4 siffror, ex 2013. Kan förklarliga skäl endast användas med variabeln graph.<br /> | start, end<br /> | 1.14<br /> |-<br /> | verbose_g<br /> | Visar min/max/medel/senaste värde i grafen. Visar även när data senast hämtades för den valda orten.<br /> |<br /> | 1.5<br /> |-<br /> | 1axis<br /> | Används för att endast visa temperaturskalan till vänster. Används med fördel i små grafer för att spara utrymme.<br /> |<br /> | 1.6<br /> |-<br /> | fontsize<br /> | Anger hur stor texten skall vara. Observera att värdet inte kan relateras till vanliga textstorlekar, du måste därför testa dig fram.<br /> |<br /> | 1.8<br /> |-<br /> | linewidth<br /> | Anger bredden på graflinjen. Giltiga värden 1 till 5. Även flyttal, ex 1.5, fungerar. Decimalkomma eller decimalpunkt spelar inte någon roll.<br /> |<br /> | 1.7<br /> |-<br /> | x<br /> | Specificerar hur bred grafen skall vara. Giltiga värden är 150-2500. 300 är standard.<br /> |<br /> | 1.2 (Tillåtna värden justerade i v 1.4,v 1.14)<br /> |-<br /> | y<br /> | Specificerar hur hög grafen skall vara. Giltiga värden är 125-2500. 200 är standard.<br /> |<br /> | 1.2 (Tillåtna värden justerade i v 1.4, v 1.14)<br /> |-<br /> | color<br /> | Anger vilken/vilka färger linjer i grafen skall ha, kommasepararead lista. Standard är #FF0000,#AADDAA,#FFCC00.<br /> |<br /> | 1.13<br /> |-<br /> | compare<br /> | Anger att order som skickats med p skall läggas in för jämförelse i samma graf. Om fler än tre orter anges måste även color definieras<br /> |<br /> | 1.13<br /> |}<br /> ==Beskrivning av returnerade fält==<br /> {| border=1 class="wikitable"<br /> |-<br /> ! Fält<br /> ! Beskrivning<br /> ! parameter som visar<br /> ! parameter som döljer<br /> ! Visas som standard<br /> ! Introducerad i API-version<br /> |-<br /> | <title><br /> | Mätpunktens namn på temperatur.nu<br /> | <br /> | <br /> | X<br /> | 1.0<br /> |-<br /> | <id><br /> | Mätpunktens id på temperatur.nu. Kan användas med parametern "p" för att hämta endast denna mätpunkts information<br /> |<br /> | simple<br /> | X<br /> | 1.0<br /> |-<br /> | <temp><br /> | Mätpunktens senaste temperatur. Om decimalkomma eller decimalpunkt skall användas styrs med parametern dc.<br /> |<br /> |<br /> | X<br /> | 1.0<br /> |-<br /> | <lat><br /> | Mätpunktens latitud i decimalt format. Om decimalkomma eller decimalpunkt skall användas styrs med parametern dc.<br /> | coordinates, verbose<br /> |<br /> |<br /> | 1.0<br /> |-<br /> | <lon><br /> | Mätpunktens longitud i decimalt format. Om decimalkomma eller decimalpunkt skall användas styrs med parametern dc.<br /> | coordinates, verbose<br /> |<br /> |<br /> | 1.0<br /> |-<br /> | <lastUpdate><br /> | Tidpunkt då informationen senast uppdaterades på temperatur.nu<br /> | verbose<br /> |<br /> |<br /> | 1.0<br /> |-<br /> | <kommun><br /> | Den kommun som mätpunkten ligger i.<br /> | verbose<br /> |<br /> |<br /> | 1.0<br /> |-<br /> | <lan><br /> | Det län som mätpunkten ligger i.<br /> | verbose<br /> |<br /> |<br /> | 1.0<br /> |-<br /> | <sourceInfo><br /> | En kort textsträng med information om vem som loggar temperaturen för mätpunkten<br /> | verbose<br /> |<br /> |<br /> | 1.8<br /> |-<br /> | <url><br /> | Url till mätpunktens temperatur och grafer på www.temperatur.nu<br /> | verbose<br /> |<br /> |<br /> | 1.0<br /> |-<br /> | <dist><br /> | Hur långt från de givna koordinaterna mätpunkten ligger. Enheten är kilometer. Om decimalkomma eller decimalpunkt skall användas styrs med parametern dc.<br /> | lat & lon<br /> | simple<br /> |<br /> | 1.0<br /> |-<br /> | <graph><br /> | Visar url till graph för orten. Observera att ny graf endast genereras när parametern graph används. Det går därför inte att lokalt cacha urlen i klienten. <br /> | graph (x, y, span, verbose_g, shift_g)<br /> |<br /> |<br /> | 1.2<br /> |-<br /> | <ClientVersion><br /> | Visar vilken den senaste släppta klientversionen är. Kan med fördel användas för att kontrollera om det finns någon uppdatering till klientmjukvaran.<br /> | version<br /> |<br /> |<br /> | 1.10<br /> |-<br /> | <ClientVersionSet><br /> | Visar status i samband med att informationen om klientversionen uppdaterats.<br /> | version_update<br /> |<br /> |<br /> | 1.10<br /> |-<br /> | <daily><br /> | Har underliggande fält <date>, <average>, <min>, <max> som representerar data för dygn angivet i fältet date. Dessa fält returneras när parametern daily används för att hämta statisk för flera dygn<br /> | daily, span, start, end, shift_g<br /> |<br /> |<br /> | 1.15<br /> |-<br /> | <ammRange><br /> | Visar för vilket tidsperspektiv amm (medel/min/max) har hämtats<br /> | amm, span, start, end, shift_g<br /> |<br /> |<br /> | 1.11<br /> |-<br /> | <average><br /> | Medeltemperatur i specificerat tidsperspektiv<br /> | amm, span, start, end, shift_g<br /> |<br /> |<br /> | 1.11<br /> |-<br /> | <min><br /> | Den minsta temperaturen i specificerat tidsperspektiv<br /> | amm, span, start, end, shift_g<br /> |<br /> |<br /> | 1.11<br /> |-<br /> | <minTime><br /> | Vid vilken tidpunkt <min> inträffade<br /> | amm, span, start, end, shift_g<br /> |<br /> |<br /> | 1.11<br /> |-<br /> | <max><br /> | Den högsta temperaturen i specificerat tidsperspektiv<br /> | amm, span, start, end, shift_g<br /> |<br /> |<br /> | 1.11<br /> |-<br /> | <maxTime><br /> | Vid vilken tidpunkt <max> inträffade<br /> | amm, span, start, end, shift_g<br /> |<br /> |<br /> | 1.11<br /> <br /> |}<br /> <br /> ==Exempel==<br /> <br /> Så här kan resultatet från en förfrågan på http://api.temperatur.nu/tnu_1.12.php?p=linkoping&verbose&cli=test_app se ut:<br /> <?xml version='1.0' encoding='iso-8859-1'?><br /> <rss version="2.0"><br /> <channel><br /> <title>Temperatur.nu API 1.12 - Din url är inte korrekt signerad, clientnyckeln kan tillfälligt blockeras - /tnu_1.12.php</title><br /> <link>http://wiki.temperatur.nu/index.php/Api</link><br /> <item><br /> <title>Linköping/Centrum</title><br /> <id>linkoping</id><br /> <temp>9.3</temp><br /> <lat>58.414297</lat><br /> <lon>15.628788</lon><br /> <lastUpdate>2011-11-24 08:51:25</lastUpdate><br /> <kommun>Linköping</kommun><br /> <lan>Östergötlands län</lan><br /> <sourceInfo>Temperaturdata från Stångå Hotell.</sourceInfo><br /> <url>http://www.temperatur.nu/linkoping.html</url><br /> </item><br /> </channel><br /> </rss><br /> <br /> <br /> Så här kan resultatet från en förfrågan på http://api.temperatur.nu/tnu_1.12.php?lat=58.376761&lon=15.562916&num=3&graph&cli=test_app2 se ut:<br /> <?xml version='1.0' encoding='iso-8859-1'?><br /> <rss version="2.0"><br /> <channel><br /> <title>Temperatur.nu API 1.12 - Din url är inte korrekt signerad, clientnyckeln kan tillfälligt blockeras - /tnu_1.12.php</title><br /> <link>http://wiki.temperatur.nu/index.php/Api</link><br /> <item><br /> <title>Linköping/Jägarvallen</title><br /> <id>jagarvallen</id><br /> <temp>7.8</temp><br /> <dist>2.5</dist><br /> <graph>http://www2.timg.nu/graph/jagarvallen-1day-300-200-0-0-0-1-8-n.png</graph><br /> </item><br /> <item><br /> <title>Linköping/Malmen (METAR)</title><br /> <id>malmen</id><br /> <temp>8.3</temp><br /> <dist>2.8</dist><br /> <graph>http://www2.timg.nu/graph/malmen-1day-300-200-0-0-0-1-8-n.png</graph><br /> </item><br /> <item><br /> <title>Linköping/Skäggetorp</title><br /> <id>skaggetorp</id><br /> <temp>9.1</temp><br /> <dist>5.2</dist><br /> <graph>http://www2.timg.nu/graph/skaggetorp-1day-300-200-0-0-0-1-8-n.png</graph><br /> </item><br /> </channel><br /> </rss><br /> <br /> <br /> ==Signering av URLer==<br /> Förfrågningar till APIet kan signeras. Från och med version 1.11 är antalet osignerade förfrågningar begränsade till 20 per timma. Osignerade förfrågningar kommer i framtiden att begränsas för alla api-versioner. Skriver du en privat tillämpning kan du använda APIet utan att signera URLerna.<br /> <br /> Signeringen går till så här:<br /> <br /> 1. Skapa din url som vanligt.<br /> <br /> 2. Beräkna md5-/sha1-summan av urlen (utan http://) med "+clientnyckel" tillagd på slutet. Klientnyckel erhålls efter att ha mailat [mailto:support@temperatur.nu support@temperatur.nu]<br /> <br /> 3. I slutet av urlen lägger du sedan till &sign=md5-/sha1-summa<br /> <br /> I php kan det tex se ut så här om du har en signeringsnyckel för md5:<br /> $cli_key="XXXXXXXXXXXXXXXXXXXXXXXXX";<br /> $url="api.temperatur.nu/tnu_1.9.php?p=linkoping&cli=testapp"<br /> $sign=md5($url."+".$cli_key);<br /> $signed_url=$url."&sign=".$sign;<br /> <br /> I den returnerade xml-filen kan du i det första title-fältet se om förfrågan är korrekt signerad.<br /> <br /> [http://www.fileformat.info/tool/hash.htm?text= fileformat.info] är en mycket bra sida för att verifiera att de sha1-/md5-summor du tagit fram stämmer.<br /> <br /> ==Historik/ändringslogg==<br /> 2010-05-04 - Version 1.0<br /> Första releasen.<br /> <br /> 2010-05-13 - Version 1.1<br /> Variabeln cli tillagd.<br /> <br /> 2010-05-19 - Version 1.2<br /> Stöd för att hämta grafer<br /> <br /> 2010-06-09 - Version 1.3<br /> Bugfix som fixar en bugg introducerad i 1.2 (det gick inte att hämta alla orter genom att skippa variabeln p).<br /> <br /> 2010-08-04 - Version 1.4<br /> Värden för x och y justerade. Parametern cli krävs för att apiet skall returnera data.<br /> <br /> 2010-09-01 - Version 1.5<br /> Parametrar för att via mer info i grafen. Parametrar för att visa grafer för i går, förra veckan, 2 år sedan etc.<br /> <br /> 2010-09-01 - Version 1.6<br /> Parameter för att ange om 1 eller 2 y-axlar skall visas.<br /> <br /> 2010-11-22 - Version 1.7<br /> Möjlighet att välja hur tjock graflinjen skall vara.<br /> <br /> 2010-12-19 - Version 1.8<br /> CacheBust-funktion, möjlighet att ändra textstorlek samt information om vem som loggar temperaturen när verbose är specat.<br /> <br /> 2011-01-13 - Version 1.9<br /> Signeringsfunktion inlagd. Signeringsfunktionen kommer från mitten av 2011 krävas för alla tillämpningar och och kommer successivt att läggas in i alla versioner av apiet.<br /> <br /> 2011-01-17 - Version 1.10<br /> Möjlighet att via Apiet hantera informaion gällande den senaste tillgängliga klientversionen.<br /> <br /> 2011-01-30 - Version 1.11<br /> Mer flexibel specificering av tidsperspektiv för grafer. amm - möjlighet att hämta medel/min/max i ett valfritt tidsperspektiv, antalet osignerade accesser begränsat i denna version.<br /> <br /> 2011-10-08 - Version 1.12<br /> Variabeln history tillagd. Visar föregående periods temperatur i grafer.<br /> <br /> 2012-05-04 - Version 1.13<br /> Variablerna compare och color angivna, gör det möjligt att jämföra flera orter i samma graf samt helt styra vilka färger linjerna i graferna skall ha. color kan sättas även för vanliga grafer.<br /> <br /> 2013 - Version 1.14<br /> Parametern history_year som används för att jämföra data med tidigare år. Buggfixar<br /> <br /> 2014-01-26 - Version 1.15<br /> Parametern daily. Används för att hämta dygnsmedel i ett specificerat tidsspann.<br /> <br /> [[Kategori:www.temperatur.nu]]<br /> [[Kategori:Mjukvara]]</div>

Elf98 https://wiki.temperatur.nu/index.php?title=API&diff=753 API 2019-10-12T10:07:52Z

<p>Elf98: /* Signering av URLer */</p> <hr /> <div>{| align="right"<br /> | __TOC__<br /> |}<br /> Det finns ett enkelt API för att hämta senaste temperaturerna från temperatur.nu.<br /> <br /> Aktuell API-version 1.15. <br /> <br /> Data returneras i XML-format<br /> <br /> ==Support==<br /> För support på API-funktionen, använd [http://www.temperatur.nu/forum/forslag-feedback/diskusionstrad-for-api-funktionen-t1373.html Forumet på www.temperatur.nu].<br /> <br /> ==Villkor==<br /> *Mjukvaran skall skrivas på ett sådant sätt att APIet inte automatiskt belastas med samma fråga oftare än var femte minut från en enskild klient. Klientid som bryter mot detta villkor kan komma att blockeras. <br /> *Det måste mycket tydligt framgå att temperaturerna kommer från temperatur.nu.<br /> *Där så är möjligt skall temperaturerna vara länkar till temperatur.nu.<br /> *Temperatur.nus [[Logotype|logotype]] skall finnas i applikationen, gärna så den tydligt syns när programmet används. Om detta ej är möjligt kan logotypen placeras där inställningar för applikationen görs.<br /> *APIet får ej användas för att automatiskt samla in och lagra data längre än 24h.<br /> *I de fall applikationen kommer att kosta pengar för användaren krävs särskild överenskommelse med temperatur.nu. Kontakta [mailto:info@temperatur.nu info@temperatur.nu] för mer information.<br /> *Förfrågningar till APIet kan signeras, från och med version 1.11 är osignerade förfrågningar är begränsade till ca 20/timma per klientid. Denna begränsning kommer efter hand att läggas in även på de äldre versionerna. Maila [mailto:info@temperatur.nu info@temperatur.nu] för att att erhålla en signeringsnyckel för ditt klientid. När du ansöker om en signeringsnyckel måste du ange om du vill signera med sha1 eller md5. Läs mer om hur du signerar förfrågningarna längre ner på denna sida.<br /> *Du skall skriva en beskrivning av din mjukvara i denna Wiki. På så sätt kommer fler intresserade att hitta din applikation. Klienter som inte finns beskrivna i Wikin kan komma att blockeras. [[Mjukvaror_som_använder_APIet|Här finns en lista med kända klienter]]<br /> <br /> <br /> ==Kort beskrivning==<br /> APIet är tänkt att användas av de som skapar extern mjukvara, tex applikationer för Iphone och Android.<br /> Målet är att APIet skall vara lättförståeligt och lätt att använda - feedback från användarna är av stor vikt för att kunna utveckla APIet!<br /> <br /> ==Var finns APIet?==<br /> Du accessar APIet via http://api.temperatur.nu/tnu_1.<version>.php. ex: http://api.temperatur.nu/tnu_1.12.php<br /> <br /> ==Parametrar==<br /> Generellta parametrar<br /> <br /> {| border=1 class="wikitable"<br /> |-<br /> ! Parameter<br /> ! Beskrivning<br /> ! Kan ej användas med<br /> ! Introducerad i API-version<br /> |-<br /> | p<br /> | Anger för vilka orter data skall returneras - kommaseparerad lista. Utelämnas parametern returneras samtliga mätpunkter.<br /> | lat, lon, num<br /> | 1.0<br /> |-<br /> | dc<br /> | Anger om decimalkomma skall användas i stället för decimalpunkt i fälten <temperatur>, <lat>, <lon> och <dist>.<br /> |<br /> | 1.0<br /> |-<br /> | simple<br /> | Minimal output, returnerar endast <title>, <id> och <temp><br /> | verbose<br /> | 1.0<br /> |-<br /> | verbose<br /> | Returnerar alla fält för orten, se beskrivning nedan<br /> | simple<br /> | 1.0<br /> |-<br /> | coordinates<br /> | Visar koordinaterna för valda orter. Kan användas tillsammans med simple för att kunna positionera orter på en karta utan att behöva hämta alla fält.<br /> | verbose<br /> | 1.0<br /> |-<br /> | lat<br /> | Används tillsammans med lon och ev num. Det spelar inte någon roll om decimal- eller kommapunkt används. När dessa parametrar används returneras de num närmaste orterna, närmaste orten först.<br /> | p<br /> | 1.0<br /> |-<br /> | lon<br /> | Används tillsammans med lat och ev num. Det spelar inte någon roll om decimal- eller kommapunkt används. När dessa parametrar används returneras de num närmaste orterna, närmaste orten först..<br /> | p<br /> | 1.0<br /> |-<br /> | num<br /> | Används tillsammans med lat och lon. Anger hur många orter som skall returneras. Standard är 1 och max är 5 (10 från v 1.12).<br /> | p<br /> | 1.0<br /> |-<br /> | cb<br /> | CacheBust. Om denna parameter finns i urlen (&cb) kommer ett randomiserat värde att läggas till i slutet av graf-urlerna. Denna parameter kan användas för att se till att inte grafen cachas lokalt hos användaren eller i någon dåligt konfigurerad proxy mellan temperatur.nu och användaren.<br /> |<br /> | 1.8<br /> |-<br /> | cli <br /> | Skall användas för att identifiera vilken klient som hämtar data. Ex "cli=tnu_widget". Från mitten av 2011 kommer signering av urlerna krävas i kombination med cli. Läs mer längre ner.<br /> |<br /> | 1.1<br /> |-<br /> | sign<br /> | Skall APIet regelbundet måste URLerna signeras. Se information längre ner på denna sida.<br /> |<br /> | 1.0 (tillagd i efterhand)<br /> |-<br /> | version<br /> | Returnerar senaste klientversionen, kan användas för att enkelt meddela klienterna att det finns nya uppdateringar till mjukvaran.<br /> | Alla andra parametrar förutom cli och sign ignoreras<br /> | 1.10<br /> |-<br /> | version_update<br /> | Denna parameter skall normalt aldrig vara inlagd i någon mjukvara utan används av utvecklaren för att uppdatera databasen på temperatur.nu i samband med att en ny version av klientmjukvaran släpps. Urlen måste vara signerad för att kunna uppdatera informationen.<br /> | Alla andra parametrar förutom cli och sign ignoreras<br /> | 1.10<br /> |}<br /> <br /> Parametrar som är relaterade till att hämta statistik<br /> {| border=1 class="wikitable"<br /> |-<br /> ! Parameter<br /> ! Beskrivning<br /> ! Kan ej användas med<br /> ! Introducerad i API-version<br /> |-<br /> | amm<br /> | Används för att hämta Average, Min & Max för upp till 5 (10 från v1.12) orter specificerade med variabeln p.<br /> | graph<br /> | 1.11<br /> |-<br /> | daily<br /> | Används för att hämta dygnsmedel samt lägsta och högsta temperatur per dygn. En mätpunkt spcificerad med variabeln p.<br /> | graph<br /> | 1.15<br /> |-<br /> | span<br /> | Specificerar för vilket tidsperspektiv Average, Min & Max skall skapas. Giltiga värden är: 1day (standard), 1week, 1month, 1year.<br /> | start, end<br /> | 1.2<br /> |-<br /> | shift_g<br /> |Anger om daily skall visa äldre data. Exempel: om span är 1month och shift_g är 1 hämtas data för föregående månad. Standard är 0.<br /> | start, end<br /> | 1.15<br /> |-<br /> | start<br /> | Specificerar starttid för amm. Formatet är Y-m-d-H-i, ex 2011-01-30-12-31.<br /> | span<br /> | 1.11<br /> |-<br /> | end<br /> | Specificerar sluttid för amm. Formatet är Y-m-d-H-i, ex 2011-01-30-12-31. Standard är nuvarande tid<br /> | span<br /> | 1.11<br /> |}<br /> <br /> Parametrar som är relaterade till grafgenerering:<br /> {| border=1 class="wikitable"<br /> |-<br /> ! Parameter<br /> ! Beskrivning<br /> ! Kan ej användas med<br /> ! Introducerad i API-version<br /> |-<br /> | graph<br /> | Används för att generera en graf för upp till 5 orter specificerade med variabeln p. Anges variablen compare kommer orterna att läggas in i samma graf i stället för separata.<br /> | amm<br /> | 1.2<br /> |-<br /> | span<br /> | Specificerar för vilket tidsperspektiv grafer skall skapas. Giltiga värden är: 1day (standard), 1week, 1month, 1year.<br /> | start, end<br /> | 1.2<br /> |-<br /> | shift_g<br /> | Anger om grafen skall visa äldre data. Exempel: om span är 1day och shift_g är 1 visas en graf för igår, om shift_g är 2 visar grafen data för i förrgår etc. Standard är 0.<br /> | start, end<br /> | 1.5<br /> |-<br /> | start<br /> | Specificerar starttid för graph eller amm. Formatet är Y-m-d-H-i, ex 2011-01-30-12-31.<br /> | span, shift_g, history<br /> | 1.11<br /> |-<br /> | end<br /> | Specificerar sluttid för graph eller amm. Formatet är Y-m-d-H-i, ex 2011-01-30-12-31. Standard är nuvarande tid<br /> | span, shift_g, history<br /> | 1.11<br /> |-<br /> | history<br /> | Används för att i grafen lägga in föregående periods temperatur. Visas temperaturen för det senaste dygnet visas föregående 24h i en annan färg etc. Kan förklarliga skäl endast användas med variabeln graph.<br /> | start, end<br /> | 1.12<br /> |-<br /> | history_year<br /> | Används för att i grafen lägga in jämförelse med annat år. År anges med 4 siffror, ex 2013. Kan förklarliga skäl endast användas med variabeln graph.<br /> | start, end<br /> | 1.14<br /> |-<br /> | verbose_g<br /> | Visar min/max/medel/senaste värde i grafen. Visar även när data senast hämtades för den valda orten.<br /> |<br /> | 1.5<br /> |-<br /> | 1axis<br /> | Används för att endast visa temperaturskalan till vänster. Används med fördel i små grafer för att spara utrymme.<br /> |<br /> | 1.6<br /> |-<br /> | fontsize<br /> | Anger hur stor texten skall vara. Observera att värdet inte kan relateras till vanliga textstorlekar, du måste därför testa dig fram.<br /> |<br /> | 1.8<br /> |-<br /> | linewidth<br /> | Anger bredden på graflinjen. Giltiga värden 1 till 5. Även flyttal, ex 1.5, fungerar. Decimalkomma eller decimalpunkt spelar inte någon roll.<br /> |<br /> | 1.7<br /> |-<br /> | x<br /> | Specificerar hur bred grafen skall vara. Giltiga värden är 150-2500. 300 är standard.<br /> |<br /> | 1.2 (Tillåtna värden justerade i v 1.4,v 1.14)<br /> |-<br /> | y<br /> | Specificerar hur hög grafen skall vara. Giltiga värden är 125-2500. 200 är standard.<br /> |<br /> | 1.2 (Tillåtna värden justerade i v 1.4, v 1.14)<br /> |-<br /> | color<br /> | Anger vilken/vilka färger linjer i grafen skall ha, kommasepararead lista. Standard är #FF0000,#AADDAA,#FFCC00.<br /> |<br /> | 1.13<br /> |-<br /> | compare<br /> | Anger att order som skickats med p skall läggas in för jämförelse i samma graf. Om fler än tre orter anges måste även color definieras<br /> |<br /> | 1.13<br /> |}<br /> ==Beskrivning av returnerade fält==<br /> {| border=1 class="wikitable"<br /> |-<br /> ! Fält<br /> ! Beskrivning<br /> ! parameter som visar<br /> ! parameter som döljer<br /> ! Visas som standard<br /> ! Introducerad i API-version<br /> |-<br /> | <title><br /> | Mätpunktens namn på temperatur.nu<br /> | <br /> | <br /> | X<br /> | 1.0<br /> |-<br /> | <id><br /> | Mätpunktens id på temperatur.nu. Kan användas med parametern "p" för att hämta endast denna mätpunkts information<br /> |<br /> | simple<br /> | X<br /> | 1.0<br /> |-<br /> | <temp><br /> | Mätpunktens senaste temperatur. Om decimalkomma eller decimalpunkt skall användas styrs med parametern dc.<br /> |<br /> |<br /> | X<br /> | 1.0<br /> |-<br /> | <lat><br /> | Mätpunktens latitud i decimalt format. Om decimalkomma eller decimalpunkt skall användas styrs med parametern dc.<br /> | coordinates, verbose<br /> |<br /> |<br /> | 1.0<br /> |-<br /> | <lon><br /> | Mätpunktens longitud i decimalt format. Om decimalkomma eller decimalpunkt skall användas styrs med parametern dc.<br /> | coordinates, verbose<br /> |<br /> |<br /> | 1.0<br /> |-<br /> | <lastUpdate><br /> | Tidpunkt då informationen senast uppdaterades på temperatur.nu<br /> | verbose<br /> |<br /> |<br /> | 1.0<br /> |-<br /> | <kommun><br /> | Den kommun som mätpunkten ligger i.<br /> | verbose<br /> |<br /> |<br /> | 1.0<br /> |-<br /> | <lan><br /> | Det län som mätpunkten ligger i.<br /> | verbose<br /> |<br /> |<br /> | 1.0<br /> |-<br /> | <sourceInfo><br /> | En kort textsträng med information om vem som loggar temperaturen för mätpunkten<br /> | verbose<br /> |<br /> |<br /> | 1.8<br /> |-<br /> | <url><br /> | Url till mätpunktens temperatur och grafer på www.temperatur.nu<br /> | verbose<br /> |<br /> |<br /> | 1.0<br /> |-<br /> | <dist><br /> | Hur långt från de givna koordinaterna mätpunkten ligger. Enheten är kilometer. Om decimalkomma eller decimalpunkt skall användas styrs med parametern dc.<br /> | lat & lon<br /> | simple<br /> |<br /> | 1.0<br /> |-<br /> | <graph><br /> | Visar url till graph för orten. Observera att ny graf endast genereras när parametern graph används. Det går därför inte att lokalt cacha urlen i klienten. <br /> | graph (x, y, span, verbose_g, shift_g)<br /> |<br /> |<br /> | 1.2<br /> |-<br /> | <ClientVersion><br /> | Visar vilken den senaste släppta klientversionen är. Kan med fördel användas för att kontrollera om det finns någon uppdatering till klientmjukvaran.<br /> | version<br /> |<br /> |<br /> | 1.10<br /> |-<br /> | <ClientVersionSet><br /> | Visar status i samband med att informationen om klientversionen uppdaterats.<br /> | version_update<br /> |<br /> |<br /> | 1.10<br /> |-<br /> | <daily><br /> | Har underliggande fält <date>, <average>, <min>, <max> som representerar data för dygn angivet i fältet date. Dessa fält returneras när parametern daily används för att hämta statisk för flera dygn<br /> | daily, span, start, end, shift_g<br /> |<br /> |<br /> | 1.15<br /> |-<br /> | <ammRange><br /> | Visar för vilket tidsperspektiv amm (medel/min/max) har hämtats<br /> | amm, span, start, end, shift_g<br /> |<br /> |<br /> | 1.11<br /> |-<br /> | <average><br /> | Medeltemperatur i specificerat tidsperspektiv<br /> | amm, span, start, end, shift_g<br /> |<br /> |<br /> | 1.11<br /> |-<br /> | <min><br /> | Den minsta temperaturen i specificerat tidsperspektiv<br /> | amm, span, start, end, shift_g<br /> |<br /> |<br /> | 1.11<br /> |-<br /> | <minTime><br /> | Vid vilken tidpunkt <min> inträffade<br /> | amm, span, start, end, shift_g<br /> |<br /> |<br /> | 1.11<br /> |-<br /> | <max><br /> | Den högsta temperaturen i specificerat tidsperspektiv<br /> | amm, span, start, end, shift_g<br /> |<br /> |<br /> | 1.11<br /> |-<br /> | <maxTime><br /> | Vid vilken tidpunkt <max> inträffade<br /> | amm, span, start, end, shift_g<br /> |<br /> |<br /> | 1.11<br /> <br /> |}<br /> <br /> ==Exempel==<br /> <br /> Så här kan resultatet från en förfrågan på http://api.temperatur.nu/tnu_1.12.php?p=linkoping&verbose&cli=test_app se ut:<br /> <?xml version='1.0' encoding='iso-8859-1'?><br /> <rss version="2.0"><br /> <channel><br /> <title>Temperatur.nu API 1.12 - Din url är inte korrekt signerad, clientnyckeln kan tillfälligt blockeras - /tnu_1.12.php</title><br /> <link>http://wiki.temperatur.nu/index.php/Api</link><br /> <item><br /> <title>Linköping/Centrum</title><br /> <id>linkoping</id><br /> <temp>9.3</temp><br /> <lat>58.414297</lat><br /> <lon>15.628788</lon><br /> <lastUpdate>2011-11-24 08:51:25</lastUpdate><br /> <kommun>Linköping</kommun><br /> <lan>Östergötlands län</lan><br /> <sourceInfo>Temperaturdata från Stångå Hotell.</sourceInfo><br /> <url>http://www.temperatur.nu/linkoping.html</url><br /> </item><br /> </channel><br /> </rss><br /> <br /> <br /> Så här kan resultatet från en förfrågan på http://api.temperatur.nu/tnu_1.12.php?lat=58.376761&lon=15.562916&num=3&graph&cli=test_app2 se ut:<br /> <?xml version='1.0' encoding='iso-8859-1'?><br /> <rss version="2.0"><br /> <channel><br /> <title>Temperatur.nu API 1.12 - Din url är inte korrekt signerad, clientnyckeln kan tillfälligt blockeras - /tnu_1.12.php</title><br /> <link>http://wiki.temperatur.nu/index.php/Api</link><br /> <item><br /> <title>Linköping/Jägarvallen</title><br /> <id>jagarvallen</id><br /> <temp>7.8</temp><br /> <dist>2.5</dist><br /> <graph>http://www2.timg.nu/graph/jagarvallen-1day-300-200-0-0-0-1-8-n.png</graph><br /> </item><br /> <item><br /> <title>Linköping/Malmen (METAR)</title><br /> <id>malmen</id><br /> <temp>8.3</temp><br /> <dist>2.8</dist><br /> <graph>http://www2.timg.nu/graph/malmen-1day-300-200-0-0-0-1-8-n.png</graph><br /> </item><br /> <item><br /> <title>Linköping/Skäggetorp</title><br /> <id>skaggetorp</id><br /> <temp>9.1</temp><br /> <dist>5.2</dist><br /> <graph>http://www2.timg.nu/graph/skaggetorp-1day-300-200-0-0-0-1-8-n.png</graph><br /> </item><br /> </channel><br /> </rss><br /> <br /> <br /> ==Signering av URLer==<br /> Förfrågningar till APIet kan signeras. Från och med version 1.11 är antalet osignerade förfrågningar begränsade till 20 per timma. Osignerade förfrågningar kommer i framtiden att begränsas för alla api-versioner. Skriver du en privat tillämpning kan du använda APIet utan att signera URLerna.<br /> <br /> Signeringen går till så här:<br /> <br /> 1. Skapa din url som vanligt.<br /> <br /> 2. Beräkna md5-/sha1-summan av urlen (utan http://) med "+clientnyckel" tillagd på slutet. Klientnyckel erhålls efter att ha mailat [mailto:support@temperatur.nu support@temperatur.nu]<br /> <br /> 3. I slutet av urlen lägger du sedan till &sign=md5-/sha1-summa<br /> <br /> I php kan det tex se ut så här om du har en signeringsnyckel för md5:<br /> $cli_key="XXXXXXXXXXXXXXXXXXXXXXXXX";<br /> $url="api.temperatur.nu/tnu_1.9.php?p=linkoping&cli=testapp"<br /> $sign=md5($url."+".$cli_key);<br /> $signed_url=$url."&sign=".$sign;<br /> <br /> I den returnerade xml-filen kan du i det första title-fältet se om förfrågan är korrekt signerad.<br /> <br /> [http://www.fileformat.info/tool/hash.htm?text= fileformat.info] är en mycket bra sida för att verifiera att de sha1-/md5-summor du tagit fram stämmer.<br /> <br /> ==Historik/ändringslogg==<br /> 2010-05-04 - Version 1.0<br /> Första releasen.<br /> <br /> 2010-05-13 - Version 1.1<br /> Variabeln cli tillagd.<br /> <br /> 2010-05-19 - Version 1.2<br /> Stöd för att hämta grafer<br /> <br /> 2010-06-09 - Version 1.3<br /> Bugfix som fixar en bugg introducerad i 1.2 (det gick inte att hämta alla orter genom att skippa variabeln p).<br /> <br /> 2010-08-04 - Version 1.4<br /> Värden för x och y justerade. Parametern cli krävs för att apiet skall returnera data.<br /> <br /> 2010-09-01 - Version 1.5<br /> Parametrar för att via mer info i grafen. Parametrar för att visa grafer för i går, förra veckan, 2 år sedan etc.<br /> <br /> 2010-09-01 - Version 1.6<br /> Parameter för att ange om 1 eller 2 y-axlar skall visas.<br /> <br /> 2010-11-22 - Version 1.7<br /> Möjlighet att välja hur tjock graflinjen skall vara.<br /> <br /> 2010-12-19 - Version 1.8<br /> CacheBust-funktion, möjlighet att ändra textstorlek samt information om vem som loggar temperaturen när verbose är specat.<br /> <br /> 2011-01-13 - Version 1.9<br /> Signeringsfunktion inlagd. Signeringsfunktionen kommer från mitten av 2011 krävas för alla tillämpningar och och kommer successivt att läggas in i alla versioner av apiet.<br /> <br /> 2011-01-17 - Version 1.10<br /> Möjlighet att via Apiet hantera informaion gällande den senaste tillgängliga klientversionen.<br /> <br /> 2011-01-30 - Version 1.11<br /> Mer flexibel specificering av tidsperspektiv för grafer. amm - möjlighet att hämta medel/min/max i ett valfritt tidsperspektiv, antalet osignerade accesser begränsat i denna version.<br /> <br /> 2011-10-08 - Version 1.12<br /> Variabeln history tillagd. Visar föregående periods temperatur i grafer.<br /> <br /> 2012-05-04 - Version 1.13<br /> Variablerna compare och color angivna, gör det möjligt att jämföra flera orter i samma graf samt helt styra vilka färger linjerna i graferna skall ha. color kan sättas även för vanliga grafer.<br /> <br /> 2013 - Version 1.14<br /> Parametern history_year som används för att jämföra data med tidigare år. Buggfixar<br /> <br /> 2014-01-26 - Version 1.15<br /> Parametern daily. Används för att hämta dygnsmedel i ett specificerat tidsspann.<br /> <br /> [[Kategori:www.temperatur.nu]]<br /> [[Kategori:Mjukvara]]</div>

Elf98 https://wiki.temperatur.nu/index.php?title=Rapportera_till_temperatur.nu&diff=752 Rapportera till temperatur.nu 2019-02-27T14:30:59Z

<p>Elf98: /* Förslag på hårdvara */</p> <hr /> <div>[[Information om www.temperatur.nu|Temperatur.nu]] bygger helt och hållet på att frivilliga ger temperatur.nu tillgång till aktuell temperatur. <br /> <br /> == Krav ==<br /> För att det skall vara intressant att lägga till <br /> just din temperatur måste ett par krav vara uppfyllda:<br /> * Temperatur.nu '''skall''' få tillgång till temperaturen dygnet runt. Temperaturen du rapporterar '''skall''' vara skuggtemperaturen. Det är lämpligt att mäta och rapportera temperaturen från två väderstreck så minskar risken för problem med solinstrålning.<br /> * Temperaturen bör ha en upplösning på 0,1 grader.<br /> * Temperaturen bör uppdateras var femte minut eller oftare.<br /> <br /> == Alternativ för rapportering ==<br /> '''''Färdiga lösningar:'''''<br /> * [https://www.m.nu/temperaturnu-reporter-rapportera-till-temperaturnu-p-1219.html Dedikerad utrustning för att rapportera temperaturen till temperatur.nu]. Anslut kablarna så är du i gång.<br /> * [https://www.m.nu/losa-sensorer/thgr122nx-tradlos-sensor-temperatur-luftfuktighet-med-display Trådlösa sensorer] anslutna till [http://live.telldus.com Telldus Live] via [https://www.m.nu/tellstick-rfxtrx/telldus-tellstick-net-v2 Tellstick Net]. <br /> <br /> '''''Lösningar för dig som mäter på annat sätt'''''<br /> * En textfil som är åtkomligt någonstans på nätet via http. Filen skall innehålla enbart den senaste uppmätta temperaturen. ex: '''''12.23'''''<br /> * En fil av typen html/csv/txt/xml (eller liknande) som är tillgänglig via http. Filen får inte vara en loggfil som växer i storlek över tid. Filens struktur bör vara statisk. ex: '''''Time: 20:29, Date: 16 May 2007, Temp: 12.23°C''''' eller tex: http://hem.bredband.net/b518377/index.htm<br /> * Använd en rapporteringsurl: ex: http://www.temperatur.nu/rapportera.php?hash=1130a550a5e619d962e0f3da4755d4e4&t=12.2. Hashkoden får du när du registrerar ditt intresse.<br /> <br /> 12,23 går lika bra att använda som 12.23.<br /> <br /> Det är rekommenderat att mäta temperaturen i två väderstreck. Båda dessa temperaturer bör göras tillgängliga för temperatur.nu så kan temperatur.nu analysera dessa temperaturer kontinuerligt för att minska risken för att mätvärdet påverkas av solinstrålning.<br /> <br /> == Anmäl intresse ==<br /> [http://www.temperatur.nu/nystation/ Här anmäler du ditt intresse att rapportera temepraturer till temperatur.nu]<br /> <br /> Viktiga punkter och varför vi efterfrågar viss information:<br /> <br /> # Epostadress. Används för att skicka information runt din mätpunkt vid driftstörningar. <br /> # Förslag på ett namn till mätstationen. Titta på de befintliga stationerna i närheten så namnet blir konsekvent.<br /> # Rapporteringssätt. Två sensorer bör användas. I nuläget måste båda sensorerna som anmäls/aktiveras vara i drift, faller en bort kommer rapporteringarna inte att fungera.<br /> # Gatuadressen används för att ta fram koordinaterna för mätplatsen. Koordinaterna används för att positionera tempreaturen på kartor.<br /> # I vilken kommun mätningarna sker. Används för att hämta rätt väderprognos.<br /> # Med vilka förutsättningar temperaturen mäts. Ex vilken utrustning, var sensorerna är placerade, programvara. Informationen visas i anslutning till graferna på temperatur.nu. Informationen ger besökaren värdefull information för att kunna lita på temperaturen som rapporteras<br /> <br /> <br /> Registrerar du dig på forumet kan du redigera och lägga till följande information:<br /> <br /> # Länk till din väderstation/hemsida<br /> # Justera koordinaterna<br /> # Lägga till mobilnummer dit SMS skickas när temperatur.nu inte kan läsa in din temperatur<br /> # Koppla ditt Telldus Live-konto till temperatur.nu (Enda sättet att ge temperatur.nu tillgång till temperaturer från Telldus Live.<br /> <br /> Då det krävs mycket jobb för att lägga in gammal data är det i nuläget inte intressant att lägga in historisk data.<br /> <br /> == Villkor ==<br /> * Temperatur.nu får fritt använda temperaturerna.<br /> * Det kostar inte något att delta på temperatur.nu.<br /> * Det utgår inte någon ersättning för att delta på temperatur.nu.<br /> * Där så är möjligt kommer det att stå vem som rapporterar temperaturen, men det är inte praktiskt möjligt att skriva det överallt.<br /> * Temperaturen och grafer kan komma att visas på andra sidor på internet.<br /> * Temperaturen och grafer kan komma att visas i olika program och tillämpningar på en mängd olika plattformar. (Tex Windows, OS X, Android, iOS, Linux mfl)<br /> * Målsättningen är att allt skall vara gratis för alla. När företag vill använda funktioner på temperatur.nu kan dock en avgift debiteras.<br /> * Specifika tillämpningar som kostar temperatur.nu pengar att driftsätta och hålla igång kan komma att kosta en liten summa pengar, tex applikationer till mobiltelefoner.<br /> <br /> == Förslag på hårdvara ==<br /> * '''Enklast möjliga lösningen''' [https://www.m.nu/paket-temperatur-rh/temperaturnu-reporter-rapportera-till-temperaturnu Temperatur.nu Reporter V2]<br /> * '''Trådlöst:''' [https://www.m.nu/sensorer-433mhz/temperatur-och-luftfuktighetssensor-med-display-tellstick-och-rfxtrx433e-kompatibel-2 Trådlösa sensorer] anslutna till [http://live.telldus.com Telldus Live] via [https://www.m.nu/tellstick-rfxtrx/telldus-tellstick-net-v2 Tellstick Net]. <br /> * Det finns mägder med fler lösningar, huvudsaken är att mätningarna sker dygnet runt och kan presenteras i någon form på internet. Har du frågor om vad som krävs, ställ dina frågor i [http://www.temperatur.nu/forum Forumet]<br /> <br /> [[Kategori:www.temperatur.nu]]</div>

Elf98 https://wiki.temperatur.nu/index.php?title=Huvudsida&diff=749 Huvudsida 2016-09-17T15:21:42Z

<p>Elf98: </p> <hr /> <div>[[Fil:m_nu_logo.png|160px|länk=http://www.m.nu|m.nu logo]] [[Fil:temperatur_nu_logo.png|150px|länk=http://www.temperatur.nu|temperatur.nu logo]]<br /> <br /> __NOTOC__<br /> <span style="font-size:150%">Välkommen till wiki.temperatur.nu!</span><br /> Detta är den helt nya informationskanalen där information gällande temperatur.nu/m.nu kommer att samlas.<br /> <br /> Då det är ett Wiki-system kan vem som helst skapa ett konto och lägga upp nya sidor eller korrigera felaktig information på befintliga sidor.<br /> <br /> {{Multicol}}<br /> <br /> == Kategori:www.temperatur.nu ==<br /> [[Fil:temperatur_nu_logo.png|150px|länk=http://www.temperatur.nu|temperatur.nu logo]]<br /> <categorytree mode=pages>www.temperatur.nu</categorytree><br /> <br /> == Kategori:Hårdvara ==<br /> [[:Kategori:Hårdvara]]<br /> <categorytree mode=pages>Hårdvara</categorytree><br /> <br /> <br /> {{Multicol-break}}<br /> <br /> == Kategori:Mjukvara ==<br /> <categorytree mode=pages>Mjukvara</categorytree><br /> <br /> == Att komma igång ==<br /> Vi kanske ska låta dessa länkar stå kvar ett tag, de är mycket användbara!<br /> <br /> * [http://meta.wikimedia.org/wiki/Help:Contents Användarmanualen]<br /> * [http://www.mediawiki.org/wiki/Manual:Configuration_settings Lista över konfigurationsinställningar]<br /> * [http://www.mediawiki.org/wiki/Manual:FAQ MediaWiki FAQ]<br /> * [https://lists.wikimedia.org/mailman/listinfo/mediawiki-announce MediaWiki release mail list]<br /> <br /> En exempelsida med mängder med olika formateringar:<br /> [http://sv.wikipedia.org/wiki/Svenska Wikipedia:Svenska]<br /> <br /> Lite genvägar för att snabbt kunna skapa kategoriserade sidor.<br /> [http://meta.wikimedia.org/wiki/Help:Category Information om Kategorier]<br /> {{Multicol-end}}</div>

Elf98 https://wiki.temperatur.nu/index.php?title=Fil:M_nu_logo.png&diff=748 Fil:M nu logo.png 2016-09-17T15:21:16Z

<p>Elf98: Elf98 laddade upp ny version av &quot;Fil:M nu logo.png&quot;</p> <hr /> <div>m.nu Logotype</div>

Elf98 https://wiki.temperatur.nu/index.php?title=Huvudsida&diff=745 Huvudsida 2014-09-26T18:22:53Z

<p>Elf98: /* Kategori:www.m.nu */</p> <hr /> <div>[[Fil:m_nu_logo.png|150px|länk=http://www.m.nu|m.nu logo]] [[Fil:temperatur_nu_logo.png|150px|länk=http://www.temperatur.nu|temperatur.nu logo]]<br /> <br /> __NOTOC__<br /> <span style="font-size:150%">Välkommen till wiki.temperatur.nu!</span><br /> Detta är den helt nya informationskanalen där information gällande temperatur.nu/m.nu kommer att samlas.<br /> <br /> Då det är ett Wiki-system kan vem som helst skapa ett konto och lägga upp nya sidor eller korrigera felaktig information på befintliga sidor.<br /> <br /> {{Multicol}}<br /> <br /> == Kategori:www.temperatur.nu ==<br /> [[Fil:temperatur_nu_logo.png|150px|länk=http://www.temperatur.nu|temperatur.nu logo]]<br /> <categorytree mode=pages>www.temperatur.nu</categorytree><br /> <br /> == Kategori:Hårdvara ==<br /> [[:Kategori:Hårdvara]]<br /> <categorytree mode=pages>Hårdvara</categorytree><br /> <br /> <br /> {{Multicol-break}}<br /> <br /> == Kategori:Mjukvara ==<br /> <categorytree mode=pages>Mjukvara</categorytree><br /> <br /> == Att komma igång ==<br /> Vi kanske ska låta dessa länkar stå kvar ett tag, de är mycket användbara!<br /> <br /> * [http://meta.wikimedia.org/wiki/Help:Contents Användarmanualen]<br /> * [http://www.mediawiki.org/wiki/Manual:Configuration_settings Lista över konfigurationsinställningar]<br /> * [http://www.mediawiki.org/wiki/Manual:FAQ MediaWiki FAQ]<br /> * [https://lists.wikimedia.org/mailman/listinfo/mediawiki-announce MediaWiki release mail list]<br /> <br /> En exempelsida med mängder med olika formateringar:<br /> [http://sv.wikipedia.org/wiki/Svenska Wikipedia:Svenska]<br /> <br /> Lite genvägar för att snabbt kunna skapa kategoriserade sidor.<br /> [http://meta.wikimedia.org/wiki/Help:Category Information om Kategorier]<br /> {{Multicol-end}}</div>

Elf98 https://wiki.temperatur.nu/index.php?title=Huvudsida&diff=744 Huvudsida 2014-09-26T18:22:18Z

<p>Elf98: /* Kategori:1-Wire */</p> <hr /> <div>[[Fil:m_nu_logo.png|150px|länk=http://www.m.nu|m.nu logo]] [[Fil:temperatur_nu_logo.png|150px|länk=http://www.temperatur.nu|temperatur.nu logo]]<br /> <br /> __NOTOC__<br /> <span style="font-size:150%">Välkommen till wiki.temperatur.nu!</span><br /> Detta är den helt nya informationskanalen där information gällande temperatur.nu/m.nu kommer att samlas.<br /> <br /> Då det är ett Wiki-system kan vem som helst skapa ett konto och lägga upp nya sidor eller korrigera felaktig information på befintliga sidor.<br /> <br /> {{Multicol}}<br /> <br /> == Kategori:www.temperatur.nu ==<br /> [[Fil:temperatur_nu_logo.png|150px|länk=http://www.temperatur.nu|temperatur.nu logo]]<br /> <categorytree mode=pages>www.temperatur.nu</categorytree><br /> <br /> == Kategori:www.m.nu ==<br /> [[Fil:m_nu_logo.png|150px|länk=http://www.m.nu|m.nu logo]]<br /> <categorytree mode=pages>www.m.nu</categorytree><br /> <br /> == Kategori:Hårdvara ==<br /> [[:Kategori:Hårdvara]]<br /> <categorytree mode=pages>Hårdvara</categorytree><br /> <br /> <br /> {{Multicol-break}}<br /> <br /> == Kategori:Mjukvara ==<br /> <categorytree mode=pages>Mjukvara</categorytree><br /> <br /> == Att komma igång ==<br /> Vi kanske ska låta dessa länkar stå kvar ett tag, de är mycket användbara!<br /> <br /> * [http://meta.wikimedia.org/wiki/Help:Contents Användarmanualen]<br /> * [http://www.mediawiki.org/wiki/Manual:Configuration_settings Lista över konfigurationsinställningar]<br /> * [http://www.mediawiki.org/wiki/Manual:FAQ MediaWiki FAQ]<br /> * [https://lists.wikimedia.org/mailman/listinfo/mediawiki-announce MediaWiki release mail list]<br /> <br /> En exempelsida med mängder med olika formateringar:<br /> [http://sv.wikipedia.org/wiki/Svenska Wikipedia:Svenska]<br /> <br /> Lite genvägar för att snabbt kunna skapa kategoriserade sidor.<br /> [http://meta.wikimedia.org/wiki/Help:Category Information om Kategorier]<br /> {{Multicol-end}}</div>

Elf98 https://wiki.temperatur.nu/index.php?title=Huvudsida&diff=743 Huvudsida 2014-09-26T18:21:48Z

<p>Elf98: /* Kategori:Hårdvara */</p> <hr /> <div>[[Fil:m_nu_logo.png|150px|länk=http://www.m.nu|m.nu logo]] [[Fil:temperatur_nu_logo.png|150px|länk=http://www.temperatur.nu|temperatur.nu logo]]<br /> <br /> __NOTOC__<br /> <span style="font-size:150%">Välkommen till wiki.temperatur.nu!</span><br /> Detta är den helt nya informationskanalen där information gällande temperatur.nu/m.nu kommer att samlas.<br /> <br /> Då det är ett Wiki-system kan vem som helst skapa ett konto och lägga upp nya sidor eller korrigera felaktig information på befintliga sidor.<br /> <br /> {{Multicol}}<br /> <br /> == Kategori:www.temperatur.nu ==<br /> [[Fil:temperatur_nu_logo.png|150px|länk=http://www.temperatur.nu|temperatur.nu logo]]<br /> <categorytree mode=pages>www.temperatur.nu</categorytree><br /> <br /> == Kategori:www.m.nu ==<br /> [[Fil:m_nu_logo.png|150px|länk=http://www.m.nu|m.nu logo]]<br /> <categorytree mode=pages>www.m.nu</categorytree><br /> <br /> == Kategori:Hårdvara ==<br /> [[:Kategori:Hårdvara]]<br /> <categorytree mode=pages>Hårdvara</categorytree><br /> <br /> <br /> {{Multicol-break}}<br /> <br /> == Kategori:Mjukvara ==<br /> <categorytree mode=pages>Mjukvara</categorytree><br /> <br /> == Kategori:1-Wire ==<br /> <categorytree mode=pages>1-Wire</categorytree><br /> <br /> == Att komma igång ==<br /> Vi kanske ska låta dessa länkar stå kvar ett tag, de är mycket användbara!<br /> <br /> * [http://meta.wikimedia.org/wiki/Help:Contents Användarmanualen]<br /> * [http://www.mediawiki.org/wiki/Manual:Configuration_settings Lista över konfigurationsinställningar]<br /> * [http://www.mediawiki.org/wiki/Manual:FAQ MediaWiki FAQ]<br /> * [https://lists.wikimedia.org/mailman/listinfo/mediawiki-announce MediaWiki release mail list]<br /> <br /> En exempelsida med mängder med olika formateringar:<br /> [http://sv.wikipedia.org/wiki/Svenska Wikipedia:Svenska]<br /> <br /> Lite genvägar för att snabbt kunna skapa kategoriserade sidor.<br /> [http://meta.wikimedia.org/wiki/Help:Category Information om Kategorier]<br /> {{Multicol-end}}</div>

Elf98 https://wiki.temperatur.nu/index.php?title=Huvudsida&diff=742 Huvudsida 2014-09-26T18:21:29Z

<p>Elf98: /* Kategori:HowTo */</p> <hr /> <div>[[Fil:m_nu_logo.png|150px|länk=http://www.m.nu|m.nu logo]] [[Fil:temperatur_nu_logo.png|150px|länk=http://www.temperatur.nu|temperatur.nu logo]]<br /> <br /> __NOTOC__<br /> <span style="font-size:150%">Välkommen till wiki.temperatur.nu!</span><br /> Detta är den helt nya informationskanalen där information gällande temperatur.nu/m.nu kommer att samlas.<br /> <br /> Då det är ett Wiki-system kan vem som helst skapa ett konto och lägga upp nya sidor eller korrigera felaktig information på befintliga sidor.<br /> <br /> {{Multicol}}<br /> <br /> == Kategori:www.temperatur.nu ==<br /> [[Fil:temperatur_nu_logo.png|150px|länk=http://www.temperatur.nu|temperatur.nu logo]]<br /> <categorytree mode=pages>www.temperatur.nu</categorytree><br /> <br /> == Kategori:www.m.nu ==<br /> [[Fil:m_nu_logo.png|150px|länk=http://www.m.nu|m.nu logo]]<br /> <categorytree mode=pages>www.m.nu</categorytree><br /> <br /> == Kategori:Hårdvara ==<br /> [[:Kategori:Hårdvara]]<br /> <categorytree mode=pages>Hårdvara</categorytree><br /> <br /> == Kategori:Mjukvara ==<br /> <categorytree mode=pages>Mjukvara</categorytree><br /> <br /> == Kategori:1-Wire ==<br /> <categorytree mode=pages>1-Wire</categorytree><br /> <br /> == Att komma igång ==<br /> Vi kanske ska låta dessa länkar stå kvar ett tag, de är mycket användbara!<br /> <br /> * [http://meta.wikimedia.org/wiki/Help:Contents Användarmanualen]<br /> * [http://www.mediawiki.org/wiki/Manual:Configuration_settings Lista över konfigurationsinställningar]<br /> * [http://www.mediawiki.org/wiki/Manual:FAQ MediaWiki FAQ]<br /> * [https://lists.wikimedia.org/mailman/listinfo/mediawiki-announce MediaWiki release mail list]<br /> <br /> En exempelsida med mängder med olika formateringar:<br /> [http://sv.wikipedia.org/wiki/Svenska Wikipedia:Svenska]<br /> <br /> Lite genvägar för att snabbt kunna skapa kategoriserade sidor.<br /> [http://meta.wikimedia.org/wiki/Help:Category Information om Kategorier]<br /> {{Multicol-end}}</div>

Elf98 https://wiki.temperatur.nu/index.php?title=OWFS_with_i2c_support_on_Raspberry_Pi_(English_version)&diff=741 OWFS with i2c support on Raspberry Pi (English version) 2014-09-26T18:21:10Z

<p>Elf98: Ersätter sidans innehåll med 'This guide has moved to http://wiki.m.nu/index.php/OWFS_with_i2c_support_on_Raspberry_Pi_(English_version)'</p> <hr /> <div>This guide has moved to http://wiki.m.nu/index.php/OWFS_with_i2c_support_on_Raspberry_Pi_(English_version)</div>

Elf98 https://wiki.temperatur.nu/index.php?title=OWFS_p%C3%A5_Rasperry_Pi&diff=740 OWFS på Rasperry Pi 2014-09-26T18:19:56Z

<p>Elf98: Ersätter sidans innehåll med 'Denna guide har flyttat till http://wiki.m.nu/index.php/OWFS_p%C3%A5_Rasperry_Pi'</p> <hr /> <div>Denna guide har flyttat till http://wiki.m.nu/index.php/OWFS_p%C3%A5_Rasperry_Pi</div>

Elf98 https://wiki.temperatur.nu/index.php?title=OWFS_p%C3%A5_DNS-320/325&diff=739 OWFS på DNS-320/325 2014-09-26T18:18:38Z

<p>Elf98: Ersätter sidans innehåll med 'Denna guide har flyttat till http://wiki.m.nu/index.php/OWFS_p%C3%A5_DNS-320/325'</p> <hr /> <div>Denna guide har flyttat till http://wiki.m.nu/index.php/OWFS_p%C3%A5_DNS-320/325</div>

Elf98 https://wiki.temperatur.nu/index.php?title=M%C3%A4ta_elf%C3%B6rbrukning_med_rrdtool&diff=738 Mäta elförbrukning med rrdtool 2014-09-26T18:17:12Z

<p>Elf98: Ersätter sidans innehåll med 'Denna guide har flyttat till [http://wiki.m.nu/index.php/M%C3%A4ta_elf%C3%B6rbrukning_med_OWFS_och_RRDTool http://wiki.m.nu/index.php/M%C3%A4ta_elf%C3%B6rbrukning...'</p> <hr /> <div>Denna guide har flyttat till [http://wiki.m.nu/index.php/M%C3%A4ta_elf%C3%B6rbrukning_med_OWFS_och_RRDTool http://wiki.m.nu/index.php/M%C3%A4ta_elf%C3%B6rbrukning_med_OWFS_och_RRDTool]</div>

Elf98 https://wiki.temperatur.nu/index.php?title=RRA&diff=736 RRA 2014-09-26T17:54:05Z

<p>Elf98: </p> <hr /> <div>Denna sida har flyttat till [http://wiki.m.nu/index.php/RRDtool_RRA_-_HowTo http://wiki.m.nu/index.php/RRDtool_RRA_-_HowTo]</div>

Elf98 https://wiki.temperatur.nu/index.php?title=RRDtool_HowTo&diff=735 RRDtool HowTo 2014-09-26T17:49:56Z

<p>Elf98: Ersätter sidans innehåll med 'Denna sida har flyttat till [http://wiki.m.nu/index.php/RRDTool_Howto http://wiki.m.nu/index.php/RRDTool_Howto]'</p> <hr /> <div>Denna sida har flyttat till [http://wiki.m.nu/index.php/RRDTool_Howto http://wiki.m.nu/index.php/RRDTool_Howto]</div>

Elf98 https://wiki.temperatur.nu/index.php?title=OWFS_HowTo&diff=734 OWFS HowTo 2014-09-26T17:45:01Z

<p>Elf98: </p> <hr /> <div>[http://wiki.m.nu/index.php/OWFS_HowTo Denna guide har flyttat till http://wiki.m.nu/index.php/OWFS_HowTo]</div>

Elf98 https://wiki.temperatur.nu/index.php?title=Rapportera_till_temperatur.nu&diff=733 Rapportera till temperatur.nu 2014-09-26T17:37:38Z

<p>Elf98: </p> <hr /> <div>[[Information om www.temperatur.nu|Temperatur.nu]] bygger helt och hållet på att frivilliga ger temperatur.nu tillgång till aktuell temperatur. <br /> <br /> == Krav ==<br /> För att det skall vara intressant att lägga till <br /> just din temperatur måste ett par krav vara uppfyllda:<br /> * Temperatur.nu '''skall''' få tillgång till temperaturen dygnet runt. Temperaturen du rapporterar '''skall''' vara skuggtemperaturen. Det är lämpligt att mäta och rapportera temperaturen från två väderstreck så minskar risken för problem med solinstrålning.<br /> * Temperaturen bör ha en upplösning på 0,1 grader.<br /> * Temperaturen bör uppdateras var femte minut eller oftare.<br /> <br /> == Alternativ för rapportering ==<br /> '''''Färdiga lösningar:'''''<br /> * [https://www.m.nu/temperaturnu-reporter-rapportera-till-temperaturnu-p-1219.html Dedikerad utrustning för att rapportera temperaturen till temperatur.nu]. Anslut kablarna så är du i gång.<br /> * [https://www.m.nu/thgn228n-tradlos-sensor-temperaturluftfuktighet-p-515.html Trådlösa sensorer] anslutna till [http://live.telldus.com Telldus Live] via [https://www.m.nu/tellstick-duo-p-465.html Tellstick Net]. <br /> <br /> '''''Lösningar för dig som mäter på annat sätt'''''<br /> * En textfil som är åtkomligt någonstans på nätet via http. Filen skall innehålla enbart den senaste uppmätta temperaturen. ex: '''''12.23'''''<br /> * En fil av typen html/csv/txt/xml (eller liknande) som är tillgänglig via http. Filen får inte vara en loggfil som växer i storlek över tid. Filens struktur bör vara statisk. ex: '''''Time: 20:29, Date: 16 May 2007, Temp: 12.23°C''''' eller tex: http://hem.bredband.net/b518377/index.htm<br /> * Använd en rapporteringsurl: ex: http://www.temperatur.nu/rapportera.php?hash=1130a550a5e619d962e0f3da4755d4e4&t=12.2. Hashkoden får du när du registrerar ditt intresse.<br /> <br /> 12,23 går lika bra att använda som 12.23.<br /> <br /> Det är rekommenderat att mäta temperaturen i två väderstreck. Båda dessa temperaturer bör göras tillgängliga för temperatur.nu så kan temperatur.nu analysera dessa temperaturer kontinuerligt för att minska risken för att mätvärdet påverkas av solinstrålning.<br /> <br /> == Anmäl intresse ==<br /> [http://www.temperatur.nu/nystation/ Här anmäler du ditt intresse att rapportera temepraturer till temperatur.nu]<br /> <br /> Viktiga punkter och varför vi efterfrågar viss information:<br /> <br /> # Epostadress. Används för att skicka information runt din mätpunkt vid driftstörningar. <br /> # Förslag på ett namn till mätstationen. Titta på de befintliga stationerna i närheten så namnet blir konsekvent.<br /> # Rapporteringssätt. Två sensorer bör användas. I nuläget måste båda sensorerna som anmäls/aktiveras vara i drift, faller en bort kommer rapporteringarna inte att fungera.<br /> # Gatuadressen används för att ta fram koordinaterna för mätplatsen. Koordinaterna används för att positionera tempreaturen på kartor.<br /> # I vilken kommun mätningarna sker. Används för att hämta rätt väderprognos.<br /> # Med vilka förutsättningar temperaturen mäts. Ex vilken utrustning, var sensorerna är placerade, programvara. Informationen visas i anslutning till graferna på temperatur.nu. Informationen ger besökaren värdefull information för att kunna lita på temperaturen som rapporteras<br /> <br /> <br /> Registrerar du dig på forumet kan du redigera och lägga till följande information:<br /> <br /> # Länk till din väderstation/hemsida<br /> # Justera koordinaterna<br /> # Lägga till mobilnummer dit SMS skickas när temperatur.nu inte kan läsa in din temperatur<br /> # Koppla ditt Telldus Live-konto till temperatur.nu (Enda sättet att ge temperatur.nu tillgång till temperaturer från Telldus Live.<br /> <br /> Då det krävs mycket jobb för att lägga in gammal data är det i nuläget inte intressant att lägga in historisk data.<br /> <br /> == Villkor ==<br /> * Temperatur.nu får fritt använda temperaturerna.<br /> * Det kostar inte något att delta på temperatur.nu.<br /> * Det utgår inte någon ersättning för att delta på temperatur.nu.<br /> * Där så är möjligt kommer det att stå vem som rapporterar temperaturen, men det är inte praktiskt möjligt att skriva det överallt.<br /> * Temperaturen och grafer kan komma att visas på andra sidor på internet.<br /> * Temperaturen och grafer kan komma att visas i olika program och tillämpningar på en mängd olika plattformar. (Tex Windows, OS X, Android, iOS, Linux mfl)<br /> * Målsättningen är att allt skall vara gratis för alla. När företag vill använda funktioner på temperatur.nu kan dock en avgift debiteras.<br /> * Specifika tillämpningar som kostar temperatur.nu pengar att driftsätta och hålla igång kan komma att kosta en liten summa pengar, tex applikationer till mobiltelefoner.<br /> <br /> == Förslag på hårdvara ==<br /> * '''Billigt och enkelt:''' [https://www.m.nu/1-sensor-temperaturluftfuktighetsnat-p-30.html Temperaturnät med en sensor]<br /> ** Med USB eller serielladapter måste datorn stå på dygnet runt. <br /> * '''Enklast möjliga lösningen, ingen dator behöver stå på:''' [https://www.m.nu/utrustning-for-att-rapportera-till-temperaturnu-p-533.html Dedikerad utrustning för att rapportera till temperatur.nu]<br /> * '''Trådlöst:''' [https://www.m.nu/thgn228n-tradlos-sensor-temperaturluftfuktighet-p-515.html Trådlösa sensorer] anslutna till [http://live.telldus.com Telldus Live] via [https://www.m.nu/tellstick-duo-p-465.html Tellstick Net]. <br /> * '''Lite dyrare och exklusivare:''' [https://www.m.nu/wmr200-vaderstation-med-tradlosa-sensorer-pckoppling-solceller-stort-minne-p-377.html Väderstation Oregon WMR200].<br /> * Det finns mägder med fler lösningar, huvudsaken är att mätningarna sker dygnet runt och kan presenteras i någon form på internet. Har du frågor om vad som krävs, ställ dina frågor i [http://www.temperatur.nu/forum Forumet]<br /> <br /> [[Kategori:www.temperatur.nu]]</div>

Elf98 https://wiki.temperatur.nu/index.php?title=Temperatur.nu_Reporter&diff=731 Temperatur.nu Reporter 2014-09-26T17:19:46Z

<p>Elf98: </p> <hr /> <div>Information om Temperatur.nu Reporter.<br /> <br /> [[Fil:T reporter1.jpg|höger|200px]]<br /> == Var kan du köpa den? ==<br /> [https://www.m.nu/temperaturnu-reporter-rapportera-till-temperaturnu-p-1219.html Temperatur.nu Reporter på m.nu]<br /> <br /> == Generellt ==<br /> * Färgen på Reporterns statusdiod updateras endast i samband med att ett anslutningsförsök till temperatur.nu görs var tredje minut.<br /> * Reportern konsumerar ca 10Mb data per månad.<br /> <br /> == Blinkguide FW 2.1 ==<br /> <br /> Normal drift:<br /> * Blinkar blått 1 gång per sekund: Startar upp eller om (initierar nätverkskortet och hämtar IP via DHCP).<br /> * Blinkar grönt 1 gång per sekund: 2st temperatur har lästs in och boxen har kontakt med temperatur.nu<br /> * Blinkar lila 1 gång per sekund: 1st temperatur har lästs in och boxen har kontakt med temperatur.nu<br /> <br /> Felkoder:<br /> * Blinkar vitt 1 gång per sekund: inga temperatursensorer kan hittas, Reportern har kontakt med temperatur.nu<br /> * Blinkar rött en gång per sekund: Boxen har anslutit till nätverket (erhållit ipnummer), men får inte kontakt med temperatur.nu. Reportern startar om automatiskt efter en stund när ingen kontakt med temperatur.nu kan etableras.<br /> <br /> == Blinkguide FW 2.0 ==<br /> <br /> Version FW 2.0 är återkallad pga en stor bugg i mjukvaran. Har du en reporter med FW2.0, skicka ett mail till support@temperatur.nu så byter vi ut den!<br /> <br /> == Blinkguide FW 1.0/1.0.1 ==<br /> <br /> * Blinkar grönt 1 gång per sekund: 2st temperaturer har lästs in och boxen har kontakt med temperatur.nu<br /> * Blinkar lila 1 gång per sekund: 1st temperatur har lästs in och boxen har kontakt med temperatur.nu<br /> * Blinkar vitt 1 gång per sekund: inga temperatursensorer kan hittas, boxen har kontakt med temperatur.nu<br /> * Lyser blått i 1 till 3 sekunder: Boxen Läser in temperaturer och försöker skicka upp data till temperatur.nu<br /> * Blinkar rött en gång per sekund: Boxen har anslutit till nätverket (erhållit ipnummer) och kan läsa in temperaturer, men får inte kontakt med temperatur.nu.<br /> <br /> * Fast lila sken: Försöker hämta IP-adress via DHCP<br /> * Blinkar lila i snabb takt: DHCP misslyckades och boxen startar om för att försöka igen.<br /> <br /> * Fast rött sken: Försöker göra namnuppslagning för www.temperatur.nu.<br /> * Blinkar rött i snabb (10ggr/sekund) takt: Kan inte hitta temperatur.nu vid uppstart och boxen startar om för att försöka igen.<br /> * Blinkar rött i snabb (5ggr/sekund) takt: Kan inte få kontakt med temperatur.nu efter att boxen initierats korrekt. Boxen startar om för att försöka igen.<br /> <br /> == Hårdvaran ==<br /> Temperatur.nu Reporter är uppbyggd kring en Atmega328. Nätverksmodulen är baserad på ENC28J60. <br /> <br /> == Mjukvaran ==<br /> Användaren kan inte göra några egna inställningar i boxen och allt är "plug and play". Det går inte heller att komma åt inlästa temperaturer lokalt.<br /> <br /> <br /> [[Kategori:www.temperatur.nu]]</div>

Elf98 https://wiki.temperatur.nu/index.php?title=Inkoppling_1wire-r%C3%A4knare&diff=730 Inkoppling 1wire-räknare 2014-09-26T17:18:47Z

<p>Elf98: </p> <hr /> <div>[http://wiki.m.nu/index.php/Inkoppling_1wire-r%C3%A4knare Denna sida har flyttat till http://wiki.m.nu/index.php/Inkoppling_1wire-r%C3%A4knare]</div>

Elf98 https://wiki.temperatur.nu/index.php?title=Skriva_till_enheter_p%C3%A5_OW-SERVER&diff=729 Skriva till enheter på OW-SERVER 2014-09-26T17:17:51Z

<p>Elf98: </p> <hr /> <div>Informationen från denna sida har flyttats till [http://blog.m.nu/konfigurera-1wire-enheter-pa-ow-server-enetwifi-genom-att-accessa-urler/ http://blog.m.nu/konfigurera-1wire-enheter-pa-ow-server-enetwifi-genom-att-accessa-urler/]</div>

Elf98 https://wiki.temperatur.nu/index.php?title=Kalibrering_av_barometer&diff=727 Kalibrering av barometer 2014-09-26T16:43:56Z

<p>Elf98: Ersätter sidans innehåll med 'Denna sida har flyttat till [http://wiki.m.nu/index.php/Kalibrering_av_barometer_(version_2) http://wiki.m.nu/index.php/Kalibrering_av_barometer_(version_2)]'</p> <hr /> <div>Denna sida har flyttat till [http://wiki.m.nu/index.php/Kalibrering_av_barometer_(version_2) http://wiki.m.nu/index.php/Kalibrering_av_barometer_(version_2)]</div>

Elf98 https://wiki.temperatur.nu/index.php?title=Inkoppling_1wire-r%C3%A4knare&diff=723 Inkoppling 1wire-räknare 2014-09-06T17:41:30Z

<p>Elf98: </p> <hr /> <div>[http://wiki.m.nu/index.php/Inkoppling_1wire-r%C3%A4knare Denna sida har flyttat till http://wiki.m.nu/index.php/Inkoppling_1wire-r%C3%A4knare]<br /> [[Kategori:Hårdvara]]<br /> [[Kategori:www.m.nu]]</div>

Elf98