개발자 지원

문제를 해결하든, 가이드를 찾든, 다른 개발자와 연결하고 싶든, 저희가 도와드립니다.

커뮤니티 및 도움말

Developer Forums

질문하고, 프로젝트를 공유하며, X 개발자 커뮤니티와 팀의 도움을 받으세요. 기술적 질문에 대한 지원을 받기에 가장 좋은 곳입니다.

API 상태

X API v2, Enterprise API, Developer Console의 현재 운영 상태를 확인하세요.

연락처 및 양식

Enterprise API 관심

엔터프라이즈 수준의 API 액세스에 관심이 있으신가요? 관심을 표명하면 저희 팀이 연락드립니다.

결제 지원

Self-serve 및 Enterprise API 구독에 대한 결제 문의를 받으세요.

정책 지원

정책, 준수 또는 특정 사용 사례에 대한 승인이 필요하신가요? 정책팀에 문의하세요.

문서 및 리소스

시작하기

X API가 처음이신가요? 여기에서 API 키를 받고 첫 요청을 보내세요.

API 레퍼런스

모든 X API v2 엔드포인트, 매개변수, 응답 형식에 대한 완전한 레퍼런스입니다.

인증 가이드

OAuth 1.0a, OAuth 2.0 및 API 요청 인증 방법에 대해 알아보세요.

SDK & 라이브러리

개발 속도를 높이기 위한 공식 Python 및 TypeScript SDK입니다.

속도 제한

속도 제한과 애플리케이션에서 이를 처리하는 방법을 이해하세요.

오류 코드

API 오류 코드와 일반적인 문제를 해결하는 방법에 대한 레퍼런스입니다.

정책 및 가이드라인

개발자 가이드라인

X API로 빌드할 때 허용되는 것과 그렇지 않은 것에 대한 실용적인 가이드입니다.

개발자 계약

X API 액세스에 대한 구속력 있는 법적 약관입니다.

개발자 정책

X에서 빌드할 때의 규칙과 기대 사항입니다.

제한된 사용 사례

금지되었거나 특별 승인이 필요한 활동입니다.

문제 해결 팁

401 Unauthorized 오류가 발생합니다

API 키와 토큰이 올바른지 다시 확인하세요
엔드포인트에 적합한 인증 방법을 사용하고 있는지 확인하세요(OAuth 1.0a vs OAuth 2.0)
앱에 필요한 권한(읽기, 쓰기, DM 액세스)이 있는지 확인하세요
토큰이 만료되지 않았는지 확인하세요 — 필요한 경우 재발급하세요

속도 제한에 걸렸습니다

API 응답의 x-rate-limit-* 헤더를 확인하여 사용량을 모니터링하세요
429 오류를 받으면 지수 백오프를 구현하세요
가능한 경우 응답을 캐시하여 API 호출을 줄이세요
더 높은 한도를 위해 액세스 티어 업그레이드를 고려하세요
자세한 정보는 속도 제한 가이드를 참조하세요

앱이 정지되었습니다

정지 원인을 이해하려면 개발자 가이드라인을 검토하세요
정지에 대한 X의 커뮤니케이션이 있는지 이메일을 확인하세요
Policy Support form을 통해 항의를 제출하세요
일반적인 원인: 자동화된 좋아요, 원치 않는 DM/멘션, 스크래핑, 속도 제한 남용

더 높은 API 액세스 또는 제한이 필요합니다

적절한 플랜을 찾으려면 가격 티어를 검토하세요
엔터프라이즈 요구 사항은 Enterprise API Interest 양식을 제출하세요
액세스 업그레이드는 Use Case Upgrade 양식을 사용하세요

필요한 엔드포인트를 찾을 수 없습니다

전체 API 레퍼런스를 둘러보세요
아직 v2에 없을 수 있는 v1.1 엔드포인트에 기능이 있는지 확인하세요
확실하지 않다면 Developer Forums에서 질문하세요

Changelog

최신 API 업데이트, 새로운 기능 및 변경 사항입니다.

@XDevelopers

공지 사항 및 개발자 뉴스를 위해 팔로우하세요.

Incidents

과거 인시던트 및 해결 내역입니다.

​커뮤니티 및 도움말