# 시작하기

이 페이지에서는 [설치](https://r2turntrue.gitbook.io/chzzk4j/undefined/installation) 이후 `chzzk4j`를 시작하는 내용에 대해 다룹니다.

## API 키 발급

{% hint style="warning" %}
현재 chzzk4j는 치지직의 비공개 API에서 OpenAPI로 마이그레이션 중에 있습니다. 되도록이면 공식 API 키를 이용해주세요.
{% endhint %}

{% hint style="info" %}
공식 API 키 없이도 `chzzk4j`를 사용할 수 있습니다만, 몇몇 기능에 제한이 생길 수도 있습니다.
{% endhint %}

`chzzk4j`의 모든 기능을 활용하기 위해서는 치지직의 공식 API 키를 발급받아야 합니다.

1. [치지직 Developers](https://developers.chzzk.naver.com) 페이지에 로그인하고 내 서비스 버튼을 클릭합니다.\
   ![](https://3533554147-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FD9ZDOeNCDW7sotMW7KBs%2Fuploads%2Fgit-blob-20049dadea6f25949d2af205370b1e1558290b2e%2F1.png?alt=media)
2. 애플리케이션 목록에서 '애플리케이션 등록'을 클릭해서 관련 정보를 입력하고, 애플리케이션을 생성합니다.
   * 인증이 필요하지 않다면 로그인 리디렉션 URL은 `http://localhost:8080`으로 설정합니다.
   * 애플리케이션에 필요한 API Scope를 선택합니다.
3. 클라이언트 ID와 Secret을 복사합니다.\
   ![](https://3533554147-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FD9ZDOeNCDW7sotMW7KBs%2Fuploads%2Fgit-blob-9c7a08abed38f25f16fad862e3f24eee4510eb61%2F2.png?alt=media)

## ChzzkClient 생성

`ChzzkClientBuilder`를 통해 `ChzzkClient`를 생성합니다.

{% tabs %}
{% tab title="With API Key" %}

```java
ChzzkClient client = new ChzzkClientBuilder("API_CLIENT_ID", "API_SECRET")
//      .withDebugMode() // 디버그 로그를 확인하고 싶다면 활성화할 수 있습니다.
        .build();
```

{% endtab %}

{% tab title="Without API Key" %}

```java
ChzzkClient client = new ChzzkClientBuilder()
//      .withDebugMode() // 디버그 로그를 확인하고 싶다면 활성화할 수 있습니다.
        .build();
```

{% endtab %}
{% endtabs %}
