프로토콜

업데이트 됨

비동기 처리

API는 모든 폴에 대해 비동기 처리를 사용합니다. 여기에는 iCloud와 같은 외부 서비스와의 상호 작용이 포함됩니다. 필요한 처리량에 따라 완료하는 데 몇 초 또는 몇 분이 걸릴 수 있기 때문입니다.

여러 표준 자원 상호 작용이 비동기 '부작용'을 유발할 수 있으며 API 참조 문서에 설명되어 있습니다. 일반적으로 유효성 검사 또는 기타 유틸리티 기능을 수행합니다.

API의 비동기 적 기반은 API 내에서 트리거되는 주기적 폴링에 대한 인터페이스를 단순화하는 데에도 도움이됩니다. 즉, 이벤트 및 결과 검색은 API와 직접 상호 작용하거나 예정된 설문 조사를 통해 이루어지는 것과 동일합니다.

응답을 기다리고있다.

API는 폴링 필요성을 최소화하고 최종 사용자의 총 응답 시간을 줄이기 위해 오래 지속되는 요청을 통해 비동기 작업 완료를 기다리는 것을 지원합니다. 이 기능을 사용하려면 원하는 시간 초과 값을 사용하여 Ricloud-Await HTTP 헤더를 요청에 추가하십시오. 현재 최대 시간 초과 값은 10 초입니다.

Ricloud-Await: 3

이 기능은 다음 엔드 포인트에서 지원됩니다.

암호화 된 게시

API에서 게시 한 모든 결과는 조직 전체의 공용 RSA 키를 사용하여 암호화 할 수 있습니다.

속성 유형

datetime 속성은 항상 ISO8601 사양에 따라 형식이 지정됩니다. API는 UTC 시간대가있는 모든 datetime 특성을 반환합니다. 따라서 예상되는 형식은 "2018-08-22T10:25:05Z" 입니다.

쪽수 매기기

API는 커서 기반 페이지 매김을 사용합니다. 모든 목록 유형 호출은 추가 매개 변수를 사용합니다.

  • limit 반환 할 최대 항목 수를 지정합니다. 기본값은 10이며, 최대 값은 1000입니다.
  • after_id 목록을 시작할 ID를 지정합니다.
  • before_id 목록을 중지 할 자원 ID를 지정합니다.

리스트 응답은 data 속성 아래에 리턴 된 자원을 포함합니다. 또한 제한으로 인해 포함되지 않은 더 많은 자원을 나열 할 수 있는지 여부를 나타내는 helper 속성 has_more 도 포함됩니다.

속도 제한

API에 대한 요청은 표준 속도 제한이나 기내 요청 제한에 의해 제한 될 수 있습니다. 전자는 대규모 API 리소스의 남용을 최소화하는 데 사용되는 반면, 후자는 개별 리소스 인스턴스를 보호하는 데 사용됩니다.

요율 제한의 예 : 단일 조직에서 API에 대한 요청 수는 시간당 10,000 요청으로 제한됩니다. 이는 트래픽의 악의적 인 또는 우발적 인 스파이크로부터 보호하는 데 도움이됩니다.

기내 제한 예제 : 다른 작업이 이미 처리중인 경우 원본 리소스의 인스턴스에 대해 생성 된 작업을 가질 수 없습니다. 이는 세션 무결성을 유지하고 외부 서비스로의 트래픽을 최소화하며

버전 관리

API의 주요 릴리스가 크게 의미있는 버전 관리 체계 (예 : v1 , v2 , v3 )를 따르지 만 v3 버전의 API에서 변경된 사항은 달력 버전 관리 체계 (예 : 2018-11-06 )에 따라 버전이 지정됩니다. 이 버전은 조직에 대해 전 세계적으로 설정하거나 Ricloud-Version 헤더를 통해 요청별로 지정할 수 있습니다.

삭제 가능한 리소스

대부분의 리소스는 삭제할 수 없으므로 소유 조직에서만 비활성화하거나 API 관리자가 차단할 수 있습니다.

어떻게 도와 드릴까요?

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

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

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

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

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