Polls

Een peilingsbron bevat informatie over een specifiek verzoek om gegevens. Nadat een peiling is gemaakt, worden er één of meer taken gestart om het verzoek te voltooien.

attributen

taken

De belangrijkste rol van de peilingsbron is om de voortgang van de bijbehorende taken weer te geven en de eindgebruiker in staat te stellen hieruit resultaten op te halen zodra deze beschikbaar komen. Daarom onthult de peilingbron taakgerelateerde attributen waarin bijbehorende taken worden gecategoriseerd op basis van hun status.

resultaten

Alle resultaten die zijn gepubliceerd door taken die binnen de enquête worden uitgevoerd, worden weergegeven in het results de enquête.

Staten

De status van een peiling geeft alleen aan of de peiling wacht op initialisatie (in pending ), aan de gang is ( processing ) of dat alle taken zijn voltooid ( completed ).

Een peiling geeft geen enkele foutstatus weer, behalve via de bijbehorende taken.

payload

De payload van de enquête geeft aan welke soorten informatie, gegevenstypen en bestanden moeten werken om op te halen. Het schema met de kenmerken van de poll-payload wordt hieronder beschreven.

De poll-payload om alle soorten informatie over een iCloud-accountbron op te halen zou bijvoorbeeld zijn:

{
  "info_types": ["*"]
}

Een verscheidenheid aan berichtgegevens ophalen uit een iCloud-back-up of Reincubate Relay-bron, maar alleen vanaf een bepaalde datum:

{
  "data_types": ["ios_messages.messages", "whatsapp.messages", "viber.messages"],
  "filters": {
    "since": "2019-09-15T22:04:12Z"
  }
}

Bestandsgegevens ophalen voor afbeeldingen waarnaar wordt verwezen in een iCloud-fotobibliotheekresultaat:

{
  "files": ["icpl://xyz123", "icpl://abc321"]
}

De verschillende attributen kunnen ook tegelijkertijd worden gebruikt:

{
  "info_types": ["*"],
  "data_types": ["ios_phone.calls"]
}

Maak POST /polls

Maak een peiling voor gegevens tegen een specifieke sessie.

Als een sessie bron is al direct gekoppeld aan een specifieke bron, hoeft u niet naar het verstrekken source parameter. Het kan echter worden opgegeven om aan te geven dat de poll een onderliggende bron is van de primaire bron waaraan de sessie is gekoppeld. Op de iCloud-service kan een sessie bijvoorbeeld alleen worden gemaakt tegen iCloud-accountbronnen (de primaire bron van de iCloud-service), maar u kunt alleen gegevens targeten vanuit een specifieke iCloud-back-up (een onderliggende bron van het iCloud-account) door ID KAART.

CURL gebruiken

curl https://ricloud-api.reincubate.com/polls \
  -X POST \
  -H 'Authorization: Token <your key_token>' \
  -H 'Content-Type: application/json' \
  -d '{
  "session": "<session ID>",
  "payload": {
    "info_types": ["*"]
  }
}'

Ricloud-py gebruiken

import ricloud

poll_payload = {
  'info_types': ['*'],
}

poll = ricloud.Poll.create(
  session='<session ID or ricloud.Session instance>',
  payload=poll_payload,
)

Ophalen GET /polls/{poll ID}

CURL gebruiken

curl https://ricloud-api.reincubate.com/polls/<poll ID> \
  -H 'Authorization: Token <your key_token>'

Ricloud-py gebruiken

import ricloud

poll = ricloud.Poll.retrieve(<poll ID>)

Lijst GET /polls

CURL gebruiken

curl https://ricloud-api.reincubate.com/polls \
  -H 'Authorization: Token <your key_token>'

Ricloud-py gebruiken

import ricloud

polls = ricloud.Poll.list()