GET (/json/users/xuid({xuid})/scids/{scid}/data/{path})

아티클
05/10/2023

지정된 경로에 파일 정보를 나열합니다. 이 URI의 도메인은 titlestorage.xboxlive.com입니다.

URI 매개 변수
선택적 쿼리 문자열 매개 변수
Authorization
필수 요청 헤더
요청 본문
HTTP 상태 코드
응답 본문

URI 매개 변수

매개 변수	형식	설명
xuid	부호 없는 64비트 정수	요청하는 플레이어의 Xbox 사용자 ID(XUID)입니다.
scid	guid	조회할 서비스 구성의 ID입니다.
경로	문자열	반환할 데이터 항목의 경로입니다. 일치하는 모든 디렉터리와 하위 디렉터리가 반환됩니다. 유효한 문자는 대문자(A-Z), 소문자(a-z), 숫자(0-9), 밑줄(_) 및 슬래시(/)입니다. 비어 있을 수 있습니다. 최대 길이는 256자입니다.

선택적 쿼리 문자열 매개 변수

매개 변수	형식	설명
skipItems	정수	컬렉션에서 N+1부터 시작하는 항목을 반환합니다(예: N개의 항목 건너뛰기).
continuationToken	문자열	특정 연속 토큰에서 시작하는 항목을 반환합니다. 두 매개 변수가 제공되는 경우 continuationToken 매개 변수는 skipItems보다 우선합니다. 즉, continuationToken 매개 변수가 있으면 skipItems 매개 변수가 무시됩니다.
maxItems	정수	컬렉션에서 반환할 최대 항목 수이며 skipItems 및 continuationToken과 결합하여 항목 범위를 반환할 수 있습니다. maxItems가 없으면 서비스가 기본값을 제공할 수 있으며 결과의 마지막 페이지가 아직 반환되지 않은 경우에도 maxItems보다 작은 값을 반환할 수 있습니다.

Authorization

요청에는 유효한 Xbox LIVE 권한 부여 헤더가 포함되어야 합니다. 호출자가 이 리소스에 액세스할 수 없는 경우 서비스는 403 Forbidden 응답을 반환합니다. 헤더가 유효하지 않거나 누락된 경우 서비스는 401 Unauthorized 응답을 반환합니다.

필수 요청 헤더

헤더	값	설명
x-xbl-contract-version	1	API 계약 버전.
Authorization	XBL3.0 x=[hash];[token]	STS 인증 토큰. STSTokenString은 인증 요청에 의해 반환된 토큰으로 대체됩니다. STS 토큰을 검색하고 권한 부여 헤더를 만드는 방법에 대한 자세한 내용은 Xbox LIVE 서비스 요청 인증 및 권한 부여를 참조하세요.

요청 본문

이 요청의 본문에는 개체가 전송되지 않습니다.

HTTP 상태 코드

서비스는 이 리소스에서 이 메서드를 통해 수행한 요청에 대한 응답으로 이 섹션의 상태 코드 중 하나를 반환합니다. Xbox Live 서비스에서 사용되는 표준 HTTP 상태 코드의 전체 목록은 표준 HTTP 상태 코드를 참조하세요.

코드	이유 구문	설명
200	OK	요청에 성공했습니다.
201	Created	엔터티가 생성되었습니다.
400	Bad Request	서비스가 형식이 잘못된 요청을 이해할 수 없습니다. 일반적으로 잘못된 매개 변수입니다.
401	Unauthorized	요청에 대해 사용자 인증이 필요합니다.
403	Forbidden	사용자 또는 서비스에 대해 요청이 허용되지 않습니다.
404	Not Found	지정된 리소스를 찾을 수 없습니다.
406	Not Acceptable	리소스 버전이 지원되지 않습니다.
408	Request Timeout	요청이 완료되는 데 너무 오래 걸렸습니다.
500	Internal Server Error	서버가 요청을 수행할 수 없는 예기치 않은 조건이 발생했습니다.
503	Service Unavailable	요청이 제한된 경우 클라이언트 재시도 값(초) 이후(예: 5초 후) 다시 요청을 시도합니다.

응답 본문

호출이 성공하면 서비스는 TitleBlob 개체 배열을 반환합니다.

샘플 응답

{
"blobs":
[
    {
        "fileName":"foo\bar\blob.txt,json",
        "clientFileTime":"2012-01-01T01:02:03.1234567Z",
        "displayName":"Friendly Name",
        "size":12,
        "etag":"0x8CEB3E4F8F3A5BF"
    },
    {
        "fileName":"foo\bar\blob2.txt,json",
        "displayName":"Blob 2",
        "size":4,
        "etag":"0x8CEB3FE57F1A142"
    },
    {
        "fileName":"foo\jsonblob.txt,json",
        "size":15,
        "etag":"0x8CEB40152B4A6F8"
    }
],
"pagingInfo":
    {
        "continuationToken":"54",
    }
}

다음을 통해 공유