개요

매체사 서비스를 탈퇴한 유저의 개인정보 처리를 위해 버즈빌에 유저 데이터 파기 요청을 보내는 API입니다.

API 연동하기

METHOD: POST

운영

URL: https://screen-api.buzzvil.com/api/delete_device/

스테이징

URL: https://screen-api-staging.buzzvil.com/api/delete_device/

운영

ip: 43.206.81.155
ip: 13.230.245.160

스테이징

ip: 13.114.185.101
ip: 35.79.185.179

포트

tcp/443

Request Header

{
  "Content-Type": "application/json",
  "Authorization": "Token 000980073e0cae95b29c45deb824ce0a76390446"
}

※ Authorization 토큰 발급이 필요한 경우 help@buzzvil.com로 요청해주세요.

Request Body (application/json)

JSON의 root type은 list ([]) 입니다.
리스트 안의 요소는 object ({}) 형태입니다.
각 object는 다음과 같은 키-값을 포함합니다:
- app_id : 매체사에 할당된 app_id
- user_ids : 삭제하려는 user_id들의 리스트

Example

[
  {
    "app_id": 10029111,
    "user_ids": [ "user_id_1", "user_id_2", "user_id_3" ]
  },
  {
    "app_id": 11192852,
    "user_ids": [ "user_id_5", "user_id_4", "user_id_1" ]
  }
]

API Response Code 가이드

✅ 성공

200 OK
요청이 정상적으로 처리되었습니다.

🚫 실패

400 Bad Request

요청이 잘못되어 서버가 처리할 수 없는 경우입니다. 에러 메시지는 Response Body에 포함되어 내려옵니다.

에러 메시지	설명

에러 메시지	설명
Content-Type must be application/json	요청 헤더의 Content-Type이 application/json이 아닙니다.
invalid json format	Request Body가 JSON 포맷을 만족하지 않습니다.
deletions must be list	Request Body의 root 타입이 리스트(list)가 아닙니다.
deletion must be dict	리스트 내 데이터가 object(dict)가 아닙니다.
deletion has missing keys (app_id, user_ids)	리스트 안의 object 중 app_id, user_ids 키가 없는 경우가 있습니다.
invalid app {app_id}	요청한 app_id가 매체사 권한 범위에 없습니다.
user_ids must be list	user_ids 필드가 리스트 타입이 아닙니다.
user_ids exceeds 1000 for the app {}	하나의 앱에서 user_ids 수가 1000개를 초과했습니다.

참고:
모든 400 에러는 Response Body에 위 메시지 중 하나가 포함되어 내려옵니다.
Content-Type은 보통 application/json입니다.

403 Forbidden

에러 메시지	설명

에러 메시지	설명
없음 (Header 오류)	요청 Header에 Authorization 필드가 없거나 포맷이 잘못되었습니다.

500 Internal Server Error

에러 메시지	설명

에러 메시지	설명
unknown error	서버 내부 에러입니다. 상세한 원인을 알 수 없습니다.

📋 에러 응답 예시

400 에러 발생 시 서버 응답 예시:

HTTP/1.1 400 Bad Request
Content-Type: application/json

{
  "error": "user_ids must be list"
}

🧩 추가 Notes

요청 Header는 항상 Content-Type: application/json이어야 합니다.
Authorization 토큰은 요청 Header에 반드시 포함되어야 합니다.
Request Body는 JSON 포맷을 만족해야 하며,
- Root는 list 타입이어야 하고,
- 리스트 안의 요소는 object(dict) 타입이어야 합니다.

문서 버전

버전	수정 내역	By

버전	수정 내역	By
v1.1	(하위 호환이 가능하도록) 도메인 및 URL 변경 기존 URL : `https://screen.buzzvil.com/api/delete_device/` (기존 URL도 사용하는데 지장 없음) 변경 URL : `https://screen-api.buzzvil.com/api/delete_device/` 스테이징용 URL 추가 ip 화이트리스팅 정보 추가	@Mason Yun
v1.0	없음

매체사 탈퇴 유저 데이터 파기 API

개요