Skip to main content
이 가이드는 첫 X API 요청을 보내는 과정을 안내합니다. 시작하기 전에 앱 자격 증명이 있는 개발자 계정이 필요합니다.

cURL로 빠르게 시작하기

API를 테스트하는 가장 빠른 방법은 cURL입니다. 사용자를 조회해 봅시다:
$BEARER_TOKEN을 실제 Bearer Token으로 바꾸세요. 다음과 같은 응답을 받게 됩니다:

단계별 가이드

1

Bearer Token 받기

Developer Console에서 앱으로 이동해 Bearer Token을 복사하세요.
2

엔드포인트 선택

다음 입문자 친화적인 엔드포인트 중 하나로 시작하세요:
3

요청 보내기

cURL, Postman 또는 선호하는 HTTP 클라이언트를 사용하세요:
4

응답 파싱

응답은 JSON 형식입니다. 기본 데이터는 data 필드에 있습니다:

fields로 더 많은 데이터 요청하기

기본적으로 엔드포인트는 최소한의 필드만 반환합니다. 추가 데이터를 요청하려면 fields 매개변수를 사용하세요:
응답:
fields에 대해 자세히 알아보기 →

더 많은 예제


cURL 대신 코드 사용하기


테스트 도구

Postman

컬렉션으로 시각적 API 테스트를 수행합니다.

샘플 코드

여러 언어로 된 예제입니다.

API 레퍼런스

전체 엔드포인트 문서입니다.

문제 해결

  • Bearer Token이 올바른지 확인하세요
  • 토큰이 재발급되지 않았는지 확인하세요
  • Authorization 헤더 형식을 확인하세요: Bearer YOUR_TOKEN
  • 앱에 이 엔드포인트 액세스 권한이 없을 수 있습니다
  • 일부 엔드포인트는 사용자 컨텍스트 인증(OAuth 1.0a 또는 2.0)이 필요합니다
  • Developer Console에서 앱의 권한을 확인하세요
  • 속도 제한에 도달했습니다
  • 재시도 시점을 확인하려면 x-rate-limit-reset 헤더를 확인하세요
  • 코드에 지수 백오프를 구현하세요
전체 오류 레퍼런스 →

다음 단계

인증 배우기

사용자 컨텍스트 요청을 위한 OAuth를 이해하세요.

엔드포인트 살펴보기

무엇을 만들 수 있는지 알아보세요.

SDK 사용

공식 라이브러리로 더 빠르게 개발하세요.

무언가 만들기

무엇을 만들지에 대한 아이디어입니다.