일괄 컴플라이언스

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

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

​

개요

포스트 규정 준수

대량 포스트의 상태를 확인할 수 있습니다

사용자 규정 준수

대량 사용자의 상태를 확인할 수 있습니다

비동기 처리

작업을 제출해 두고 나중에 결과를 조회할 수 있습니다

대규모 데이터 세트

수백만 개의 id를 처리할 수 있습니다

---

​

작동 방식

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

---

​

엔드포인트

Method	Endpoint	Description
POST	/2/compliance/jobs	새 컴플라이언스 작업을 생성합니다
GET	/2/compliance/jobs/:id	작업 상태를 조회합니다
GET	/2/compliance/jobs	모든 작업을 나열합니다

---

​

작업 유형

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

---

​

규정 준수 이벤트

​

게시물 이벤트

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

​

사용자 이벤트

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

---

​

예시: 작업 생성하기

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

---

​

시작하기

사전 준비 사항

• 승인된 개발자 계정
• 개발자 콘솔의 Project 및 App
• App의 Bearer Token

빠른 시작

첫 번째 컴플라이언스 작업 생성하기

통합 가이드

핵심 개념 및 모범 사례

API 참조 문서

전체 엔드포인트 문서