Kapcsolódó információk:
Paraméterezési útmutatók

Összehasonlított verziók

Kulcs

  • Beillesztett sor.
  • Törölt sor.
  • Formázás megváltoztatva.

...

Az API a következő belépési ponton érhető el. A szerver név a helyi intranetet környezettől függ.

Panel
bgColorAliceBlue
titleBGColorLightSteelBlue
titleGET | POST |

...

PUT

...

http://server/dbconnector/api

...

/.....

Az egyes törzsadatok elérése az innen nyíló al-verbeken érhetők el.  A válaszok XML-ben érkeznek.

Minden API híváskor az autentikációs adatokat a HTTP header-ben kell beküldeni.

Header paraméterek
   pkod:SajatSupPartnerKod
   lickod:SajatSupLicKod 


Az adatok a SUP rendszert felhasználó cég számára átadott licence adatlapon találhatók.

...

Az egyes verb-eknél további header paraméterek átadása is szükséges lehet.

Qsboxfigyelem

Az API korlátozza a másodpercenkénti hívások számát, mivel a terhelhetőség erősen függ a működési környezettől. Az API-t használó programnak figyelnie kell rá, hogy a 2 hívás/másodperc értéket ne lépje túl.

API tesztelése

Panel
bgColorAliceBlue
titleBGColorLightSteelBlue
titleGET |

...

POST

...

http://server/dbconnector/api/v1/test

A hívás célja az API elérhetőségének tesztelése. Az elérhetőség egyszerű tesztelésére bármely böngésző alkalmas. A komplex teszteléséhez pl.: a széles körben elterjedt CURL használható

...

Body paraméter (opcionális raw data)
   dummy

...

.

Alapesetben csak az API

...

elérhetőségét teszteljük. Ez

...

bashbash

ekvivalens a böngésző címsorból meghívott móddal.

Kódblokk
language
java
titleHívás minta - API elérhetősége
CURL.EXE    ^
  -X GET    ^
     http://server/dbconnector/api/v1/test


A teljes teszthez meg kell adni a hitelesítő adatokat is. Siker esetén egy verziószám a válasz.

Kódblokk
language
java
titleHívás minta - Authentikációs adatok tesztelése
CURL.EXE 	^
  -X POST   ^
     http://server:8080/dbconnector/api/v1/test	^
	-H pkod:SajatSupPartnerKod	^
	-H lickod:SajatSupLicKod
Kódblokk
languagexml
titleVálasz minta
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<DbConnectorResponse>
    <Success>true</Success>
    <StatusCode>200</StatusCode>
    <Message>API build: 1.0.6536M (2018.08.09. 16:07:30)
DbConnector DLL: 15.1 (2018.08.01. 8:16:32)
</Message>
</DbConnectorResponse>

Minden API hívás egy <DbConnectorResponse> típusú XML válasszal tér vissza

A <Success> arra vonatkozóan ad információt, hogy a hívás sikeres volt-e
A <StatusCode> megegyezik a http statuskóddal

Kliens implementáció

A kliens implementáció első lépése az API működésének tesztelése. A tesztelés két üzemmódban lehetséges.

...

A működés teszteléséhez a széles körben elterjedt CURL használható. Szintén használhatók a különböző böngészőkhöz készített bővítmények, vagy az erre a célra fejlesztett önálló szoftverek, pl.: PostMan.

Qsboxfigyelem

Az API hívás sikerességét alapvetően a http statuskóddal kell ellenőrizni A válasz XML-ben levő <StatusCode> inkább csak a tájékoztatás, és az információk jobb olvashatósága miatt van

Intraneten kívüli használat

Az API alapvetően intranetes felhasználásra készült, nincs . Nincs akadály annak, hogy megfelelő biztonsági feltételek megteremtésével az internet irányából is használható legyen.

...