모범 사례 (v2)

업데이트 됨

일반

Reincubate Cloud Data API를 최대한 활용하는 데 유용한 여러 가지 우수 사례가 있습니다.

  • 이 문서를 사용하십시오. 이 자료에서 자주 묻는 질문에 대한 답변을 많이 제공하며 문서는 정기적으로 업데이트됩니다.
  • API 상태 페이지 를 사용하여 계획된 또는 비상 API 유지 관리에 대한 업데이트를 신청할 수 있습니다.
  • 슬랙 통합 채널을 이용하는 클라이언트는 더 빨리 라이브로 이동하는 경향이 있습니다.
  • 오픈 소스 클라이언트ricloud 서비스와의 통합에 대한 완전한 예제를 제공하고 통합 과정에서 많은 작업을 줄일 수 있습니다.
  • 테스트 및 통합시 모의 (mock) 데이터를 활용할 수 있지만 실제 데이터 액세스가 느려질 수 있음을 명심하십시오.
  • 보안 및 개인 정보 보호 모범 사례를 따르고 최종 사용자 자격 증명을 저장하지 마십시오. 대신, 토큰 화 시스템을 사용하십시오.
  • 요청에서 태스크 제출 또는 결과 엔드 포인트를 하드 코딩하지 마십시오. 종종 동일한 값을 사용하지만 API는 때때로 다를 수 있습니다.
  • 필요한 것보다 많은 작업을 생성하지 마십시오. 예를 들어, 백업 업데이트를위한 폴링은 하루에 몇 번 이상 불필요하며 이에 대한 정확한 일정을 수립하기 위해 많은 작업을 수행 할 수 있습니다. API는 많은 작업을 완료하는 시간의 작은 양으로 많은 양의 데이터를 생성 할 수 있고, aschannel를 사용하는 경우, 특히, 클라이언트는 소비 용이하게 할 수있는 것보다 많은 요청을주의해야한다.
  • Reincubate는 계좌에 처음 액세스 할 때 계정 소유자와 직접 연락 한 다음 지속적으로 고객 활동에 대한 정보를 제공하는 것이 가장 좋은 방법이라고 생각합니다. 자세한 내용은 개인 정보 보호 강화 를 참조하십시오.
  • 계정을 정기적으로 폴링해야하는 고객은 asapi 가 아닌 asmaster를 평가해야합니다.

🚨 지원 및 서비스 상태

서비스 상태 및 유지 보수 통지

Reincubate는 status.reincubate.com에 상태 페이지를 유지 보수합니다. 상태 페이지를 통해 사용자는 업데이트를 구독 할 수 있습니다. 계획된 또는 비상 유지 보수를 위해 업데이트가 전송됩니다.

직접 지원

고객 지원은 entsupport@reincubate.com 및 사설 Slack 통합 채널을 통해 전자 메일로 제공됩니다. 고객은 지원 팀에 연락하여 통합 채널 설정을 준비 할 수 있습니다.

보고 문제

API에 문제가 발생하면 문제 응답에서받은 X-RI-Build HTTP 헤더를 지원 팀에 알리면 해결 속도가 빨라질 수 있습니다. X-RI-Build HTTP 헤더는 다음과 같습니다.

X-RI-Build: 1.0-pre-ios9-395-g126226b; nj-api-7

문제 보고서를 검토 할 때 지원 엔지니어는 문제의 복제와 서버의 응답을 증명하는 데 사용할 수있는 말풍선 명령을 항상 요구합니다.

i iCloud 계정 잠금 최소화

Apple은 크고 동적 인 기준에 따라 다양한 주파수로 iCloud 계정잠급니다 . 크게 세 가지 범주로 나뉩니다.

  1. 한 조각의 기술이 통신하는 방식
  2. 통신하는 데 사용되는 인프라의 특성
  3. 해당 기술이 통신하는 리듬, 패턴 및 빈도

Reincubate의 Cloud Data API는 진화하면서 모두 세 가지를 처리합니다. 첫 번째는 API의 독점 코드에 의해 처리되고 두 번째는 Reincubate가 유지 관리하는 복잡하고 복잡한 인프라 스택에 의해 처리됩니다. 그러나 asapi로 API를 직접 제어 할 때 클라이언트는 정기적 인 폴링이 필요한 대규모 또는 사용 사례에서 3 번을 관리하기 위해 고심 할 수 있습니다.

asapi가볍게 또는 일회 사용하면 잠금으로 이어지지 않을 수 있지만 제대로 관리하지 않으면 정기적으로 액세스 할 수 있습니다. asmaster 서비스는 클라이언트를 위해이를 관리하도록 설계되었으며 이러한 유스 케이스의 경우 직접 asapi 액세스보다 권장됩니다.

integration 통합 및 테스트를위한 모의 데이터

Apple iCloud 서비스 샘플 데이터

Apple iCloud 서비스 데이터의 풍부한 모의 계정은 john.appleseed@reincubate.com 계정 아래에 제공되며, joshua 암호로 액세스 할 수 있습니다. 데이터는 API와의 통합을 신속하게 테스트하기 위해 제공됩니다.

이 계정에 대한 액세스는 청구 가능하지 않으며 샘플 데이터는 Reincubate 서버에서 직접 제공되므로 응답 시간이 크게 단축됩니다.

자주하는 질문

API가 피드 또는 파일 데이터를 저장합니까?

피드 및 파일 데이터가 클라이언트로 스트리밍되고 RI 스택에서 유지되지 않으므로 aschannel 과 함께 사용할 때가 아닙니다. asstore를 사용할 때 정보는 검색 될 때까지 버킷에 저장됩니다. 그러나 채널은 거의 모든 유스 케이스에 권장됩니다.

경우에 따라 API는 일부 메타 데이터를 보존합니다. 특히 asmaster 의 스케줄러가 메타 데이터의 롤링 창을 유지하여 정확한 폴링 창을 계산하는 데 도움이됩니다.

asmaster를 사용 하여 피드 및 첨부 파일을 요청하려면 어떻게해야합니까?

필요가 없습니다. 일단 계정이나 장치에 가입하면 준비가되면 aschannel 을 통해 데이터가 자동으로 제공됩니다.

asmaster 에게 모듈을 더 많이 또는 적게 줄 것을 어떻게 말합니까?

프로그래밍 방식으로 아무 것도 할 필요가 없습니다. 클라이언트의 주요 구성에는 액세스 권한이있는 모듈의 데이터가 포함되며 데이터를 스트리밍 할 때 모든 모듈이 사용됩니다. 프로비저닝 팀이 클라이언트 키를 업데이트하면 새 모듈 세트가 피드에 반영됩니다.

asmaster 는 어떤 빈도로 투표합니까?

asmaster 의 스케줄러 메커니즘은 주어진 서비스에 대한 최선의 실행 폴링 빈도를 초과하지 않고 최대한 데이터를 제공 할 때 데이터를 제공하는 두 가지 목표에 따라 데이터를 제공합니다. 스케줄러는 항상 새로운 데이터를 가져 오는 것보다 계정에 해를주지 않거나 모범 사례를 위반하지 않도록 우선 순위를 정합니다.

실시간 데이터로 작동 할 때 이것은 실시간, 근 시간 또는 배치 주파수로 데이터가 제공됨을 의미 할 수 있습니다. 배치 데이터를 사용하면 스케줄러 자체가 일괄 처리 모드로 작동합니다.

주파수 선택 뒤에있는 규칙 집합은 동적입니다.

평가판 키에는 어떤 제한이 설정되어 있습니까?

평가판 키 제한은 키의 특성에 따라 달라질 수 있습니다. 그들은 다음에 의해 제한 될 수 있습니다 :

  • 키를 통해 액세스 할 수있는 기기 또는 계정 수
  • 2FA / 2SV가 아닌 계정 지원 (예 : 시험 사용자가 규정 준수를 위해 비 2FA 계정에 액세스하는 것을 방지 할 수 있음)

API는 어디에서 호스팅됩니까?

호스팅 및 연결 에 대한 참고 사항을 참조하십시오.

데이터 유형 xyz에 대한 데이터가 표시되지 않는 이유는 무엇입니까?

ricloud 에서 빈 응답이 표시되고 오류가 아니라면 데이터 소스가 비어 있음을 의미합니다. ricloud 에서 검색 할 수있는 데이터가 있는지 확인하려면 아래 나열된 단계를 수행하십시오.

  1. 데이터 유형에 대한 관련 설정 이 켜져 있는지 확인하십시오.

    • 소스가 iOS 장치 백업 인 데이터 유형의 경우 Settings > [user name] > iCloud > iCloud Backup > iCloud Backup 백업을 켜고 적어도 한 번 이상 장치가 백업되었는지 확인해야합니다. 앞에서 설명한 Back Up Now 버튼을 눌러 수동으로 백업을 트리거 할 수 있습니다.
    • 실시간 및 근시 (near-time) 데이터 유형의 경우, 설정은 iCloud와 데이터를 동기화하는 책임이있는 서비스에보다 특정한 경향이 있습니다. 예를 들어 내 iPhone 찾기와 관련된 설정은 Settings > [user name] > iCloud > Find My iPhone > Find My iPhone 에서 찾을 수 있습니다. 연관된 설정피드 모듈 섹션 의 다른 데이터 유형 등록 정보와 함께 나열됩니다.
  2. 기기가 데이터를 동기화 할 수있는 기회를 확보해야합니다.

    • iCloud 백업 기반 피드의 경우 자동 iCloud 백업을 시작하려면 장치를 플러그인하고 잠글 필요가 있습니다. 언제든지 수동 백업을 실행할 수 있습니다.
    • 실시간 및 근시 시간 데이터 유형의 경우 동기화 트리거는 서비스 설계에 따라 다릅니다. 일반적으로 느린 동기화 프로세스가 실행 되려면 약 4-6 시간이 걸릴 수 있습니다.

천칭

  • 2017 년 1 월 현재, 기존의 ricloud 1.x 는 더 이상 사용되지 않는 것으로 간주 될 수 있지만, 트래픽을 재구성하고 트래픽을 asapi로 라우팅하는 어댑터 덕분에 완전히 지원됩니다.

어떻게 도와 드릴까요?

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

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

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

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

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