구독
구독 개체는 "24 시간마다 새 CallKit 호출 검색"또는 "새 백업이 생성 될 때 Reincubate Relay 소스에서 최신 iOS 메시지 검색"과 같은 데이터에 대한 지속적인 요청을 나타냅니다.
다른 서비스는 약간 다른 방식으로 구독을 구현할 수 있습니다. iCloud 서비스는 정기적 인 폴링 메커니즘에서 작동하여 설정된 시간 간격마다 새 데이터를 확인합니다. rirelay 서비스는 푸시 메커니즘에서 작동하여 새로운 데이터가 제공되는 즉시 게시합니다.
속성
| 이름 | 유형 | 기술 |
|---|---|---|
id | 끈 | 자원 식별자. |
resource | 문자열, 항상 subscription | 자원 유형 식별자. |
org | 조직 ID | 구독 관련 조직. |
source | 소스 ID | |
session | 세션 ID | |
poll_payload | 중첩 된 폴 페이로드 | 구독에서 생성 할 폴의 페이로드입니다. 설문 조사 페이로드를 참조하십시오. |
interval | 선택적 타임 델타 | 폴링 간격 (초)입니다. |
date_start | 선택적 날짜 / 시간 | 설문 조사 작성을 시작하는 날짜입니다. |
date_end | 선택적 날짜 / 시간 | 설문 조사 작성을 중지 할 날짜입니다. |
state | 끈 | 다음 중 하나입니다 : pending , active , deleted . |
date_created | 날짜 시간 | 리소스가 생성 된 시점. |
간격
interval 속성은 API가 소스에서 새 데이터를 가져 오거나 요청하는 빈도를 제어합니다.
풀 기반 인 아이 클라우드 서비스에 가입 새로운 여론 조사마다 생성됩니다 interval 초.
Reincubate Relay 서비스에서 interval 속성이 대신 Relay 앱으로 전달됩니다. 앱이 연결된 장치에서 새 데이터를 요청하는 빈도를 구성한 다음 푸시 메커니즘을 통해 API에서 폴링을 트리거합니다. 구독 소스와 연결된 장치가 릴레이 앱에 연결될 때까지 폴링이 생성되지 않습니다.
POST /subscriptions 생성
| 이름 | 유형 | 기술 |
|---|---|---|
session | 세션 ID | 설문 조사를 생성 할 세션 |
source | 선택적 소스 ID | 선택적으로 세션 링크 소스의 하위 소스를 대상으로합니다. |
poll_payload | 중첩 된 폴 페이로드 | 설문 조사를 지정하는 데 사용되는 설문 조사 페이로드 |
interval | 선택적 타임 델타 | 폴링 간격 (초)입니다. |
date_start | 선택적 날짜 / 시간 | 설문 조사 작성을 시작하는 날짜입니다. |
date_end | 선택적 날짜 / 시간 | 설문 조사 작성을 중지 할 날짜입니다. |
cURL 사용
curl https://ricloud-api.reincubate.com/subscriptions \ -X POST \ -H 'Authorization: Token <your key_token>' \ -H 'Content-Type: application/json' \ -d '{ "session": "<session ID>", "source": "<source ID>", "poll_payload": { "data_types": ["ios_messages.messages", "whatsapp.messages"] } }'
ricloud-py 사용하기
import ricloud poll_payload = { "data_types": ["ios_messages.messages", "whatsapp.messages"], } subscription = ricloud.Subscription.create( session="<session ID or ricloud.Session instance>", source="<source ID or ricloud.Source instance>", poll_payload=poll_payload, )
GET /subscriptions/{subscription ID}
cURL 사용
curl https://ricloud-api.reincubate.com/subscriptions/<subscription ID> \ -H 'Authorization: Token <your key_token>'
ricloud-py 사용하기
import ricloud subscription = ricloud.Subscription.retrieve(<subscription ID>)
GET /subscriptions 목록
cURL 사용
curl https://ricloud-api.reincubate.com/subscriptions \ -H 'Authorization: Token <your key_token>'
ricloud-py 사용하기
import ricloud subscriptions = ricloud.Subscription.list()
POST /subscriptions/{subscription ID} 업데이트
구독을 작성하여 설문 조사를 작성하고 설문 조사를 작성하는시기를 변경하도록 업데이트 할 수 있습니다.
또한 가입 세션이 만료 된 경우 새로 생성 된 활성 세션으로 교체 할 수 있습니다.
| 이름 | 유형 | 기술 |
|---|---|---|
session | 세션 ID | 설문 조사를 생성 할 세션 구독의 원래 세션과 동일한 기본 소스가 있어야합니다. |
poll_payload | 중첩 된 폴 페이로드 | 설문을 지정하는 데 사용되는 설문 페이로드입니다. |
interval | 선택적 타임 델타 | 폴링 간격 (초)입니다. |
date_start | 선택적 날짜 / 시간 | 설문 조사 작성을 시작하는 날짜입니다. |
date_end | 선택적 날짜 / 시간 | 설문 조사 작성을 중지 할 날짜입니다. |
cURL 사용
curl https://ricloud-api.reincubate.com/subscriptions/<subscription ID> \ -X POST \ -H 'Authorization: Token <your key_token>' \ -H 'Content-Type: application/json' \ -d '{ "session": "<session ID>", "poll_payload": { "data_types": ["icpl.photos"] } }'
ricloud-py 사용하기
import ricloud poll_payload = { "data_types": ["icpl.photos"], } subscription = ricloud.Subscription.update( session="<session ID or ricloud.Session instance>", poll_payload=poll_payload, )
DELETE /subscriptions/{subscription ID} 삭제
추가 폴링 작성 구독을 중지하십시오.
cURL 사용
curl https://ricloud-api.reincubate.com/subscriptions/<subscription ID> \ -X DELETE \ -H 'Authorization: Token <your key_token>'
ricloud-py 사용하기
import ricloud subscription = ricloud.Subscription.delete_with_id(<subscription ID>) # OR subscription = ricloud.Subscription.retrieve(<subscription ID>) subscription.delete()