열쇠

키는 token
속성을 통해 조직 수준의 API에 대한 액세스를 제공합니다. 조직을 대신하여 모든 API 엔드 포인트와 상호 작용할 수 있습니다.
새로 생성 된 조직마다 키가 생성됩니다.
속성
이름 | 유형 | 기술 |
---|---|---|
id | 키 ID | 자원 식별자. |
resource | 문자열, 항상 key | 자원 유형 지정자. |
organisation | 조직 ID | 이 키가 속한 조직입니다. |
type | 끈 | standard , trial 중 하나입니다. |
storage_config | 선택적, 스토리지 구성 ID | 키가 사용하는 저장소 구성입니다. |
webhook_config | 선택적, webhook 구성 ID | 키가 사용하는 webhook 구성입니다. |
token | 끈 | 이 키에 대한 승인 자료입니다. API에 대한 요청에서 AUTHORIZATION HTTP 헤더를 채우는 데 사용됩니다. |
state | 끈 | 다음 중 하나가 active , deactivated , blocked , expired . |
date_created | 날짜 시간 | 리소스가 생성 된 시점. |
date_expires | 선택적, datetime | 열쇠가 만료 될 때. 주로 trial 유형 키에 적용됩니다. |
유형
-
standard
- 열쇠 형. 모든 조직에는 이들 중 적어도 하나가 있습니다.
-
trial
- API 관리자가 조직에 추가 권한에 대한 액세스 권한을 부여 할 수 있도록 생성 한 키입니다. 일반적으로
date_expires
필드가 설정됩니다.
저장소 및 Webhook 구성
주요 리소스는 스토리지 및 Webhook 구성의 조직 기본값을 무시할 수 있습니다. 이는 dev 및 production과 같은 환경간에 결과 및 이벤트 알림을 분리하는 데 유용 할 수 있습니다.
토큰
키의 token
속성 값은 소유 조직을 대신하여 API에 대해 인증하는 데 사용될 수 있습니다.
이 값은 안전하게 저장해야하며 공개적으로 노출되지 않아야합니다.
상태
-
active
- 열쇠의 표준 상태
-
deactivated
- 소유하는 조직이 키를 사용 중지했습니다.
-
blocked
- 키가 API 관리자에 의해 사용 중지되었습니다.
-
expired
- 시용 기간이 지나면 키가 비활성화됩니다.
POST /keys
만들기
매개 변수
이름 | 유형 | 기술 |
---|---|---|
storage_config | 스토리지 구성 ID | 이 키에서 조직의 기본 저장소 구성을 재정의하십시오. |
webhook_config | webhook 구성 ID | 이 키에서 조직의 기본 webhook 구성을 덮어 씁니다. |
cURL 사용
curl 'https://ricloud-api.reincubate.com/keys' \ -X POST \ -H 'Authorization: Token <your key_token>' \ -H 'Content-Type: application/json' \ -d '{ "storage_config": 2, }'
ricloud-py 사용하기
import ricloud key = ricloud.Key.create(storage_config=2) # OR storage_config = ricloud.StorageConfig.retrieve(2) key = ricloud.Key.create(storage_config=storage_config)
가져 GET /keys/{key ID}
cURL 사용
curl 'https://ricloud-api.reincubate.com/keys/<key ID>' \ -H 'Authorization: Token <your key_token>'
ricloud-py 사용하기
import ricloud key = ricloud.Key.retrieve(<key ID>)
GET /keys
나열
매개 변수
이름 | 유형 | 기술 |
---|---|---|
type | 끈 | 키를 유형별로 필터링하십시오. |
state | 끈 | 키를 해당 상태로 필터링합니다. |
cURL 사용
curl 'https://ricloud-api.reincubate.com/keys?limit=2' \ -H 'Authorization: Token <your key_token>'
ricloud-py 사용하기
import ricloud keys = ricloud.Key.list(limit=2)
POST /keys/{key ID}
업데이트
매개 변수
이름 | 유형 | 기술 |
---|---|---|
storage_config | 스토리지 구성 ID | 키가 사용하는 스토리지 구성을 업데이트하십시오. null 가 조직의 디폴트에 돌아갈 경우 |
webhook_config | webhook 구성 ID | 키가 사용하는 webhook 구성을 업데이트하십시오. null 가 조직의 디폴트에 돌아갈 경우 |
cURL 사용
curl 'https://ricloud-api.reincubate.com/keys/<key ID>' \ -X POST \ -H 'Authorization: Token <your key_token>' \ -H 'Content-Type: application/json' \ -d '{ "webhook_config": 2 }'
ricloud-py 사용하기
import ricloud key = ricloud.Key.update_with_id(<key ID>, webhook_config=2) # OR key = ricloud.Key.retrieve(<key ID>) key.update(webhook_config=2)
회전 POST /keys/{key ID}/rotate
키의 token
값을 회전합니다. 필수 사항은 아니지만 키의 token
이 손상되었다고 의심되는 경우 즉시 또는 정기적으로 수행하는 것이 좋습니다.
매개 변수
이름 | 유형 | 기술 |
---|---|---|
force | bool, 기본값 : False | 현재의 token 값이 즉시 인증 해제되어야하는 경우. 그렇지 않은 경우 통화가 이루어진 후 6 시간 후에 현재 회전주기가됩니다. |
cURL 사용
curl 'https://ricloud-api.reincubate.com/keys/<key ID>/rotate' \ -X POST \ -H 'Authorization: Token <your key_token>'
ricloud-py 사용하기
import ricloud key = ricloud.Key.rotate_with_id(<key ID>) # OR key = ricloud.Key.retrieve(<key ID>) key.rotate()