Plugchoicen REST-rajapinnalla voit rakentaa oman tuotteesi alustan päälle: lukea latausasemia, lataustapahtumia ja mittarilukemia, käynnistää ja lopettaa latauksen, hallita kortteja, sijainteja ja energianhallintaa, ja paljon muuta. Tämä sivu on kumppaneille tarkoitettu lyhyt versio; täydellinen tekninen dokumentaatio on osoitteessa developer.plugchoice.com.
Mistä dokumentaatio löytyy
developer.plugchoice.com: täydellinen rajapintaviite sekä oppaat aiheista authentication, virheet, sivutus ja kutsurajoitukset.
Rakennatko tekoälyavustajan kanssa? Syötä sille developer.plugchoice.com/llms.txt (hakemisto) tai llms-full.txt (koko dokumentaatio yhdessä tiedostossa). Tekoälytyökalusi osaa tämän jälkeen vastata rajapintaa koskeviin kysymyksiin ja kirjoittaa integraation puolestasi.
Kaksi tapaa tunnistautua
Henkilökohtainen käyttöoikeustunnus: nopein tapa aloittaa. Luo tunnus kohdassa Settings > Personal Access Tokens Plugchoicen hallintapaneelissa, niin voit kutsua rajapintaa omalla tililläsi heti. Sopii skripteihin, testaukseen ja sisäisiin työkaluihin.
OAuth 2.0: asiakkaidesi käyttämiin tuotteisiin. Sovelluksesi saa oman pääsyn kunkin asiakkaan tietoihin heidän luvallaan, ilman että kukaan jakaa salasanoja tai tunnuksia.
Miltä OAuth näyttää asiakkaallesi
Sovelluksessasi asiakas napsauttaa esimerkiksi Connect Plugchoice.
Asiakas päätyy tuttuun Plugchoicen kirjautumisnäkymään ja kirjautuu omalla tilillään.
Plugchoice pyytää häntä hyväksymään sovelluksesi pyytämän pääsyn, yhdellä napsautuksella.
Hänet ohjataan suoraan takaisin sovellukseesi, joka saa nyt turvallisesti omat tunnuksensa kyseiselle asiakkaalle.
Ei tunnusten kopiointia käsin, ei jaettuja salasanoja, ja asiakas voi peruuttaa pääsyn milloin tahansa. Tämä on sama kulku, jonka asiakkaat tuntevat jo muiden palveluiden yhdistämisestä.
Pääsyn saaminen
Jotta voimme ottaa OAuthin käyttöön sovelluksellesi, tarvitsemme sinulta vain yhden asian: paluuosoitteen (redirect URL) (osoite sovelluksessasi, johon asiakas palaa hyväksynnän jälkeen). Lähetä se meille messengerin kautta tai kumppanikontaktillesi, niin luomme OAuth-asiakkaasi ja lähetämme sinulle tunnukset.
Henkilökohtaiset käyttöoikeustunnukset eivät vaadi meiltä mitään: luo tunnus hallintapaneelissa ja ala rakentaa.