빠른 시작하기

​

답글 숨기기 엔드포인트 시작하기

이 빠른 시작 가이드는 Postman을 사용해 답글 숨기기 엔드포인트에 첫 요청을 보내는 방법을 안내합니다.

여러 언어의 코드 스니펫을 확인하려면 답글 숨기기 API 참고 페이지를 방문하세요.

​

사전 준비사항

이 가이드를 완료하려면 요청 인증에 필요한 키와 토큰 세트가 있어야 합니다. 다음 단계를 따라 키와 토큰을 생성하세요.

• 개발자 계정 등록 후 승인을 받습니다.
• 개발자 포털에서 Project와 연동된 Developer 앱을 생성합니다.
• App의 “Keys and tokens” 페이지로 이동해 필요한 자격 증명을 생성합니다. 모든 자격 증명은 안전한 위치에 보관하세요.

​

PUT /tweets/:id/hidden 요청을 빌드하는 단계

​

1단계: 도구 또는 라이브러리로 시작하기

이 엔드포인트에 요청을 보내는 데 사용할 수 있는 다양한 도구, 코드 예제, 라이브러리가 있지만, 여기서는 과정을 단순화하기 위해 Postman을 사용하겠습니다.

X API v2 Postman 컬렉션을 내 환경에 가져오려면 아래 버튼을 클릭하세요:

Postman에 X API v2 추가

Postman에 X API v2 컬렉션을 가져온 후, 답글 숨기기 엔드포인트로 이동하세요.

​

2단계: 요청 인증

X API에 올바르게 요청하려면 권한이 있는지 확인해야 합니다. 이 엔드포인트에서는 OAuth 1.0a 사용자 컨텍스트 또는 OAuth 2.0 Authorization Code with PKCE를 사용해 요청을 인증해야 합니다.

이 예제에서는 OAuth 1.0a 사용자 컨텍스트를 사용합니다.

Postman에 키와 토큰—구체적으로 API Key, API Secret Key, OAuth 1.0a 사용자 액세스 토큰, OAuth 1.0a 사용자 액세스 토큰 시크릿—을 추가해야 합니다. Postman 우측 상단에서 “X API v2”라는 이름의 환경(environment)을 선택한 뒤, 환경 드롭다운 옆 눈 아이콘을 클릭해 “initial value” 및 “current value” 필드에 키와 토큰을 추가하세요.

변수를 올바르게 설정했다면 요청의 Authorization 탭에 자동으로 채워집니다.  

​

3단계: 숨길 게시물 ID 찾기

hide replies 엔드포인트는 권한 있는 사용자를 대신해 답글을 숨기거나 표시하도록 전환할 수 있습니다. 이 예제에서는 사용자 프로필과 연결된 액세스 토큰을 사용하므로, 사용자가 시작한 대화에 참여한 사용자들의 답글을 숨길 수 있습니다. 마찬가지로, 앱을 승인한 다른 사용자에게 속한 액세스 토큰을 사용하는 경우 해당 계정이 시작한 모든 대화의 답글을 관리할 수 있습니다.

지인에게 게시물에 답글을 달아 달라고 요청하세요(답글 숨기기 기능을 테스트 중임을 알려주세요). 또는 테스트 계정으로 본인의 게시물 중 하나에 답글을 달아 보세요. 그 답글을 클릭한 다음 URL의 숫자 부분을 복사하세요. 이것이 우리가 숨길 게시물 ID입니다.

이 경우 다음 게시물을 살펴보며, 해당 ID는 1232720193182412800입니다:

https://x.com/TwitterDev/status/1232720193182412800

​

4단계: 게시물 숨기기

Postman에서 Hide replies 폴더를 열고 Hide a reply를 선택하세요. Params 탭에서 id 필드 옆에 게시물 ID를 붙여 넣으세요(URL의 :id는 바꿀 필요가 없습니다). “Send”를 클릭하면 성공적으로 응답이 반환됩니다.

{"hidden":true}

​

5단계: 게시물 숨김 해제

숨김 처리된 게시물은 X 앱의 별도 탭으로 이동됩니다. Postman에서 게시물의 숨김을 해제하려면 Hide replies 폴더를 열고 Unhide a reply를 선택하세요. Params 탭에서 이전 단계에서 사용한 동일한 게시물 ID를 id 필드에 붙여넣으세요. “Send”를 클릭하면 성공 응답이 표시됩니다.

{"hidden":false}

hidden 필드는 게시물의 숨김 상태를 나타냅니다. 숨김 상태가 true이면 해당 게시물이 숨겨져 있음을 의미합니다. 마찬가지로 false이면 게시물이 숨겨져 있지 않음을 의미합니다.