그룹 삭제(탈퇴)

싸인투게더의 고객 그룹 삭제(탈퇴)합니다.

API 사용이 가능하더라도 기본적으로는 사용할 수 없으며, 싸인투게더 운영팀에 소통하신 후 권한을 부여 받으신 후에 사용 가능합니다.

API 계정 그룹의 권한에 따라 해당 그룹 및 하위 그룹만 삭제(탈퇴) 가능합니다.

그룹 삭제(탈퇴)

DELETE /rest/api/group

파라미터는 파라미터 셋을 배열로 받아 다중으로 요청이 가능합니다.

1개의 세트만 처리하고 싶은 경우 배열에 1개의 파라미터 셋만 세팅하여 전달해주면 됩니다.

Headers

Name	Type	Description
apiKey*	String	apiKey

Request Body

Name	Type	Description
groupId*	Number	삭제할 그룹 Id

Request Example

요청 예시

[
  { 
    "groupId":1                     // 삭제할 그룹 Id    
  }, ...
]

Response Example

200: OK 성공 또는 핸들링된 오류

Example

{
    "successCount": 1,
    "failCount": 1,
    "successList": [
        {
            "message": "",		// 결과 메시지
            "groupId": 1,
            "success": true		// 성공 여부
        }
    ],
    "failList": [
        {
            "message": "해당 그룹에 대한 권한이 없습니다.",
            "groupId": 100,
            "success": false
        }
    ]
}

400: Bad Request 핸들링하지 못한 오류에 대한 처리

Example

{
  "timestamp": "2023-09-01T14:27:27.971+00:00",
  "status": 400,
  "error": "Bad Request",
  "message": "[|COM_002]Invalid_Parameter|파라미터 정보가 정상적이지 않습니다.",
  "path": "/rest/create-document"
}

401: Unauthorized keyauth 토큰(apikey)이 잘못된 경우

Example

{
    "message": "Bad token; invalid JSON"
}

401: Unauthorized Header에 apikey를 전달하지 않은 경우

Example

{
    "message": "Unauthorized"
}