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

​
개요

포스트 규정 준수

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

사용자 규정 준수

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

비동기 처리

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

대규모 데이터 세트

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

​
작동 방식

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

​
엔드포인트

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

​
작업 유형

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

​
규정 준수 이벤트

​
게시물 이벤트

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

​
시작하기

사전 준비 사항

빠른 시작

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

통합 가이드

핵심 개념 및 모범 사례

API 참조 문서

전체 엔드포인트 문서