Viestimme aiemmin (12/2023), että olemme uudistamassa ulkoisten rajapintojen ympäristöjä ja uudistukseen liittyy toimenpiteitä, joihin myös partnerimme tulee reagoida jatkaakseen rajapintojen käyttöä. Alla tarkemmin kuvattuna muutoksia ja niihin liittyviä alustavia aikatauluja.
Edellyttää toimenpiteitä nyt: Uuden rajapintaympäristön testaaminen
- Testiympäristö (staging) on nyt saatavilla Korttivarasto, Raporttinoutaja ja PersonAPI rajapinnoille
- Testiympäristön käyttöönotto vaatii sähköpostin ja puhelinnumeron ilmoittamisen Vastuu Groupille. Ilmoittakaa sähköpostiosoite ja puhelinnumero meille mahdollisimman pian sähköpostiin: partnerit@vastuugroup.fi
- Huomioikaa, että osoitteet ja tunnistautumistapa muuttuu ja rajapintojen vanhat tunnistautumiset lakkaa portaittain toimimasta 2024 aikana.
- Siirtymäajan aikana vanha osoite ja tunnistautumistapa on rinnakkaiskäytössä
- Lähetämme rajapintatunnukset toimittamiinne yhteystietoihin
- Rajapintojen API versio muuttuu osoitteessa
-
- korttivarasto/v1.2/… => korttivarasto/v1.3/…
- raporttinoutaja/v3.0/… => raporttinoutaja/v3.1/…
- personapi/v1.0/… => personapi/v1.1/…
- Muita muutoksia osoitteissa
-
- personapi/v1.0/persons/authority_report -> personapi/v1.1/authority_report
- personapi/v1.0/employees/contacts -> personapi/v1.1/contacts
- personapi/v1.0/employees/personal_information?items=tax_number -> personapi/v1.1/personal_information?items=tax_number
- Jatkossa rajapinnoissamme tuetaan vain OAuth 2.0 tunnistautumista
- Useimpiin rajapintakutsuihin tarvitaan mukaan customer-access-key
- Rajapintadokumentaatio löytyy jatkossa täältä.
-
- Tässä vaiheessa löytyy Korttivarasto, Raporttinoutaja ja PersonAPI
- Muita rajapintoja lisätään portaittain vuoden 2024 aikana
Edellyttää toimenpiteitä myöhemmin: Tuotantokäyttöön siirtyminen
Kun ratkaisua on testattu staging -ympäristössä ja pystymme tarjoamaan uudistetun pääsyn rajapintoihin, voidaan siirtyä tuotantokäyttöön. Tästä lisää informaatiota huhtikuun aikana.
Uudistuksen myötä myös partnereiden rajapintoja hyödyntävillä asiakkailla tulee olla Vastuu Groupin yritystili. Asiakkaan tulee luoda yritystili itse, jos sitä ei ole vielä olemassa. API avaimet tullaan luomaan jatkossa yritystililtä. Tulemme ohjeistamaan tästä vielä erikseen.
Alustavaa aikataulua 2024 vuoden aikana tulevista muutoksista:
- Maaliskuun loppupuoli 2024: Uusi Valtti+ Tarkastaja API testikäytössä staging-ympäristössä. Tähän liittyviä uusia integraatioita partnerit voivat alkaa kehittämään haluamansa aikataulun mukaisesti.
- Huhtikuu 2024: Korttivaraston, Raporttinoutajan, PersonAPI tekniset muutokset tuotannossa Vastuu Groupilla. Uuden Valtti + Tarkastaja API:n julkaisu tuotantoon.
- Kesäkuu 2024 Raporttinoutajan teknisen toteutuksen takaraja partnerille
- Syyskuu 2024 Korttivaraston teknisen toteutuksen takaraja partnerille
Tavoite on, että syksyn 2024 aikana kaikki rajapintoja hyödyntävät partnerit ovat siirtyneet asiakaskohtaisen API avaimen käyttöön.
Huomioikaa, että Taito Valtti API tullaan sulkemaan vuoden 2024 loppuun mennessä. Sen korvaa Valtti+ Tarkastaja API. Valtti+ Tarkastaja API kysymyksissä voitte olla suoraan yhteydessä Niko Hämäläiseen.
Mikäli asiasta ilmenee kysyttävää, tai tarvitsette tukea, autamme mielellämme muutoksissa, tavoitatte asiantuntijamme parhaiten sähköpostilla: partnerit@vastuugroup.fi
