OAuth API 응답 매개변수

  • 릴리스 버전: Zurich
  • 업데이트 날짜 2025년 07월 31일
  • 소요 시간: 2분
  • OAuth 2.0 API는 다음 매개변수를 name:value 쌍으로 포함하는 JSON 응답을 생성합니다.

    표 1. 접근 토큰 응답 매개변수
    응답 매개변수 설명
    범위 액세스 토큰으로 부여된 액세스 권한의 양입니다. 범위는 항상 useraccount이며, 이는 액세스 토큰이 토큰에 권한을 부여한 사용자 계정과 동일한 권한을 가짐을 의미합니다. 예를 들어 Abel Tuter가 로그인 자격 증명을 제공하여 애플리케이션에 권한을 부여하면 결과 액세스 토큰은 토큰 전달자에게 Abel Tuter와 동일한 액세스 권한을 부여합니다.
    token_type OAuth RFC에 정의된 대로 요청에 의해 발행된 토큰의 유형입니다. 토큰 형식은 항상 전달자이므로 액세스 토큰을 소유한 모든 사용자가 암호화 키를 제공하지 않고도 보호된 리소스에 액세스할 수 있습니다. OAuth 2.0에서 전달자 토큰을 사용하는 방법에 대한 자세한 내용은 RFC6750 참조하십시오.
    expires_in 액세스 토큰의 수명(초)입니다.
    refresh_token 새로 고침 토큰의 문자열 값입니다.
    access_token 액세스 토큰의 문자열 값입니다. 액세스 토큰 만료 시간 내에 수행된 액세스 요청은 항상 현재 액세스 토큰을 반환합니다.
    format [선택사항] 응답의 출력 형식입니다. 이 값은 항상 JSON입니다.
    주:
    OAuth 공급자가 응답 본문을 "Content-Type" 대신 "content-type"으로 보내는 경우 OAuth HTTP 클라이언트가 응답을 올바르게 구문 분석하지 못할 수 있습니다. 이 문제를 해결하려면 다음 매개변수를 사용하여 시스템 속성을 생성합니다.
    필드
    이름 glide.oauth.inhouse.httpclient.enabled
    유형 true|false
    아니오

    시스템 속성 생성에 대한 자세한 내용은 시스템 속성 추가를 참조하십시오.

    다음 예제에서는 액세스 토큰 요청에서 반환되는 JSON 문자열을 보여 줍니다. (가독성을 높이기 위해 공백이 추가되었습니다.)

    
    {"scope":"useraccount","token_type":"Bearer","expires_in":1800,
    "refresh_token":"w599voG89897rGVDmdp12WA681r9E5948c1CJTPi8g4HGc4NWaz62k6k1K0FMxHW40H8yOO3Hoe",
    "access_token":"F0jh9korTyzd9kaZqZ0SzjKZuS3ut0i4P46Lc52m2JYHiLIcqzFAumpyxshU9mMQ13gJHtxD2fy"}