API
Från Temperatur.nu
Version från den 4 maj 2010 kl. 08.33 av Elf98 (diskussion | bidrag) (Skapade sidan med 'Det finns ett enkelt API för att hämta senaste temperaturerna från temperatur.nu. Aktuell API-version 1.0. Data returneras i XML-format ==Kort beskrivning== APIet är tänk…')
The printable version is no longer supported and may have rendering errors. Please update your browser bookmarks and please use the default browser print function instead.
Det finns ett enkelt API för att hämta senaste temperaturerna från temperatur.nu.
Aktuell API-version 1.0.
Data returneras i XML-format
Kort beskrivning
APIet är tänkt att användas av de som skapar extern mjukvara, tex applikationer för Iphone och Android. 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!
Var finns APIet?
Den senaste versionen av APIet hittar du på www.temperatur.nu/api/tnu.php För att använda en specifik version kan du använda www.temperatur.nu/api/tnu_{version}.php, ex www.temperatur.nu/api_1.0.php för version 1.0. Inga garantier ges för att olika versioner av APIet är kompatibla.
Parametrar
| Parameter | Beskrivning | Kan ej användas med | Introducerad i API-version |
|---|---|---|---|
| p | Anger för vilka orter data skall returneras - kommaseparerad lista | lat, lon, num | 1.0 |
| simple | Minimal output, returnerar endast temperatur, Name, shortname | verbose | 1.0 |
| verbose | Returnerar alla fält för orten, se beskrivning nedan | simple | 1.0 |
| coordinates | Visar koordinaterna för valda orter. Kan användas tillsammans med simple för att kunna positionera orter på en karta. | verbose | 1.0 |
| lat | Används tillsammans med lon och ev num. När dessa parametrar används returneras de num närmaste orterna, närmaste orten först. | p | 1.0 |
| lon | Används tillsammans med lat och ev num. När dessa parametrar används returneras de num närmaste orterna, närmaste orten först.. | p | 1.0 |
| num | Används tillsammans med lon och lon. Anger hur många orter som skall returneras. Standard är 1 och max är 5. | p | 1.0 |
Villkor
- APIet får ej accessas oftare än var femte minut från klienterna. Om detta villkor bryts kan det IP-nummer som överskrider tidsgränsen tillfälligt att blockeras.
- Det måste mycket tydligt framgå att temperaturerna kommer från temperatur.nu.
- Där så är möjligt skall temperaturerna vara länkar till temperatur.nu.
- Temperatur.nus 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.
