Hoe u live verhuurvoorraadgegevens aan uw website koppelt
Met HireHop kunt u naadloos live voorraadgegevens rechtstreeks naar uw bedrijfswebsite sturen. Dankzij deze krachtige functie kunt u uw verhuur- en verhuurinventaris online plaatsen — compleet met afbeeldingen, beschrijvingen en realtime beschikbaarheid — perfect gesynchroniseerd met uw HireHop-database.
U kunt voorraadlijsten eenvoudig filteren op categorie of naam, en ze sorteren op naam, prijs, gewicht of beschikbare voorraadhoeveelheden. Het systeem laat u ook kiezen in welk formaat u de export wilt ontvangen, of dit nuJSON, CSV of XML is.
Deze functie kan ook worden gebruikt om uw verhuurvoorraadgegevens eenvoudig te exporteren, waardoor u gefilterde delen van uw gegevens of alles in één keer kunt exporteren.
Hoe u een voorraadlijst opvraagt
Voordat u een lijst exporteert, moet u eerst een exportsleutel aanmaken. Deze sleutel werkt als een wachtwoord dat moet worden meegegeven om de lijst op te halen. Als u de exportsleutel wijzigt, worden alle verzoeken zonder de nieuwe sleutel geweigerd.
Om de export te verkrijgen, hebt u een link nodig die u kunt vinden op de Hire Stock Management-pagina:
- Filter de pagina om precies het voorraadoverzicht te tonen dat u wilt. Als u bijvoorbeeld een categorie selecteert, genereert de link de volledige voorraad in die categorie, precies zoals deze op de pagina wordt weergegeven.
- Klik op Menu en vervolgens op Gegevenslink ophalen.
- Er verschijnt een venster met een link om een lijst voor uw huidige gefilterde weergave te verkrijgen.(Let op: u moet geautoriseerd zijn om deze link te verkrijgen in uw gebruikersrechten.)
De door HireHop geretourneerde gegevens bevatten de naam, een afbeeldingslink, aantal, categorie, gewicht, afmetingen, prijzen, onderdeelnummer, enz.
Technische parameters
De gegenereerde link ziet er ongeveer uit als in het onderstaande voorbeeld en bevat diverse parameters die u kunt wijzigen om uw voorraadgegevens te filteren of te sorteren:
https://s.myhirehop.com/modules/stock/stock_export.php?id=10&key=abc1234def&depot=1&cat=0&sidx=TITLE&sord=asc&format=xmlHier volgt een uitleg van wat elke parameter betekent:
| Parameter | Betekenis |
| id | Dit is een unieke ID voor uw bedrijf. |
| sleutel | De gegenereerde exportsleutel. |
| depot | Een identificatie voor een depot (nul betekent alle depots), om het aantal te verkrijgen. |
| cat | De identificatie voor een categorie. |
| categorie_naam | De naam van een categorie. |
| naam | De naam van de zoekopdracht. |
| verw | Indien ingesteld op één, worden verwijderde items weergegeven. |
| unq | Een uniek ID van een item. Indien ingesteld, wordt er slechts één item geretourneerd. |
| sidx | De kolom waarop gesorteerd moet worden. |
| sord | De sorteervolgorde; asc = oplopend & desc = aflopend. |
| indeling | Het formaat waarin de gegevens worden geretourneerd, zijnde XML, CSV of JSON (standaard). |
Codevoorbeeld (met jQuery)
Om de gegevens in je webpagina te laden, kun je Ajax gebruiken met JSONP. Bijvoorbeeld met jQuery:
$.ajax({
url: "https://s.myhirehop.com/modules/stock/stock_export.php?id=10&key=abc1234def",
dataType: "jsonp",
success: function( data ) {
console.log( data );
}
});Let op: de service-, PAT-keurings- en testintervallen zijn in ISO 8601-periodeformaten en alle afmetingen en gewichten zijn metrisch.
Developer Resources & API-updates
Het direct koppelen van actuele verhuurvoorraadgegevens aan een externe website is een van de meest effectieve manieren om klantvragen te automatiseren en real-time beschikbaarheid te tonen.
Als je een ontwikkelaar bent die met de HireHop API werkt of aangepaste webintegraties bouwt, kun je je abonneren op onze mailinglijst voor ontwikkelaars om technische documentatie-alerts, webhook-notities en updates over kernsysteemreleases rechtstreeks in je inbox te ontvangen.
