> ## 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.

# 일괄 컴플라이언스

> 게시물과 사용자에 대한 컴플라이언스 상태를 일괄 확인합니다

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>;
};

Batch Compliance 엔드포인트를 사용하면 게시물 id 또는 사용자 id로 구성된 데이터셋을 업로드하고, 해당 리소스의 현재 컴플라이언스 상태를 받을 수 있습니다. 이를 통해 삭제된 게시물, 정지된 계정 및 기타 컴플라이언스 이벤트를 식별할 수 있습니다.

<div id="overview">
  ## 개요
</div>

<CardGroup cols={2}>
  <Card title="포스트 규정 준수" icon="message">
    대량 포스트의 상태를 확인할 수 있습니다
  </Card>

  <Card title="사용자 규정 준수" icon="user">
    대량 사용자의 상태를 확인할 수 있습니다
  </Card>

  <Card title="비동기 처리" icon="clock">
    작업을 제출해 두고 나중에 결과를 조회할 수 있습니다
  </Card>

  <Card title="대규모 데이터 세트" icon="database">
    수백만 개의 id를 처리할 수 있습니다
  </Card>
</CardGroup>

***

<div id="how-it-works">
  ## 작동 방식
</div>

1. **작업 생성** — type(포스트 또는 사용자)와 업로드 URL을 지정합니다
2. **ID 업로드** — 제공된 URL로 데이터세트를 업로드합니다
3. **처리 대기** — 작업이 비동기적으로 처리됩니다
4. **결과 다운로드** — 각 ID에 대한 컴플라이언스 상태를 확인합니다

***

<div id="endpoints">
  ## 엔드포인트
</div>

| Method | Endpoint                                                                  | Description        |
| :----- | :------------------------------------------------------------------------ | :----------------- |
| POST   | [`/2/compliance/jobs`](/ko/x-api/compliance/create-compliance-job)        | 새 컴플라이언스 작업을 생성합니다 |
| GET    | [`/2/compliance/jobs/:id`](/ko/x-api/compliance/get-compliance-job-by-id) | 작업 상태를 조회합니다       |
| GET    | [`/2/compliance/jobs`](/ko/x-api/compliance/get-compliance-jobs)          | 모든 작업을 나열합니다       |

***

<div id="job-types">
  ## 작업 유형
</div>

| Type     | Description       |
| :------- | :---------------- |
| `tweets` | 게시물 컴플라이언스 상태를 확인 |
| `users`  | 사용자 컴플라이언스 상태를 확인 |

***

<div id="compliance-events">
  ## 규정 준수 이벤트
</div>

<div id="post-events">
  ### 게시물 이벤트
</div>

| Event       | Description            |
| :---------- | :--------------------- |
| `deleted`   | 사용자가 게시물을 삭제함          |
| `bounced`   | 게시물이 규정 준수 검사를 통과하지 못함 |
| `protected` | 계정이 보호 상태가 됨           |
| `suspended` | 계정이 정지됨                |
| `scrub_geo` | 위치 정보가 제거됨             |

<div id="user-events">
  ### 사용자 이벤트
</div>

| 이벤트           | 설명        |
| :------------ | :-------- |
| `deleted`     | 계정이 삭제됨   |
| `suspended`   | 계정이 정지됨   |
| `protected`   | 계정이 보호됨   |
| `deactivated` | 계정이 비활성화됨 |

***

<div id="example-create-a-job">
  ## 예시: 작업 생성하기
</div>

```bash theme={null}
curl -X POST "https://api.x.com/2/compliance/jobs" \
  -H "Authorization: Bearer $BEARER_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "tweets",
    "name": "my-compliance-job"
  }'
```

***

<div id="getting-started">
  ## 시작하기
</div>

<Note>
  **사전 준비 사항**

  * 승인된 [개발자 계정](https://developer.x.com/en/portal/petition/essential/basic-info)
  * 개발자 콘솔의 [Project 및 App](/ko/resources/fundamentals/developer-apps)
  * App의 [Bearer Token](/ko/resources/fundamentals/authentication)
</Note>

<CardGroup cols={2}>
  <Card title="빠른 시작" icon="rocket" href="/ko/x-api/compliance/batch-compliance/quickstart">
    첫 번째 컴플라이언스 작업 생성하기
  </Card>

  <Card title="통합 가이드" icon="book" href="/ko/x-api/compliance/batch-compliance/integrate">
    핵심 개념 및 모범 사례
  </Card>

  <Card title="API 참조 문서" icon="code" href="/ko/x-api/compliance/create-job">
    전체 엔드포인트 문서
  </Card>
</CardGroup>