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

# Batch Compliance

> X API v2 Batch Compliance 엔드포인트를 사용하여 Post ID 또는 user ID 데이터세트를 업로드하고 삭제, 정지, 편집에 대한 현재 규정 준수 상태를 조회합니다.

export const Button = ({href, children}) => {
  return <div className="not-prose">
    <a href={href}>
      <button className="x-btn">
        <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 엔드포인트를 사용하면 Post ID 또는 user ID 데이터세트를 업로드하고 현재 규정 준수 상태를 받을 수 있습니다. 이를 사용하여 삭제된 Post, 정지된 계정 및 기타 규정 준수 이벤트를 식별할 수 있습니다.

## 개요

<CardGroup cols={2}>
  <Card title="Post 컴플라이언스" icon="https://mintcdn.com/x-preview/ygI6sSJPehlc0qNT/icons/xds/icon-chat.svg?fit=max&auto=format&n=ygI6sSJPehlc0qNT&q=85&s=9fde7d51b4f18c96d3a38a81d519761f" width="24" height="24" data-path="icons/xds/icon-chat.svg">
    Post 상태 일괄 확인
  </Card>

  <Card title="사용자 컴플라이언스" icon="https://mintcdn.com/x-preview/SxzTbJaLjs3MidH1/icons/xds/icon-person.svg?fit=max&auto=format&n=SxzTbJaLjs3MidH1&q=85&s=507a4bbcdcf5744bd18781508002e305" width="24" height="24" data-path="icons/xds/icon-person.svg">
    사용자 상태 일괄 확인
  </Card>

  <Card title="비동기" icon="clock">
    작업 제출 및 나중에 결과 조회
  </Card>

  <Card title="대용량 데이터세트" icon="database">
    수백만 개의 ID 처리
  </Card>
</CardGroup>

***

## 작동 방식

1. **작업 생성** — 유형(Posts 또는 users)과 업로드 URL 지정
2. **ID 업로드** — 제공된 URL로 데이터세트 업로드
3. **처리 대기** — 작업이 비동기적으로 처리됨
4. **결과 다운로드** — 각 ID의 규정 준수 상태 확인

***

## 엔드포인트

| Method | Endpoint                                                               | 설명                 |
| :----- | :--------------------------------------------------------------------- | :----------------- |
| POST   | [`/2/compliance/jobs`](/x-api/compliance/create-compliance-job)        | 새 compliance 작업 생성 |
| GET    | [`/2/compliance/jobs/:id`](/x-api/compliance/get-compliance-job-by-id) | 작업 상태 가져오기         |
| GET    | [`/2/compliance/jobs`](/x-api/compliance/get-compliance-jobs)          | 모든 작업 나열           |

***

## 작업 유형

| 유형       | 설명               |
| :------- | :--------------- |
| `tweets` | Post 규정 준수 상태 확인 |
| `users`  | 사용자 규정 준수 상태 확인  |

***

## 규정 준수 이벤트

### Post 이벤트

| 이벤트         | 설명                 |
| :---------- | :----------------- |
| `deleted`   | 사용자가 Post 삭제       |
| `bounced`   | Post가 규정 준수 검사에 실패 |
| `protected` | 계정이 보호됨            |
| `suspended` | 계정이 정지됨            |
| `scrub_geo` | 지리 데이터 제거됨         |

### 사용자 이벤트

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

***

## 예제: 작업 생성

```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"
  }'
```

***

## 시작하기

<Note>
  **사전 요구 사항**

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

<CardGroup cols={2}>
  <Card title="빠른 시작" icon="https://mintcdn.com/x-preview/oR-aRNyj1BKPJtxM/icons/xds/icon-rocket.svg?fit=max&auto=format&n=oR-aRNyj1BKPJtxM&q=85&s=b978d7a9225de31709efbbed5b84e92d" href="/x-api/compliance/batch-compliance/quickstart" width="24" height="24" data-path="icons/xds/icon-rocket.svg">
    첫 번째 compliance 작업 생성
  </Card>

  <Card title="통합 가이드" icon="https://mintcdn.com/x-preview/Vn2KEkZaPF9LiPi3/icons/xds/icon-book.svg?fit=max&auto=format&n=Vn2KEkZaPF9LiPi3&q=85&s=22ac564792481d14ae36a941546039c8" href="/x-api/compliance/batch-compliance/integrate" width="24" height="24" data-path="icons/xds/icon-book.svg">
    주요 개념 및 모범 사례
  </Card>

  <Card title="API 참조" icon="https://mintcdn.com/x-preview/ygI6sSJPehlc0qNT/icons/xds/icon-code.svg?fit=max&auto=format&n=ygI6sSJPehlc0qNT&q=85&s=488e23401b19225b89acc0136d242219" href="/x-api/compliance/create-compliance-job" width="24" height="24" data-path="icons/xds/icon-code.svg">
    전체 엔드포인트 문서
  </Card>
</CardGroup>