다음을 통해 공유

활동 삭제

  • 아티클

특정 타이틀을 플레이하는 사용자의 활동을 삭제합니다.

이 API를 사용하면 게임 클라이언트가 특정 타이틀을 플레이하는 사용자의 활동을 삭제할 수 있습니다. 타이틀은 사용자가 멀티플레이어 활동을 떠나는 즉시 해당 활동을 삭제해야 합니다. 타이틀이 활동을 삭제하지 못하는 경우 사용자의 활동이 존재 확인을 통해 결국 정리될 수 있습니다.

DELETE /titles/{titleId}/users/{xuid}/activities

URI 매개 변수

매개 변수 그런 다음 필수 유형 설명
titleId path TRUE 정수 요청이 전송되는 게임의 titleId입니다.
xuid path TRUE 문자열 현재 요청에서 참조되는 사용자의 XUID입니다. XUID는 밑이 10인 정수로 표시됩니다.

요청 헤더

이름 필수 유형 설명
Authorization TRUE 정수 호출자는 XBL 3.0 인증 형식으로 XToken을 제공해야 합니다. 예를 들어 권한 부여: XBL3.0 x=2553948354698;>암호화된 토큰<)
콘텐츠 종류 TRUE 문자열 ContentType을 application/json으로 설정해야 합니다.

요청 본문

이름 필수 유형 설명
sequenceNumber TRUE 문자열 이것은 클라이언트가 각 요청에 대해 전달해야 하는 단조 증가 숫자(ulong)의 문자열 표현입니다. 활동에 대한 업데이트의 순서를 보장하는 데 사용됩니다. sequenceNumber의 좋은 예는 증가하는 것이 보장되기 때문에 클라이언트의 유닉스 시간이 될 수 있습니다. 0보다 커야 하며 최대 ulong보다 클 수 없습니다.

응답

이름 유형 설명
204 콘텐츠 없음 항목이 삭제되었습니다.
400 잘못된 요청 ErrorResponse 요청을 처리하는 동안 오류가 발생했습니다. 가능한 오류 코드: "RequestValidationError: 요청 유효성 검사가 실패했습니다.", " AuthorizationError: 호출자는 리소스에 액세스할 수 없습니다."
기타 상태 코드 ThrottledEntity 요청이 너무 많습니다. 헤더 Retry-After: 정수

용어 정의

DeleteActivityRequest

이름 유형 설명
sequenceNumber 문자열 이것은 클라이언트가 각 요청에 대해 전달해야 하는 단조 증가 숫자(ulong)의 문자열 표현입니다. 활동에 대한 업데이트의 순서를 보장하는 데 사용됩니다. sequenceNumber의 좋은 예는 증가하는 것이 보장되기 때문에 클라이언트의 유닉스 시간이 될 수 있습니다. 0보다 커야 하며 최대 ulong보다 클 수 없습니다.

ErrorResponse

이름 유형 설명
디버그 메시지 문자열 디버깅에 사용할 수 있는 오류 메시지의 사람이 읽을 수 있는 버전입니다.
errorCode 문자열 오류 코드 열거형.

ThrottledEntity

이름 유형 설명
currentRequests 문자열 현재 요청 수 - 동시성 또는 속도입니다.
디버그 메시지 문자열 디버깅에 사용할 수 있는 스로틀 메시지의 사람이 읽을 수 있는 버전입니다.
제한 유형 문자열 제한 유형, 즉 동시성 또는 비율입니다.
maxRequests 문자열 허용되는 최대 요청 수 - 동시성 또는 속도.
periodInSeconds 문자열 속도 또는 동시성 제한이 초과될 때 적용되는 기간(초)입니다.
version 문자열 현재 스로틀 계약 버전입니다.