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

# 액세스 권한 얻기

> API 액세스를 신청하고 자격 증명을 발급받으세요

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를 시작할 수 있습니다: 가입하고, App을 만들고, 인증 정보를 저장하세요.

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

***

<div id="step-1-create-a-developer-account">
  ## 1단계: 개발자 계정 만들기
</div>

<Steps>
  <Step title="개발자 콘솔로 이동">
    [console.x.com](https://console.x.com)에 접속하여 X 계정으로 로그인하세요.
  </Step>

  <Step title="Developer Agreement 동의">
    Developer Agreement 및 정책(Policy)을 검토하고 동의하세요.
  </Step>

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

***

<div id="step-2-create-an-app">
  ## 2단계: 앱 생성
</div>

가입을 마친 후, API 자격 증명을 발급받기 위해 앱을 생성합니다:

<Steps>
  <Step title="'New App'을 클릭">
    개발자 콘솔 대시보드에서 새 앱을 생성합니다.
  </Step>

  <Step title="앱 세부 정보 입력">
    앱의 이름, 설명, 사용 사례를 입력합니다.
  </Step>

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

***

<div id="step-3-save-your-credentials">
  ## 3단계: 자격 증명 저장하기
</div>

인증 방식에 따라 여러 개의 자격 증명을 받게 됩니다:

| 자격 증명 (Credential)        | 용도 (Purpose)                                      |
| :------------------------ | :------------------------------------------------ |
| **API Key & Secret**      | App을 식별합니다. 토큰을 생성하고 OAuth 1.0a 요청에 서명하는 데 사용됩니다. |
| **Bearer Token**          | 공개 데이터를 읽기 위한 App 전용 인증입니다.                       |
| **Access Token & Secret** | 자신의 계정(OAuth 1.0a)을 대신하여 요청을 보낼 때 사용합니다.          |
| **Client ID & Secret**    | 사용자 컨텍스트 기반 요청을 위한 OAuth 2.0 인증에 사용됩니다.           |

<Warning>
  **즉시 저장하세요.** 자격 증명은 한 번만 표시됩니다. 비밀번호 관리자 또는 보안 금고에 보관하세요. 분실한 경우 다시 생성해야 하며, 이때 이전 자격 증명은 무효화됩니다.
</Warning>

***

<div id="which-credentials-do-you-need">
  ## 어떤 자격 증명이 필요하나요?
</div>

<Tabs>
  <Tab title="공개 데이터 읽기">
    공개 데이터에 단순 읽기 전용으로 액세스하려면 **Bearer 토큰**을 사용하세요.

    ```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 가이드 →](/ko/resources/fundamentals/authentication/oauth-2-0/overview)
  </Tab>

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

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

    주 사용 사례: 테스트, 개인 봇, 개인 자동화.
  </Tab>
</Tabs>

***

<div id="credential-security-best-practices">
  ## 자격 증명 보안 모범 사례
</div>

<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">
    App에 필요한 OAuth 권한만 요청하세요.
  </Card>
</CardGroup>

***

<div id="next-steps">
  ## 다음 단계
</div>

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

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