메인 콘텐츠로 건너뛰기

​
게시물 관리 엔드포인트 시작하기**

이 빠른 시작 가이드는 Postman을 사용해 게시물 관리 엔드포인트에 첫 요청을 보내는 방법을 안내합니다. 다양한 언어의 샘플 코드를 확인하려면 X API v2 샘플 코드 GitHub 리포지토리를 방문하세요.
사전 준비 사항이 가이드를 완료하려면 요청 인증에 사용할 키와 토큰 세트가 필요합니다. 다음 단계를 따라 키와 토큰을 생성하세요.
  • 개발자 계정에 가입하고 승인을 받습니다.
  • 개발자 포털에서 Project와 연결된 Developer 앱을 생성합니다.
  • App의 “Keys and tokens” 페이지로 이동해 필요한 자격 증명을 생성합니다. 모든 자격 증명은 안전한 위치에 보관하세요.

​
Manage Posts 요청 빌드 단계

1단계: 도구 또는 라이브러리로 시작하기 이 엔드포인트에 요청을 보내는 데 사용할 수 있는 다양한 도구, 코드 예제, 라이브러리가 있지만, 여기서는 과정을 단순화하기 위해 Postman을 사용합니다. 환경에 X API v2 Postman 컬렉션을 불러오려면 다음 버튼을 클릭하세요:
Postman에 X API v2 컬렉션을 불러온 후 “Manage Posts” 폴더로 이동해 “Create a Post”를 선택하세요.   2단계: 요청 인증하기 X API에 올바르게 요청하려면 해당 권한이 있는지 확인해야 합니다. Manage Posts 엔드포인트에서 이를 수행하려면 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”라는 환경을 선택한 다음, 환경 드롭다운 옆의 눈 아이콘을 클릭해 “initial value” 및 “current value” 필드에 키와 토큰을 입력하세요. 올바르게 설정했다면 이러한 변수는 요청의 Authorization 탭에 자동으로 반영됩니다. 3단계: 게시물 텍스트 지정하기 이 엔드포인트로 새 게시물을 만들 때 게시물의 텍스트 또는 미디어는 필수 본문 매개변수입니다. Postman에서 “Body” 탭으로 이동해 text 매개변수 값으로 게시물 텍스트를 입력하세요. 추가로 투표, 특정 게시물 ID에 대한 답글, 답글 설정 등의 매개변수도 여기에서 설정할 수 있습니다. 사용 가능한 항목은 API 참조 가이드에서 자세히 확인할 수 있습니다.
KeyValueParameter type
textHello world!body
4단계: 가져올 필드 식별 및 지정하기 모든 설정을 완료했으면 “Send” 버튼을 누르세요. 그러면 아래 예시와 유사한 응답을 받게 됩니다: 
{
  "data": {
    "id": "1445880548472328192",
    "text": "안녕하세요 세상!"
  }
}
반환된 응답 객체에 id와 게시물의 text가 포함되어 있으면 게시물이 성공적으로 생성된 것입니다.   5단계: 게시물 삭제 게시물을 삭제하려면 Postman에 로드된 X API v2 컬렉션의 “Manage Posts” 폴더에 있는 “Delete a Post” 요청을 선택합니다. 이 엔드포인트에는 삭제하려는 게시물의 ID가 필요합니다. 그런 다음 “Params” 탭에서 삭제할 게시물의 ID를 id 열의 값으로 입력합니다.  삭제 요청이 성공하면 다음 예와 유사한 응답을 받게 됩니다: 
{
   "data": {
       "deleted" : true
   }
}
다음 단계 API 참고서 지원 요청 샘플 코드