protocollen

bijgewerkt

Asynchrone verwerking

De API maakt voor alle peilingen gebruik van asynchrone verwerking. Dit omvat interacties met externe services, zoals de iCloud, omdat deze afhankelijk van de verwerkingssnelheid enkele seconden of minuten in beslag kunnen nemen.

Een aantal standaardbroninteracties kunnen asynchrone 'bijwerkingen' veroorzaken die worden uiteengezet in de API-referentiedocumentatie. Deze zijn meestal bedoeld voor het uitvoeren van geldigheidscontroles of andere hulpprogramma's.

De asynchrone basis van de API helpt ook de interface voor periodieke polling te vereenvoudigen die vanuit de API wordt geactiveerd. Dit betekent dat het ophalen van gebeurtenissen en resultaten hetzelfde is, of dit nu rechtstreeks met de API is of via geplande peilingen.

Wacht op antwoord

De API ondersteunt het wachten op de voltooiing van asynchrone taken via langlevende aanvragen om de behoefte aan polling te minimaliseren en de totale responstijd voor eindgebruikers te verminderen. Om deze functionaliteit in te schakelen, voegt u de Ricloud-Await HTTP-header toe aan uw verzoeken met de gewenste time-outwaarde. De huidige maximale time-outwaarde is 10 seconden.

Ricloud-Await: 3

Deze functionaliteit wordt ondersteund op de volgende eindpunten:

Versleutelde publicatie

Alle resultaten die door de API worden gepubliceerd, kunnen worden gecodeerd met een openbare RSA-sleutel in de hele organisatie.

Kenmerktypes

Elke datetime-attributen zullen altijd worden geformatteerd volgens de ISO8601-specificatie. De API retourneert alle datetime-kenmerken met de UTC-tijdzone. Daarom is het verwachte formaat "2018-08-22T10:25:05Z" .

Paginering

De API maakt gebruik van op cursor gebaseerde paginering. Voor alle oproepen van het lijsttype gelden de aanvullende parameters:

  • limit om het maximale aantal items te specificeren dat moet worden geretourneerd. Standaardwaarde is 10, max. Waarde 1000.
  • after_id om de ID op te geven van waaruit de lijst moet worden gestart.
  • before_id om de resource-ID op te geven waarvan de vermelding moet worden gestopt.

Lijstreacties omvatten teruggestuurde bronnen onder het data attribuut. Ook opgenomen is het helper attribuut has_more wat has_more of meer bronnen kunnen worden vermeld die niet zijn opgenomen vanwege de limiet.

Tarieflimieten

Verzoeken om de API kunnen worden beperkt door een standaardtarieflimiet of door een limiet voor aanvragen tijdens de vlucht. De eerste wordt gebruikt om misbruik van API-bronnen op grote schaal te minimaliseren, terwijl de laatste wordt gebruikt om afzonderlijke resource-instanties te beschermen.

Voorbeeld van snelheidsbeperking: het aantal verzoeken aan de API van een enkele organisatie is beperkt tot 10.000 verzoeken per uur. Dit helpt beschermen tegen kwaadaardige of toevallige spikes in het verkeer.

Voorbeeld van een in-flight limiet : aan een instantie van een bronbron kan geen taak worden gemaakt als een andere taak al wordt verwerkt. Hiermee wordt de integriteit van de sessie behouden, het verkeer naar externe services tot een minimum beperkt en

Versioning

Hoewel de belangrijkste releases van de API een grotendeels semantisch versiebeheerschema hebben (dwz v1 , v2 , v3 ), zijn alle wijzigingen die in de v3- versie van de API worden doorgevoerd, geaggregeerd volgens een kalenderversieschema (ie 2018-11-06 ). De versie kan globaal voor uw organisatie worden ingesteld of per aanvraag worden opgegeven via de Ricloud-Version de Ricloud-Version .

Verwijderbare bronnen

De meeste bronnen zijn niet-verwijderbaar, wat betekent dat ze alleen kunnen worden gedeactiveerd door de eigenaarorganisatie of worden geblokkeerd door een API-beheerder.

Hoe kunnen we helpen?

Ons ondersteuningsteam is er om u te helpen!

Onze kantooruren zijn van maandag tot vrijdag van 09.00 tot 17.00 uur GMT. De tijd is momenteel 5:51 AM GMT.

We streven ernaar om alle berichten binnen één werkdag te beantwoorden.

Ga naar het ondersteuningsgedeelte › Neem contact op met het Enterprise-team ›
Ons geweldige ondersteuningsteam

© 2008 - 2019 Reincubate Ltd. Alle rechten voorbehouden. Geregistreerd in Engeland en Wales #5189175, VAT GB151788978. Reincubate® is een geregistreerd handelsmerk. Privacy en voorwaarden. Wij bevelen 2FA aan. Gebouwd met in Londen.