API-sleutels
Toepassingen die gebruikmaken van een API in plaats van de gebruikersinterface, kunnen zich niet als gebruiker aanmelden. In plaats daarvan bevat elk verzoek de waarde van een API-sleutel, waarmee het account wordt geïdentificeerd waartoe het verzoek behoort. Aangezien de sleutel uw accountidentiteit bevat, hoeft bij verzoeken geen account- of tenant-parameter te worden opgegeven.
U kunt maximaal tien sleutels voor uw account instellen. Veel organisaties maken voor elke toepassing die gegevens ophaalt één sleutel aan, zodat een sleutel kan worden vervangen of verwijderd zonder dat dit de andere toepassingen verstoort. Elke sleutel heeft een naam, een beschrijving en een vervaldatum.
De waarde van een sleutel wordt slechts één keer weergegeven, namelijk op het moment dat u de sleutel aanmaakt of vervangt. Account Administration slaat de waarde niet op in een vorm waarin deze opnieuw kan worden weergegeven; u dient de waarde daarom te kopiëren en veilig op te slaan op het moment dat deze wordt getoond. Als een waarde verloren gaat, draait u de sleutel om een nieuwe te genereren. Iedereen die over de waarde beschikt, kan verzoeken indienen via uw account; beveilig uw sleutels daarom op dezelfde manier als u een wachtwoord beveiligt. Sleutels zijn niet beperkt tot bepaalde printers.
Sleutels worden beheerd op het tabblad API-sleutels. U kunt de naam, de beschrijving of de vervaldatum van een sleutel wijzigen; een sleutel roteren om de waarde ervan te vervangen met behoud van de identiteit; of een sleutel verwijderen om de toegang onmiddellijk in te trekken.
Op RICOH TotalFlow Cloud worden API-sleutels gebruikt in combinatie met de gegevensexport-API, waarmee informatie over printers, afdruktaken en de status van printers wordt opgehaald die is verzameld via RICOH Predictive Insight. Het aantal API-verzoeken dat uw account kan indienen, over alle API-sleutels heen, wordt bepaald door uw abonnement. Voor elk abonnement geldt een maximum voor het aantal API-verzoeken dat is toegestaan binnen een voortschrijdende periode van 30 dagen. Indien u het aantal oproepen overschrijdt dat in uw abonnement is inbegrepen, worden er geen verzoeken meer geaccepteerd totdat het totale aantal verzoeken van de afgelopen 30 dagen onder de abonnementslimiet daalt. Om te zien hoeveel gesprekken uw abonnement omvat en hoeveel u er in de afgelopen 30 dagen hebt verbruikt, raadpleegt u de pagina API-sleutels. Mocht u merken dat u meer capaciteit nodig heeft voor API-verzoeken, neem dan contact op met uw Ricoh-vertegenwoordiger om uw abonnement uit te breiden.