> ## Documentation Index
> Fetch the complete documentation index at: https://docs.x.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 액세스 받기

> 개발자 계정에 가입하고, 앱을 생성한 후, X API 호출을 시작하는 데 필요한 API 키, bearer token 및 OAuth 자격 증명을 저장합니다.

export const Button = ({href, children}) => {
  return <div className="not-prose group">
    <a href={href}>
      <button className="flex items-center space-x-2.5 py-1 px-4 bg-primary-dark dark:bg-white text-white dark:text-gray-950 rounded-full group-hover:opacity-[0.9] font-medium">
        <span>
          {children}
        </span>
        <svg width="3" height="24" viewBox="0 -9 3 24" class="h-6 rotate-0 overflow-visible"><path d="M0 0L3 3L0 6" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round"></path></svg>
      </button>
    </a>
  </div>;
};

세 가지 단계로 X API를 시작하세요: 가입, 앱 생성, 자격 증명 저장.

<Button href="https://console.x.com">지금 가입</Button>

***

## 1단계: 개발자 계정 생성

<Steps>
  <Step title="Developer Console로 이동">
    [console.x.com](https://console.x.com)을 방문하여 X 계정으로 로그인하세요.
  </Step>

  <Step title="개발자 계약 수락">
    개발자 계약 및 정책을 검토하고 수락하세요.
  </Step>

  <Step title="프로필 완성">
    API를 어떻게 사용할지에 대한 기본 정보를 제공하세요.
  </Step>
</Steps>

***

## 2단계: 앱 생성

가입 후 API 자격 증명을 얻기 위해 앱을 생성하세요:

<Steps>
  <Step title="'New App' 클릭">
    Developer Console 대시보드에서 새 앱을 생성하세요.
  </Step>

  <Step title="앱 세부 정보 입력">
    앱의 이름, 설명 및 사용 사례를 제공하세요.
  </Step>

  <Step title="자격 증명 생성">
    콘솔이 API 키와 토큰을 생성합니다.
  </Step>
</Steps>

***

## 3단계: 자격 증명 저장

인증 요구 사항에 따라 여러 자격 증명을 받게 됩니다:

| 자격 증명                     | 목적                                         |
| :------------------------ | :----------------------------------------- |
| **API Key & Secret**      | 앱을 식별합니다. 토큰 생성 및 OAuth 1.0a 요청 서명에 사용됩니다. |
| **Bearer Token**          | 공개 데이터를 읽기 위한 App-only 인증.                 |
| **Access Token & Secret** | 내 계정을 대신하여 요청 (OAuth 1.0a).                |
| **Client ID & Secret**    | user-context 요청을 위한 OAuth 2.0 인증.          |

<Warning>
  **즉시 저장하세요.** 자격 증명은 한 번만 표시됩니다. 비밀번호 관리자나 보안 저장소에 저장하세요. 잃어버리면 재생성해야 하며(이 경우 이전 것은 무효화됩니다).
</Warning>

***

## 어떤 자격 증명이 필요한가요?

<Tabs>
  <Tab title="공개 데이터 읽기">
    공개 데이터에 대한 간단한 읽기 전용 액세스를 위해 **Bearer Token**을 사용하세요.

    ```bash theme={null}
    curl "https://api.x.com/2/users/by/username/xdevelopers" \
      -H "Authorization: Bearer $BEARER_TOKEN"
    ```

    최적: 게시물 검색, 사용자 조회, 트렌드 읽기.
  </Tab>

  <Tab title="사용자로 활동">
    사용자를 대신해 활동하려면 **OAuth 2.0** (권장) 또는 **OAuth 1.0a**를 사용하세요.

    OAuth 2.0은 세분화된 스코프를 제공합니다—필요한 권한만 요청하세요.

    최적: 게시, 좋아요, 팔로우, DM 액세스.

    [OAuth 2.0 가이드 →](/resources/fundamentals/authentication/oauth-2-0/overview)
  </Tab>

  <Tab title="자신으로 활동">
    자신의 계정으로 요청을 하려면 **Access Token & Secret**을 사용하세요.

    이러한 토큰은 앱을 소유한 계정을 나타냅니다.

    최적: 테스트, 개인 봇, 자신의 자동화.
  </Tab>
</Tabs>

***

## 자격 증명 보안 모범 사례

<CardGroup cols={2}>
  <Card title="환경 변수 사용" icon="terminal">
    소스 코드에 자격 증명을 하드코딩하지 마세요.
  </Card>

  <Card title="git에 커밋하지 마세요" icon="code-branch">
    자격 증명 파일을 `.gitignore`에 추가하세요.
  </Card>

  <Card title="정기적으로 회전" icon="arrows-rotate">
    보안 조치로 자격 증명을 주기적으로 재생성하세요.
  </Card>

  <Card title="최소 스코프 사용" icon="shield-check">
    앱에 필요한 OAuth 권한만 요청하세요.
  </Card>
</CardGroup>

***

## 다음 단계

<CardGroup cols={2}>
  <Card title="첫 요청 만들기" icon="rocket" href="/x-api/getting-started/make-your-first-request">
    새 자격 증명으로 API를 호출하세요.
  </Card>

  <Card title="인증 알아보기" icon="key" href="/resources/fundamentals/authentication/overview">
    OAuth 1.0a와 OAuth 2.0을 이해하세요.
  </Card>
</CardGroup>