투표소

폴링 자원은 데이터에 대한 특정 요청에 대한 정보를 포함합니다. 설문 조사가 만들어지면 요청을 완료하기 위해 하나 이상의 작업 생성이 시작됩니다.

속성

할 일 목록

폴링 리소스의 가장 중요한 역할은 관련 작업의 진행률을 반영하고 최종 사용자가 결과가 나 오자마자 결과를 가져 오는 것을 허용하는 것입니다. 따라서 폴 자원은 관련 태스크가 해당 상태에 따라 분류되는 태스크 관련 속성을 노출합니다.

결과

설문 조사 내에서 실행중인 태스크가 공개 한 모든 결과는 설문 조사의 results 속성에 표시됩니다.

주

설문 조사 상태는 설문 조사가 초기화 pending ( pending ), 진행 중 ( processing ) 또는 모든 작업 완료 ( completed pending )인지 여부 만 반영합니다.

설문 조사는 관련 작업을 통한 오류 상태 이외의 오류 상태를 반영하지 않습니다.

유효 탑재량

폴링 페이로드는 검색해야하는 정보 유형, 데이터 유형 및 파일 유형을 나타냅니다. 폴 페이로드 속성 스키마는 아래에 설명되어 있습니다.

예를 들어, iCloud 계정 소스에서 모든 유형의 정보를 검색하기위한 폴 페이로드는 다음과 같습니다.

{
  "info_types": ["*"]
}

iCloud 백업 또는 Reincubate Relay 소스에서 특정 날짜에서만 다양한 메시징 데이터를 검색하려면 다음을 수행하십시오.

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

iCloud 사진 보관함 결과에서 참조 된 이미지의 파일 데이터를 검색하려면 :

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

다른 속성을 동시에 사용할 수도 있습니다.

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

POST /polls 만들기 만들기

특정 세션에 대한 데이터 폴링을 작성하십시오.

세션 리소스가 이미 특정 소스에 직접 연결되어 있으므로 source 매개 변수를 제공 할 필요가 없습니다. 그러나 폴링이 세션이 연결된 기본 소스의 하위 소스를 대상으로 지정하도록 제공 할 수 있습니다. 예를 들어, iCloud 서비스에서 세션은 iCloud 계정 소스 (iCloud 서비스의 기본 소스)에 대해서만 생성 될 수 있지만, 특정 iCloud 백업 (iCloud 계정의 하위 소스)에서만 데이터를 대상으로 지정할 수 있습니다. 신분증.

cURL 사용

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 사용하기

import ricloud

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

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

GET /polls/{poll ID}

cURL 사용

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

ricloud-py 사용하기

import ricloud

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

GET /polls 나열

cURL 사용

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

ricloud-py 사용하기

import ricloud

polls = ricloud.Poll.list()