빠른 시작

이 가이드는 Post 또는 사용자의 규정 준수 상태를 확인하기 위한 batch compliance 작업을 생성하는 과정을 안내합니다.

사전 요구 사항시작하기 전에 다음이 필요합니다:

승인된 App이 있는 개발자 계정
App의 Bearer Token

작업 생성

유형(tweets 또는 users)을 지정하여 새로운 compliance 작업을 생성합니다:

cURL
Python

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

import requests

bearer_token = "YOUR_BEARER_TOKEN"

url = "https://api.x.com/2/compliance/jobs"
headers = {
    "Authorization": f"Bearer {bearer_token}",
    "Content-Type": "application/json"
}
payload = {
    "type": "tweets",
    "name": "my-compliance-job"
}

response = requests.post(url, headers=headers, json=payload)
print(response.json())

응답:

{
  "data": {
    "id": "1234567890",
    "type": "tweets",
    "name": "my-compliance-job",
    "status": "created",
    "upload_url": "https://storage.googleapis.com/...",
    "download_url": "https://storage.googleapis.com/...",
    "created_at": "2024-01-15T10:00:00.000Z"
  }
}

다음 단계를 위해 upload_url과 download_url을 저장하세요.

데이터 파일 준비

한 줄에 하나의 ID가 있는 텍스트 파일을 만듭니다:

ids.txt로 저장합니다.

데이터 업로드

제공된 upload_url에 파일을 업로드합니다:

curl -X PUT "UPLOAD_URL_FROM_RESPONSE" \
  -H "Content-Type: text/plain" \
  --data-binary @ids.txt

작업 상태 확인

작업이 완료될 때까지 상태를 폴링합니다:

curl "https://api.x.com/2/compliance/jobs/1234567890" \
  -H "Authorization: Bearer $BEARER_TOKEN"

작업 상태:

상태	설명
`created`	작업 생성됨, 업로드 대기 중
`in_progress`	데이터 처리 중
`complete`	결과 다운로드 준비 완료
`failed`	작업 실패
`expired`	완료 전에 작업 만료

결과 다운로드

상태가 complete가 되면 download_url에서 다운로드합니다:

curl "DOWNLOAD_URL_FROM_RESPONSE" -o results.json

결과 형식 (한 줄당 하나의 JSON 객체):

{"id": "1234567890", "action": "delete", "created_at": "2024-01-10T12:00:00.000Z", "redacted_at": "2024-01-12T08:30:00.000Z", "reason": "deleted"}
{"id": "1234567891", "action": "delete", "created_at": "2024-01-10T12:00:00.000Z", "redacted_at": "2024-01-13T14:20:00.000Z", "reason": "suspended"}

규정 준수 이벤트가 있는 ID만 결과에 표시됩니다. 결과에 없는 ID는 여전히 유효합니다.

규정 준수 작업

Post 규정 준수 이벤트

Action	Reason	설명
`delete`	`deleted`	Post 삭제됨
`delete`	`bounced`	Post가 규정 준수 검사에 실패
`delete`	`protected`	계정이 보호됨
`delete`	`suspended`	계정이 정지됨
`delete`	`scrub_geo`	지리 데이터 제거됨

사용자 규정 준수 이벤트

Action	Reason	설명
`delete`	`deleted`	계정 삭제됨
`delete`	`suspended`	계정 정지됨
`delete`	`protected`	계정 보호됨
`delete`	`deactivated`	계정 비활성화됨

모든 작업 나열

App의 모든 compliance 작업을 가져옵니다:

curl "https://api.x.com/2/compliance/jobs?type=tweets" \
  -H "Authorization: Bearer $BEARER_TOKEN"

다음 단계

통합 가이드

주요 개념 및 모범 사례

Compliance 스트림

실시간 규정 준수 이벤트

API 참조

전체 엔드포인트 문서

Getting Started

Products

Fundamentals

Partners & Customers

Resources

규정 준수 작업

모든 작업 나열

다음 단계

통합 가이드

Compliance 스트림

API 참조

​규정 준수 작업

​모든 작업 나열

​다음 단계

통합 가이드

Compliance 스트림

API 참조

규정 준수 작업

모든 작업 나열

다음 단계