세션 수

업데이트 됨

세션 객체는 특정 소스에 대한 액세스를 나타냅니다.

API가 대상 소스 서비스로 액세스를 확인할 수있을 때까지 세션은 항상 보류 상태로 작성됩니다.

대상 소스의 서비스가 액세스를 취소하면 세션이 만료 된 상태로 전환됩니다.

세션을 클라이언트가 업데이트 할 수 없습니다.

속성

이름 유형 기술
id 자원 식별자.
resource 문자열, 항상 session 자원 유형 식별자.
organisation 조직 ID 세션이 연결된 조직.
key 키 ID 이 자원과 관련된 키입니다.
user 사용자 아이디 세션이 연결된 사용자입니다.
source 중첩 소스 세션이 연결된 소스 인스턴스입니다.
state 다음 중 하나입니다 : pending , active , failed , expired .
error 세션이 만료 된 이유를 나타내는 코드입니다.
date_created 날짜 시간 리소스가 생성 된 시점.
date_expired 날짜 시간 자원이 만료 된시기

pending
세션이 아직 초기화되지 않았습니다.
active
세션을 사용하여 작업을 제출할 준비가되었습니다.
failed
세션 초기화에 실패했습니다.
expired
세션이 무효화되었습니다.

오류

세션에는 초기화 오류와 만료 오류의 두 가지 유형의 오류가있을 수 있습니다.

세션 초기화 오류는 일반적으로 사용자 이름이나 암호가 잘못되었거나 2FA 인증이 필요하거나 다른 이유로 일부 서비스가 소스에 액세스하지 못하기 때문에 발생합니다. 이러한 오류에는 init_failed 오류 유형이 있습니다.

대부분의 세션은 결국 만료됩니다. 더 많은 세션 수명 정보는 서비스 별 문서에서 찾을 수 있습니다. 그러나 세션 만료에 대한 다양한 트리거가 있습니다.

service
타사 서비스가 세션을 무효화했습니다. 이는 대개 타사 서비스의 세션 시간 초과로 인한 것입니다 (즉 세션은 24 시간 만 지속될 수 있음). 그러나 소스의 소유자가 자격 증명을 변경하면 기존 세션이 무효화되거나 침입자 검색 시스템과 같은 서비스의 보안 기능에 의해 트리거 될 수 있기 때문에 이로 인해 발생할 수 있습니다.
api
API는 비활성 세션을 주기적으로 무효화합니다.
organisation
조직은 아마도 최종 사용자를 대신하여 세션을 무효화했습니다.
admin
API 관리자가 세션을 무효화했습니다.

POST /sessions 만들기

매개 변수

이름 유형 기술
source 필수 이 세션의 소스가 연결됩니다. 내용은 소스 생성 스키마를 따라야합니다.
payload 필수 세션 초기화 페이로드입니다. 필요한 내용은 소스가 속한 서비스에 따라 다 (니다.

cURL 사용

curl https://ricloud-api.reincubate.com/sessions \
  -X POST \
  -H 'Authorization: Token <your key_token>' \
  -H 'Content-Type: application/json' \
  -d '{
    "source": {
      "user": 1,
      "type": "icloud.account",
      "identifier": "john.appleseed@reincubate.com"
    },
    "payload": {
      "password": "1234"
    }
}'

ricloud-py 사용하기

import ricloud

source = {
  'user': 1,
  'type': 'icloud.account',
  'identifier': 'john.appleseed@reincubate.com',
}

payload = {
  'password': '1234',
}

session = ricloud.Session.create(source=source, payload=payload)

GET /sessions/{session ID}

cURL 사용

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

ricloud-py 사용하기

import ricloud

session = ricloud.Session.retrieve(<session ID>)

명부

GET /sessions

이름 유형 기술
key 키 ID 필터 키 ID로 필터링하십시오.
user 사용자 ID 필터 사용자 ID별로 필터링하십시오.
source 소스 ID 필터 소스 ID별로 필터링하십시오.
state 문자열 필터 세션 상태별로 필터링하십시오.
date_created 날짜 시간 필터 세션이 생성되었을 때 필터링.
date_expired 날짜 시간 필터 세션이 만료되었을 때 필터링

cURL 사용

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

ricloud-py 사용하기

import ricloud

sessions = ricloud.Session.list()

삭제 DELETE /sessions/{session ID}

이 상호 작용은 세션을 만료시키고 API에서 캐시 된 모든 데이터를 삭제합니다. 실제 세션 리소스 인스턴스는 레코드에 대해 유지됩니다.

cURL 사용

curl https://ricloud-api.reincubate.com/sessions/<session ID> \
  -X DELETE \
  -H 'Authorization: Token <your key_token>'

ricloud-py 사용하기

import ricloud

session = ricloud.Session.delete_with_id(<session ID>)

# OR

session = ricloud.Session.retrieve(<session ID>)

session.delete()

어떻게 도와 드릴까요?

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

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

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

우리의 멋진 지원 팀

© 2008 - 2024 Reincubate Ltd. 판권 소유. 영국과 웨일즈에 등록 #5189175, VAT GB151788978. Reincubate® 및 Camo®는 등록 상표입니다. 개인 정보 정책 & 자귀.