PlanMill REST API 1.5-integraatiorajapinta julkaistu

PlanMill REST API 1.5-integraatiorajapinta julkaistu

Olemme julkaisseet seuraavan sukupolven REST API 1.5 version, joka käyttää JSON formaattia.

Miksi muuttaa asiaa, joka toimii?

Verrattuna aiempaan vuonna 2009 julkaistuun APIiin (1.0), uuusi 1.5 versio tarjoaa helpommin hyödynnettävän ja selkeämmän käyttökokemuksen ja standardoidun HMAC autentikoinnin.

Aloitimme uuden API-sukupolven kehittämisen alan parhaiden käytäntöjen mukaisena saatujen käyttökokemusten ja asiakkailta ja kumppaneilta saadun palautteen perusteella.  Olemme olleet myös hyvin aktiivisia saadaksemme kotimaista ja kansainvälistä API-asiantuntemusta ja erilaisia kokemuksia käyttöömme osallistumalla  ja puhumalla seminaareissa  ja seuraamalla aktiivisesti Nordic APIs ja APISuomi yhteisöjen toimintaa.

Suosittelemme muillekin ”API-kuuria”, joka kannattaa aloittaa tutustumalla viisaisiin sanoihin ja kokemuksiin lukemalla API gurujen ja API-palveluja tarjoavien asiantuntijoiden (mukaan lukien meidän)  puheenvuoroista kirjoitettua e-kirjaa julkisista, yksityisistä ja kumppani -apeista: http://nordicapis.com/developing-the-api-mindset-private-partner-and-public-apis/.

Kuinka alkuun API 1.5:n kanssa?

Tutustu API-dokumentaatioon, joka sisältää kaiken mitä meillä tällä hetkellä on tuotannossa 1.5 versiossa (linkki toimii myös omasta PlanMillistäsi, vaihda oman instanssin nimi ”pmtrial” sanan tilalle): https://online.planmill.com/pmtrial/schemas/v1_5/index.html.

Jos olet kokonaan uusi PlanMill APIn käyttäjä (et ole käyttänyt mitään versiota), ota meihin yhteyttä API-avaimen saamiseksi.

Huom!: Jos olet jo käyttänyt API 1.0:aa sinun ei tarvitse ottaa yhteyttä meihin ottaaksei käyttöön 1.5:n, vaan voit generoida itsellesi 1.5 API -avaimen API-dokumentaation ”Authentication example” -kohdan ohjeiden perusteella.

 

Hinnoittelu

PlanMill REST API 1.5 ei ole julkinen API, vaan tarkoitettu asiakkaillemme ja kumppaneille, joten sinun tulee olla PlanMillin käyttäjä tai sinulla tulee olla pääsy asiakkaasi tai kumppanisi PlanMilliin voidaksesi käyttää APIa.

API-rajapintaamme tehdään useita miljoonia kutsuja päivittäin API 1.0:lla ja ennustamme, että käyttömäärä kasvaa räjähdysmäisesti API 1.5:n osalta. 

Voidaksemme pitää kaikki asiakkaamme tyytyväisinä ja suorituskyvyn kunnossa, meidän on täytnyt asettaa rajoituksia APIn käytölle kannustaaksemme järkevään käyttöön ja estääksemme isot ennustamattomat piikit käytössä.

API 1.5 on käytössä maksutta ainakin 1.4.2015 asti, sen jälkeen aiomme ottaa käyttöön käyttömääriin perustuvan hinnoittelun. Kehitys ja pieni päivittäinen intograatiokäyttö tulee senkin jälkeen olemaan täysin maksutonta (eli sisältyy käyttäjän normaaliin kuukausihintaan).

Mitä seuraavaksi?

Olemme muokaneet ja soveltaneet kehitysprosesiamme ja teknologioitamme sopimaan entistä paremmin API-kehitykseen ja APIn hyödyntämiseen. Kehitämme parhaillaan mielenkiintoisia uusia palveluita uusilla käyttöliittymä teknologioilla ja käyttäen omaa API 1.5:tä yhteyksissä omaan sovellukseemme. Tämä on auttanut meitä kehittämään myös API 1.5:tä, koska saamme jatkuvaa palautetta omilta käyttöliittymäkehittäjiltämme asiakkaiden lisäksi ja uskomme että tämä hyvä käytäntö osoittautuu vielä hedelmällisemmäksi tulevaisuudessa.

Teemme parhaillaan työtä saadaksemme tarjottua kaikki nykyiset API 1.0 rajapinnan kutsut 1.5 versioina vuoden 2015 aikana. Aloitimme julkaisemalla tuntiraportointiin liittyvät kutsut ensin, koska ne olivat osoittautuneet kaikkein suosituimmiksi nykyisten API-käyttäjiemme keskuudessa.

Aiomme lopettaa API 1.0 tuen 03/2016 ja suosittelemme kaikille uusia ja ja olemassa olevia integraatioita tekeville API 1.5.  Jos sinulla on tiedossa oleva aikataulu saada käyttöön tiettyjä 1.5 kutsuja, joita et vielä löydä dokumentaatiosta, ota meihin yhteyttä niin selvitämme miten voimme auttaa.

Kehitätkö jo meidän API 1.5 versiollamme?

Arvostamme palautettasi, otathan yhteyttä.

Facebooktwittergoogle_pluslinkedin