Miért más? Így változott az új API 3.0-ás verzió!

Az új API tervezése során nagy hangsúlyt fektettünk arra, hogy a felhasználóinktól, fejlesztőktől érkező észrevételeket figyelembe véve egy olyan API-t hozzunk létre, ami széles körben elterjedt technológiára épül, jól dokumentálható, verziózható és könnyű rá SDK-t készíteni. A visszajelzésekből azt láttuk, hogy a 2-es verzióban is alkalmazott REST architektúra elég közkedvelt, így ezen nem változtattunk. Továbbá azt tapasztaltuk, hogy a legtöbb problémát a hiányos és a nem up-to-date dokumentáció okozta. Így ezen javítva és a fent megfogalmazott igényeket figyelembe véve az egyik legnagyobb változás az, hogy a Billingo API 3.0 dokumentációja az OpenAPI (korábban Swagger) specifikáció alapján készült el. Ez a változás számos olyan előnnyel jár, mint a könnyen áttekinthető, interaktív dokumentáció, ahol pár kattintással könnyen kipróbálható az API működése vagy akár a 30+ különböző programozási nyelven (PHP, Java, C++, C#, Python, Go…) kigenerálható SDK.

Használhatom a korábban a 2-es verzióhoz kigenerált API kulcsomat az új 3.0-hoz?

A 2-es verzióban használt JSON Web Token (JWT) alapú authentikációs megoldást lecseréltük egy ugyanolyan biztonságos, de egyszerűbben használható API kulcs alapú megoldásra. Ennek következményeképpen nem használható a régebbi kulcs az új verzióhoz. 

Meddig használhatom a Billingo API 2-es verzióját?

Számos meglévő integráció még a Billingo API 2-es verzióját használja, így biztosan támogatott lesz még ez a verzió is. Az esetleges támogatás megszűnéséről hónapokkal előre tájékoztatni fogjuk a felhasználóinkat. 

Fognak érkezni új funkciók a régi verzióba?

Új fejlesztések kizárólag a Billingo API 3-as verziójához fognak érkezni, de ha azt tapasztaljuk, hogy van olyan funkció melyre sok igény érkezik, akkor a régi verzióban is lefejlesztésre kerül idővel. 

A Billingo felületén nem találom, hol kell az új verzióhoz API kulcsot generálni.

Meglévő felhasználóinknak folyamatosan kapcsoljuk be az új verzió elérhetőségét, pár héten belül mindenki számára elérhető lesz.

Használhatom sandbox módban az új 3.0-ás verziót?

Az új API jelenleg nem támogatja a sandbox módot, teszteléshez egy új ingyenes tesztfiók regisztrálást javasoljuk.