뮤트 관리

뮤트 관리: Standard v1.1과 X API v2 비교

Standard v1.1의 POST mutes/users/create 및 POST mutes/users/destroy 엔드포인트를 사용해 왔다면, 이 가이드는 Standard v1.1과 X API v2의 뮤트 관리 엔드포인트 간 유사점과 차이점을 이해하는 데 도움을 주는 것을 목표로 합니다.

• 유사점
  • OAuth 1.0a 사용자 컨텍스트
• 차이점
  • 엔드포인트 URL
  • App 및 Project 요건
  • HTTP 메서드
  • 요청 매개변수

유사점

OAuth 1.0a User Context 인증 방법

두 버전의 엔드포인트는 모두 OAuth 1.0a User Context를 지원합니다. 따라서 이전에 standard v1.1 mutes 관리 엔드포인트 중 하나를 사용했다면, X API v2 버전으로 마이그레이션하더라도 동일한 인증 방법을 계속 사용할 수 있습니다.

차이점

엔드포인트 URL

• Standard v1.1 엔드포인트:
  • POST https://api.x.com/1.1/mutes/users/create.json (사용자 뮤트)
  • POST https://api.x.com/1.1/mutes/users/destroy.json (사용자 뮤트 해제)
• X API v2 엔드포인트:
  • POST https://api.x.com/2/users/:id/muting (사용자 뮤트)
  • DELETE https://api.x.com/2/users/:source_user_id/muting/:target_user_id (사용자 뮤트 해제)

App 및 Project 요구 사항

X API v2 엔드포인트를 사용하려면 요청을 인증할 때 developer App과 Project에 연결된 자격 증명을 사용해야 합니다. 모든 X API v1.1 엔드포인트는 Project에 연결되지 않은 App이든 Project에 연결된 App이든, 해당 App의 자격 증명을 사용할 수 있습니다.

요청 파라미터

다음 Standard v1.1 요청 파라미터에는 X API v2에서의 대응 항목이 있습니다:

Standard v1.1	X API v2
user_id	target_user_id
screen_name	해당 없음

Standard v1.1 파라미터는 쿼리 파라미터로 전달되는 반면, X API v2 파라미터는 본문 파라미터(POST 엔드포인트의 경우) 또는 경로 파라미터(DELETE 엔드포인트의 경우)로 전달된다는 점에 유의하십시오.

또한 Standard v1.1 엔드포인트를 사용할 때는 OAuth 1.0a User Context와 함께 전달되는 액세스 토큰을 통해 어떤 사용자가 뮤트/뮤트 해제를 시작했는지 알 수 있으므로, 대상 사용자를 뮤트하는 사용자의 id는 별도로 지정할 필요가 없습니다.

---

코드 예제

사용자를 뮤트하기 (v2)

cURL

shellscript

curl -X POST "https://api.x.com/2/users/123456789/muting" \
  -H "Authorization: OAuth ..." \
  -H "Content-Type: application/json" \
  -d '{"target_user_id": "2244994945"}'

사용자 음소거 해제 (v2)

cURL

shellscript

curl -X DELETE "https://api.x.com/2/users/123456789/muting/2244994945" \
  -H "Authorization: OAuth ..."