ONTIME API Documentatie

CALL

Deze API biedt de mogelijkheid om steeds de actieve, mogelijke voertuigen op te halen voor uw bedrijf/klantennummer.

URL	https://api.asx.be/SPRINT/
METHOD	POST

REQUEST / INPUT

Hieronder krijgt u de structuur die gehanteerd wordt als input, inclusief een illustrerend voorbeeld en meer informatie per veld.
U mag zelf de keuze maken of u de gegevens naar ons toestuurt via JSON of XML

Niveau / Veld		Verplicht	Voorbeeld	Omschrijving
1	verwerking	*	VOERTUIGEN	een overzicht van alle mogelijke voertuigen voor uw klantnummer wordt opgehaald.
1	gebruiker	*	info@ontime.be	Emailadres waarop de API-account werd gedefinieerd. Max 250 karakters
1	klantnr	*	1234	Dit is het klantennummer bij ON TIME Logistics. numeriek, zonder voorgaande zeroes
1	apipswd	*	c40b0c360f3d4959b53b103b25759542	Paswoord van de API-account
1	omgeving	*	TEST	TEST = TEST omgeving LIVE = LIVE omgeving
1	productnr	*	18	productnummer waarvoor de mogelijke voertuigen dienen opgehaald te worden. numerieke waarde Indien u de producten specifiek voor uw klantnummer wenst op te halen: Klik hier

JSON voorbeeld

XML voorbeeld

<?xml version="1.0" encoding="utf-8"?>
<WebOrder> 
    <verwerking>VOERTUIGEN</verwerking>
    <gebruiker>info@ontime.be</gebruiker>
    <klantnr>1234</klantnr>
    <apipswd>c40b0c360f3d4959b53b103b25759542</apipswd>
    <omgeving>TEST</omgeving>
    <productnr>18</productnr>
</WebOrder>

RESPONSE / OUTPUT

Hieronder krijgt u de structuur die gehanteerd wordt als output, inclusief een illustrerend voorbeeld en meer informatie per veld.
Indien u heeft gestuurd met JSON, zal u JSON ontvangen, idem met XML

Niveau / Veld				Voorbeeld	Omschrijving
1	status			SUCCESS
1	remarks
	2	remark		Er werd 1 voertuig gevonden	Informatieve opmerkingen
1	voertuigen
	2	voertuig
		3	nr	58	het unieke nummer van het voertuig. Dit nummer dient meegegeven te worden in de nieuwe opdracht
		3	oms	Small « 450Kg	de omschrijving van het voertuig

Niveau / Veld			Voorbeeld	Omschrijving
1	status		ERROR
1	remarks
	2	remark	foutieve credentials	Oplijsting van de gevonden fouten

JSON antwoord bij SUCCES

JSON antwoord bij ERROR

XML antwoord bij SUCCES

<?xml version="1.0" encoding="utf-8"?>
<WebAnswer> 
    <status>SUCCESS</status>
    <remarks>
        <remark>er werden 2 voertuigen gevonden</remark>
    </remarks>
    <voertuigen>
        <voertuig>
            <nr>20</nr>
            <oms>Small &laquo; 450Kg</oms>
        </voertuig>
        <voertuig>
            <nr>58</nr>
            <oms>Medium &laquo; 500Kg</oms>
        </voertuig>
    </voertuigen>
</WebAnswer>

XML antwoord bij ERROR

<?xml version="1.0" encoding="utf-8"?>
<WebAnswer> 
    <status>ERROR</status>
    <remarks>
        <remark>foutieve credentials</remark>
    </remarks>
</WebAnswer>

CONTROLE/TEST

Via deze functie kan u elke JSON of XML input uitproberen.
OPGELET : Deze functie wordt STEEDS in de TEST omgeving uitgevoerd

Uw INPUT string

Het resultaat/antwoord:

Ophalen SPRINT voertuigen