개인화 데이터 삭제

1. 개요

• 수집된 개인화 데이터(오프사이트 캠페인 발송 대상 회원의 개인화 데이터)를 그루비에서 삭제하는 API입니다.

• memberId 혹은 전화번호 기준으로 매칭되는 데이터를 삭제합니다.

---

2. 기본 정보

항목	내용
Method	DELETE
URL	https://api.groobee.io/personalizations
인증	[설정 > 사이트]에서 발급받은 API Key (Header)

3. 요청 (Request)

요청 헤더(Header)

이름	필수	설명
x-api-key	O	API 인증 키
Content-Type	O	application/json

요청 본문(Body)

필드	타입	필수	설명
memberIds	Array<String>	△	삭제 대상 회원 ID 목록
phoneNumbers	Array<String>	△	삭제 대상 전화번호 목록 (하이픈 포함/미포함 모두 허용)

• memberIds, phoneNumbers 둘 중 하나 이상은 반드시 포함되어야 합니다.

• 두 조건은 OR로 동작합니다. (memberIds에 포함되거나 또는 phoneNumbers에 포함되면 삭제)

• memberIds와 phoneNumbers의 합산 개수는 한 번에 최대 1,000건까지 요청할 수 있습니다.

---

4. 예제 (Example)

요청(Request)

{
    "memberIds": [
        "groobee1",
        "groobee2"
    ],
    "phoneNumbers": [
        "010-0000-2222",
        "01033334444"
    ]
}

• memberId만으로 삭제

{
    "memberIds": [
        "groobee1",
        "groobee2"
    ]
}

• 전화번호만으로 삭제

{
    "phoneNumbers": [
        "010-0000-2222",
        "010-3333-4444"
    ]
}

---

5. 응답 (Response)

• 성공 시 processValue에 삭제된 데이터 건수가 반환됩니다.

성공 시

{
    "httpStatus": {
        "code": "200",
        "reasonPhrase": "OK"
    },
    "processCode": "0",
    "processValue": 2
}

실패 시

{
    "httpStatus": {
        "code": "400",
        "reasonPhrase": "Bad Request"
    },
    "processCode": "-1004",
    "processValue": {
        "message": "데이터 초과"
    }
}

• HTTP Status는 항상 200이며, 실제 성공 여부는 processCode로 판단합니다.

• processValue는 성공 시 삭제된 문서 수(정수)입니다.

6. 결과 코드 (Result Codes)

코드 값	상태	설명
0	성공	정상 처리
-1000	실패	요청 시 Header에 x-api-key 미존재
-1001	실패	고객사 미존재
-1002	실패	고객사 미승인 상태 (승인 필요)
-1003	실패	고객사 계약기간 만료
-1004	실패	데이터 초과 (합산 1,000건 초과)
-1006	실패	회원 ID가 올바르지 않습니다.
-1007	실패	회원 전화번호가 올바르지 않습니다.
-4001	실패	요청 본문에 내용이 없습니다 (삭제 조건 미포함)
-9997	실패	데이터가 올바르지 않습니다.
-9998	실패	http 관련 에러
-9999	실패	요청 API 서버 에러

---

7. 주의사항

• 삭제 조건: memberIds, phoneNumbers 중 최소 하나 이상은 반드시 포함해야 합니다. 두 값이 모두 비어 있으면 -4001 오류가 발생하며, 전체 데이터가 삭제되지 않도록 방지합니다.

• OR 조건 동작: memberIds와 phoneNumbers를 함께 전송하면, 둘 중 하나라도 일치하는 데이터가 모두 삭제됩니다. (교집합이 아닌 합집합)

• 전화번호 처리: 전화번호는 수집 시와 동일하게 하이픈(-)을 제거한 뒤 처리됩니다. 하이픈 포함(010-0000-2222), 미포함(01000002222) 모두 동일하게 동작합니다.

• 존재하지 않는 대상: 삭제 대상이 존재하지 않아도 오류가 아니며, 실제로 삭제된 건수가 processValue로 반환됩니다. (예: 일치 데이터가 없으면 0)

• 복구 불가: 삭제된 데이터는 복구할 수 없습니다.