출처

소스는 서비스의 데이터 소스를 나타냅니다. 예를 들어, iCloud 계정은 iCloud 서비스의 소스입니다.

소스에는 개별적으로 타겟팅 할 수있는 여러 rirelay.source 소스가있는 rirelay.instance 소스와 같은 하위 소스가있을 수 있습니다.

속성

종류

현재 지원되는 유형은 다음과 같습니다.

• icloud.account , iCloud 서비스의 기본 소스.
• rirelay.instance rirelay 서비스의 기본 소스입니다. Reincubate Relay 응용 프로그램의 인스턴스에 해당합니다.
• rirelay.source 의 하위 소스 인 rirelay.instance 상위 Reincubate Relay 앱이 액세스 할 수있는 장치에 해당합니다.

식별자

소스의 identifier 속성 값은 해당 서비스 내에서 고유하게 식별됩니다. iCloud 계정의 경우 이는 사용자 이름입니다. Reincubate Relay 앱 인스턴스의 경우 인스턴스 ID가됩니다.

부모의

소스가 자식 소스 인 경우이 필드는 부모 소스 객체를 가리 킵니다. 이 계층 구조의 최상위 소스를 1 차 소스라고합니다.

하위 소스는 API를 통해 직접 작성할 수 없지만 적절한 폴이 작성되면 API에 의해 자동으로 작성됩니다.

상태

unvalidated

세션이이 소스에 대해 성공적으로 생성 된 적이 없으므로 API가 유효한 소스인지 여부를 알 수 없습니다.

active

소스가 유효하고 사용 준비가되었습니다.

deactivated

소스에 대한 액세스가 소유 조직에 의해 금지되었습니다.

blocked

소스에 대한 액세스가 API 관리자에 의해 금지되었습니다.

locked

소스에 대한 액세스가 외부 서비스에 의해 일시적으로 제한되었습니다.

가져 GET /sources/{source ID}

cURL 사용

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

ricloud-py 사용하기

import ricloud

source = ricloud.Source.create(<source ID>)

샘플 응답

{
  "id": 1,
  "resource": "source",
  "user": 1,
  "type": "mocks.mock",
  "identifier": "john.appleseed@reincubate.com",
  "info": null,
  "parent": null,
  "children": {
      "data": [],
      "has_more": false,
      "total_count": 0,
      "url": "/sources/1/children"
  },
  "state": "active",
  "date_created": "2020-02-20T11:59:03.195527Z"
}

GET /sources 나열

cURL 사용

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

ricloud-py 사용하기

import ricloud

sources = ricloud.Source.list()

POST /sources/{source ID} 업데이트

cURL 사용

curl https://ricloud-api.reincubate.com/sources/<source ID> \
  -X POST \
  -H 'Authorization: Token <your key_token>' \
  -H 'Content-Type: application/json' \
  -d '{
  "state": "deactivated"
}'

ricloud-py 사용하기

import ricloud

source = ricloud.Source.update_with_id(<source ID>, state='deactivated')

# OR

source = ricloud.Source.retrieve(<source ID>)

source.update(state='deactivated')

변경 로그

2020-02-20

• 전공의 children 소스 객체의 속성은 오히려 단순 목록 속성보다, 지금 중첩 된 목록 객체입니다.

2019-10-16

• rirelay.instance 및 rirelay.source 두 가지 새로운 소스 유형을 추가합니다.