Werken met de gegevensexport-API

Met de gegevensexport-API kunt u informatie die door RICOH Predictive Insight is verzameld, extraheren voor gebruik in andere processen en tools binnen uw organisatie.

De gegevensexport-API biedt programmatische toegang tot printerinformatie, de geschiedenis van de uitgevoerde taken, gegevens over de printerstatus en gebeurtenissen waarbij ingrijpen in de printer vereist is. U kunt het gebruiken om rapportagetools te voeden, dashboards te vullen, operationele gegevens te archiveren of gegevens uit de RICOH Predictive Insight te integreren met andere systemen in uw omgeving.

In this section:

  1. Gegevensexport-API
    De gegevensexport-API is een REST-API die vier eindpunten biedt. U kunt deze eindpunten gebruiken om informatie te downloaden over uw printers en de taken die zij hebben verwerkt, evenals de bedrijfsstatus van die printers in de loop van de tijd en gebeurtenissen die aanleiding hebben gegeven tot waarschuwings- of foutmeldingen op de printer.
  2. API-sleutels aanmaken en beheren
    Een API-sleutel autoriseert verzoeken aan de gegevensexport-API. U maakt API-sleutels aan en beheert deze op Account Administration, en u voert de sleutel in wanneer u verzoeken indient via de API-verkenner-pagina of vanuit uw eigen applicaties.
  3. De Gegevensexport-API uitproberen
    Volg deze procedure voor een korte inleiding tot de API, waarbij u de interactieve documentatiepagina als leidraad gebruikt.
  4. Verwerking van datum en tijd in de gegevensexport-API
    De gegevensexport-API maakt gebruik van één enkel, consistent model voor de verwerking van datums en tijden: bij elk verzoek wordt een IANA-tijdzone opgegeven, elke datum- en tijdwaarde wordt in die tijdzone geïnterpreteerd en elke datum- en tijdwaarde in het antwoord wordt in diezelfde tijdzone weergegeven. Gebruik dit onderwerp om inzicht te krijgen in de werking van het model en om veelvoorkomende fouten te voorkomen.
  5. Velden in het antwoord van de gegevensexport-API
    Elk eindpunt van de gegevensexport-API retourneert een JSON-array met objecten. Gebruik de tabellen in dit onderwerp om de velden in elk antwoord te interpreteren.
  6. Voorbeelden van verzoeken en antwoorden voor de gegevensexport-API
    Gebruik de voorbeelden in dit onderwerp als uitgangspunt voor uw eigen integratie. Elk voorbeeld toont een representatieve aanvraag-URL, samen met de inhoud van het antwoord dat de API retourneert.
  7. Problemen met de gegevensexport-API oplossen
    Gebruik dit onderwerp om veelvoorkomende foutmeldingen van de gegevensexport-API te interpreteren en voor elke fout de meest waarschijnlijke oorzaak en oplossing te achterhalen. Elke foutmelding bevat een code, een message en een numerieke statusCode; de waarde van de code geeft de specifieke voorwaarde aan.

Related information:

API-sleutels aanmaken en beheren
Tabblad API-sleutels
API-sleutels
Ouder onderwerp: RICOH Account Administration