API Dokumentaatio

Voit käyttää rajapintaamme päivittämään dynaamisen IP-osoitteen palvelimellemme. Tämä on tarpeellista, kun sinulla on muuttuva IPv4-osoite. Rajapintamme käyttää DynDNS:n yleistä standardia ja samoja vastauskoodeja.


API osoite:   https://kuusitunneli.fi/api/ ja https://kuusitunneli.fi/nic/

Pakota IPv4: https://ipv4.kuusitunneli.fi/api/
Pakota IPv6: https://ipv6.kuusitunneli.fi/api/

Esimerkki:   curl -4 --silent --user 'USERNAME:PASSWORD' 'https://kuusitunneli.fi/api/update?hostname=TUNNEL_ID&myip=IPV4-ADDR'

Update

Käytä tätä kun haluat päivittää julkisen IPv4-osoitteen palvelimelle. Voit käytää komentoa ilman IP-parametriä mutta TUNNEL_ID on vaadittu. Jos et määritä IPv4-osoitettasi, käytetään sitä osoitetta millä muodostat yhteyttä. Huomaa että jos käytössäsi on IPv6-osoite, vaaditaan IPv4-osoitteen syöttäminen.

Syntaksi:

/update?hostname=TUNNEL_ID&myip=IPV4_ADDR

Status

Käyttämällä tätä komentoa saat tunnelin tilan selville

Syntaksi:

/status?hostname=TUNNEL_ID

Vastauskoodit

Tässä ovat yleiset rajapintamme vastauskoodit. Täälä on vain yksi onnistumista ilmaisema vastaus. Koodi good ilmaisee onnistumista. Mikäli saat nochg, tämä tarkoittaa että on jo päivitetty.

badauth - Todennus epäonnistui, tarkista käyttäjätunnus ja salasana.
good - Päivitys onnistui.
nochg - Päivitys epäonnistui - Rajapintamme kertoo että päivität liian nopeasti.
nohost - TUNNEL_ID:tä ei löytynyt käyttäjätililtäsi
numhost - Liian monta Tunnel_ID:tä.
toofast - Liian nopeasti yrität päivittää. Yritä 5 minuutin kuluttua uudelleen.
notfqdn - TUNNEL_ID ei ole validi.
abuse - TUNNEL_ID on estetty
dnserr - Teknillinen virhe. Virhe voi johtua siitä että olet yrittämässä päivittää kahdelle tunnelille samaa IPv4-osoitetta.