Panoramica

aggiornato

This is the documentation for Reincubate's ricloud API. The API provides users access to their own data in Apple's iCloud and local iTunes backups via the Reincubate Relay app.

For product information see the ricloud API product page.

Concetti chiave

risorse

The API is organised into a set of resources. A client can create, retrieve, update and destroy (CRUD) these to configure, trigger, and monitor operations on the API. See the API resource reference for more details.

Elaborazione asincrona

L'API si basa su operazioni asincrone per l'impostazione di sessioni contro servizi di terze parti e l'elaborazione dei dati. Ciò gli consente di gestire una grande quantità di richieste di dati interagendo responsabilmente con i servizi esterni. Offre inoltre una maggiore flessibilità per reagire alle fluttuazioni nei tempi di risposta o al degrado nei servizi di terzi.

Pubblicazione del bucket di archiviazione

I dati richiesti dall'API vengono pubblicati direttamente nel bucket di un cliente su Google Cloud Storage o Amazon S3. Ciò consente di ridurre al minimo i problemi legati al ridimensionamento della trasmissione dei dati e consente inoltre un recupero dei dati più rapido in quanto è meno probabile che la pubblicazione diventi un collo di bottiglia.

Notifiche di Webhook

Notification of asynchronous operation completion is handled via webhooks, whereby events are sent to a client's server through standard HTTP requests. These events contain information on where to find requested data within a client's bucket, allowing the client to make a decision on when and how to use it.

Parole chiave

Prima di tuffarsi nella sezione introduttiva, è utile avere familiarità con una manciata di termini e concetti che verranno utilizzati in tutto.

Servizio

Un servizio descrive una raccolta di origini dati disponibili tramite l'API. Questo include servizi di terze parti, come ad esempio iCloud, o prodotti reincubare, come asrelay.

Servizi diversi avranno requisiti diversi per determinate risorse sull'API, oltre a modificare il ciclo di vita complessivo degli oggetti API. Ad esempio, il carico utile necessario per creare una sessione per il servizio iCloud è diversa da quella necessaria sul servizio asrelay.

fonte

These are specific sources of data within a service. An iCloud account is the primary source of the iCloud service, whereas a Reincubate Relay app instance is the primary source of the Reincubate Relay service.

Utente

A user represents the end-user that is requesting data. In many cases, this will be a user of your application.

Sessione

A session represents access to a specific source, and one is needed in order to retrieve any information or data from the source through the API.

Creating a session is the equivalent of a 'login' into an iCloud account or 'pairing' with a Reincubate Relay app instance.

The API will execute the session initialisation process asynchronously. This means the call to create a session will return immediately, but the session will not be ready to use until initialisation has completed.

Sondaggio

Polls are how users can request data through the API. An active session against the targeted source is needed for a poll to be created.

Tutti i sondaggi vengono elaborati in modo asincrono tramite una o più attività e i risultati vengono pubblicati nei bucket di archiviazione cloud configurati sulla propria organizzazione.

Compito

These are the underlying chunks of work performed by the API. When a session is created, it also creates a task in order to perform any initialisation against external services. When a poll is created, it will create at least one task to perform any necessary work.

Result

A result is a reference to data or a file published to a client's storage bucket.

Come possiamo aiutare?

Il nostro team di supporto è qui per aiutarti!

I nostri orari di ufficio sono dal lunedì al venerdì, dalle 9:00 alle 17:00 GMT. L'ora è attualmente 4:28 PM GMT.

Miriamo a rispondere a tutti i messaggi entro un giorno lavorativo.

Vai alla sezione di supporto › Contatta il team aziendale ›
Il nostro fantastico team di supporto

Possiamo migliorare questo articolo?

Ci piace ascoltare gli utenti: perché non mandarci un'email, lasciare un commento o twittare @reincubate?

© 2008 - 2020 Reincubate Ltd. Tutti i diritti riservati. Registrato in Inghilterra e Galles #5189175, VAT GB151788978. Reincubate® è un marchio registrato. Politica sulla riservatezza & condizioni. Raccomandiamo 2FA. Costruito con a Londra.