|
|
(71 mellanliggande versioner av 2 användare visas inte) |
Rad 1: |
Rad 1: |
− | Det finns ett enkelt API för att hämta senaste temperaturerna från temperatur.nu.
| + | Informationen är flyttad till [https://temperatur.nu/info/api/ https://temperatur.nu/info/api/] |
− | | |
− | 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==
| |
− | {| border=1 class="wikitable"
| |
− | |-
| |
− | ! 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|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.
| |