개요 (v2)

업데이트 됨

소개

ricloud API와 상호 작용하는 데 사용되는 네 가지 서비스는 asmaster , asapi , aschannelasstore 입니다. 클라이언트는 일반적으로 네 가지가 아닌 두 가지 서비스와 상호 작용합니다.

API는 asmaster 또는 asapi 의 두 가지 방법 중 하나로 제어 할 수 있습니다. 결과는 aschannel (실시간 데이터 검색을위한 Firehose 스트림) 또는 asstore (데이터의 일괄 검색을위한 버킷)에서 수신됩니다.

구성 요소 결과 전달 에 가장 적합 토큰 관리
손자 aschannel 데이터의 정기적 인 검색 재배치
아사히 aschannel 또는 asstore 가끔씩 발생하는 소량 액세스 고객에게 연기 됨

실시간 데이터 액세스

asmaster를 사용하면 고객이 관심 계정이나 장치를 등록한 다음 스트림 에서 새로운 데이터를 사용할 수있게되면 실시간으로 수신합니다. asmaster 효과적으로 ASAPI에 대한 자신의 구현 후 클라이언트가 할 수 안전하게 추가 데이터 저장 및 검색의 역학을 이해하는 고객의 필요를 줄이고,보다 신속하게 데이터를 제공 할 수있는 및 ASAPI위한 스마트 컨트롤러입니다.

기본 데이터 유형 및 소스에 따라 asmaster 는 실시간 업데이트를 위해 업스트림 데이터 피드에 내부적으로 가입하거나 스마트 예측 스케줄러를 사용하여 폴링을 관리합니다.

가까운 시간 및 배치 데이터 액세스

asapi를 사용하면 클라이언트는 계정이나 장치에서 원하는 데이터를 요청한 다음 스트림에서 준비가되었거나 버킷 을 폴링하여 데이터를 수신합니다.

개념 및 서비스

ricloud API는 액션 , 태스크 , 서비스계정의 네 가지 주요 개념을 모델로 합니다 .

액션 은 API에 의해 수행되는 작업의 기본 단위입니다. 각 작업서비스 와 연결됩니다. 예를 들어 icloud 서비스의 일부인 fetch_data 액션을 수행 할 수 있습니다 . 모든 작업계정 에 대해 수행 됩니다 . 계정은 검색되는 서비스 데이터에 대한 최종 사용자 계정을 나타냅니다. 해당 클라이언트가 등록한 계정 은 클라이언트가 액세스 할 수 있습니다. 작업의 각 인스턴스는 작업으로 설명하고, 할당 task_id .

앱 스트림 마스터 ( asmaster )

asmaster 는 API에 대한 가입 제어 메커니즘입니다. 사용자는 다음을 수행 할 수 있습니다.

  • 사용 권한이 부여 된 서비스 , 동작 및 끝점을 찾습니다.
  • 계정 등록, 등록 취소 및 계정 알아보기
  • 계정 의 자동 데이터 피드 구독 신청 및 탈퇴

이 방식으로 자동 asmaster ASAPI위한 작업aschannel로부터 얻어지는 결과 데이터를 생성한다.

asmaster 에 대한 자세한 문서는 asmaster 를 사용하여 데이터구독 할 때 사용할 수 있습니다.

앱 스트림 API ( asapi )

asapi 는 API에 대한 비동기 제어 메커니즘입니다. 사용자는 다음을 수행 할 수 있습니다.

  • 사용 권한이 부여 된 서비스 , 동작 및 끝점을 찾습니다.
  • 계정 등록, 등록 취소 및 계정 알아보기
  • 비동기 작업 제출
  • 작업 상태 쿼리

완료되면 클라이언트의 유스 케이스에 따라 작업의 데이터를 aschannel 또는 asstore 에서 가져올 수 있습니다.

asapi 에 대한 자세한 문서는 asapi데이터요청할 때 사용할 수 있습니다.

애플리케이션 스트림 채널 (aschannel)

aschannel 은 스트리밍 엔드 포인트로서, 클라이언트는 제출 된 각 작업의 결과를 실시간으로 검색 할 수 있습니다.

결과는 aschannel 엔드 포인트에 대한 연결을 열어 검색합니다.

  • 결과는 JSON 형식으로 스트리밍 됩니다.
  • 이용 가능 해지면 서비스 에서 검색 할 수 있습니다.
  • 채널은 stateless입니다. 클라이언트가 결과 전송을 놓친 경우 작업 다시 제출 없이는 재생할 수 없습니다.

aschannel 에 대한 자세한 문서는 aschannel 과 함께 스트리밍 데이터 에서 사용할 수 있습니다.

앱 스트림 저장소 ( asstore )

asstore 는 클라이언트가 제출 된 작업의 결과를 사용할 수있을 때 검색 할 수있는 시간 제한 결과 저장소입니다.

  • 결과가 만료되고 삭제되기 전에 제한된 기간 동안 저장됩니다.
  • 결과는 한 번만 다운로드 할 수 있습니다. 일단 소비되면 삭제됩니다.

asstore 에 대한 자세한 문서는 asstore데이터다운로드 할 때 사용할 수 있습니다.

사용 된 표준

ricloud 및 그 문서 전반에 걸쳐 다음 표준이 사용됩니다.

  • API는 UTC 시간대로 ISO-8601 형식의 날짜를 일관되게 사용합니다. 예를 들어, 12 월 24 일은 2014-12-24 17:30:00.000000 됩니다.
  • ricloud 의 구성 요소가 반환하는 구조화 된 데이터는 항상 JSON을 사용합니다. 이것은 응답의 application/json content-type에 의해 항상 표시됩니다.
  • 이 문서의 명령 예제는 curl 명령을 사용하여 bash 형식으로 제공됩니다.

어떻게 도와 드릴까요?

지원 팀이 도와 드리겠습니다!

근무 시간은 월요일부터 금요일, 오전 9 시부 터 오후 5시 (그리니치 표준시)입니다. 시간은 현재 2:15 오전 GMT입니다.

우리는 1 일 이내에 모든 메시지에 답장하고자합니다.

지원 섹션으로 이동 › 엔터프라이즈 팀에 문의하십시오. ›
우리의 멋진 지원 팀

© 2008 - 2019 Reincubate Ltd. 판권 소유. 영국과 웨일즈에 등록 #5189175, VAT GB151788978. Reincubate®는 등록 상표입니다. 개인 정보 및 이용 약관. 우리는 2FA를 권장합니다. 런던에서 Built로 지어졌습니다.