deleteAddress

Prev Next

๋“ฑ๋ก๋œ ์ˆ˜์‹ ์ž ์ด๋ฉ”์ผ ์ฃผ์†Œ๋ฅผ ์‚ญ์ œํ•ฉ๋‹ˆ๋‹ค. ์‚ญ์ œ ๋Œ€์ƒ์„ ํฌํ•จํ•œ ์ˆ˜์‹ ์ž ๊ทธ๋ฃน์ด ์žˆ๋‹ค๋ฉด, ํ•ด๋‹น ๊ทธ๋ฃน์˜ ์—ฐ๊ด€ ์ •๋ณด๊ฐ€ ์ˆ˜์ •๋ฉ๋‹ˆ๋‹ค.

์š”์ฒญ ํ˜•์‹์„ ์„ค๋ช…ํ•ฉ๋‹ˆ๋‹ค. ์š”์ฒญ ํ˜•์‹์€ ๋‹ค์Œ๊ณผ ๊ฐ™์Šต๋‹ˆ๋‹ค.

๋ฉ”์„œ๋“œ URI
DELETE /address-book/address

Cloud Outbound Mailer API์—์„œ ๊ณตํ†ต์œผ๋กœ ์‚ฌ์šฉํ•˜๋Š” ํ—ค๋”์— ๋Œ€ํ•œ ์ž์„ธํ•œ ๋‚ด์šฉ์€ Cloud Outbound Mailer ์š”์ฒญ ํ—ค๋”๋ฅผ ์ฐธ์กฐํ•ด ์ฃผ์‹ญ์‹œ์˜ค.

์š”์ฒญ ๋ฐ”๋””์— ๋Œ€ํ•œ ์„ค๋ช…์€ ๋‹ค์Œ๊ณผ ๊ฐ™์Šต๋‹ˆ๋‹ค.

ํ•„๋“œ ํƒ€์ž… ํ•„์ˆ˜ ์—ฌ๋ถ€ ์„ค๋ช…
emailAddresses List<String> Required ์‚ญ์ œํ•  ์ˆ˜์‹ ์ž ์ด๋ฉ”์ผ ์ฃผ์†Œ ๋ชฉ๋ก

์š”์ฒญ ์˜ˆ์‹œ๋Š” ๋‹ค์Œ๊ณผ ๊ฐ™์Šต๋‹ˆ๋‹ค.

curl --location --request DELETE 'https://mail.apigw.fin-ntruss.com/api/v1/address-book/address'
--header 'x-ncp-apigw-timestamp: {Timestamp}'
--header 'x-ncp-iam-access-key: {Access Key}'
--header 'x-ncp-apigw-signature-v2: {API Gateway Signature}'
--header 'Content-Type: application/json'
--data-raw '{
  "emailAddresses":[
    "xxx@naver.com",
    "xxx@daum.net",
    ...
  ]
}'
Curl

์‘๋‹ต ํ˜•์‹์„ ์„ค๋ช…ํ•ฉ๋‹ˆ๋‹ค.

์‘๋‹ต ๋ฐ”๋””์— ๋Œ€ํ•œ ์„ค๋ช…์€ ๋‹ค์Œ๊ณผ ๊ฐ™์Šต๋‹ˆ๋‹ค.

ํ•„๋“œ ํƒ€์ž… ํ•„์ˆ˜ ์—ฌ๋ถ€ ์„ค๋ช…
totalAddressCount Integer Required ์ด ์ด๋ฉ”์ผ ์ฃผ์†Œ ๊ฐœ์ˆ˜
groups List<AddressBookResponse> Optional ์ˆ˜์‹ ์ž ๊ทธ๋ฃน ์ •๋ณด

์‘๋‹ต ์ƒํƒœ ์ฝ”๋“œ์— ๋Œ€ํ•œ ์„ค๋ช…์€ ๋‹ค์Œ๊ณผ ๊ฐ™์Šต๋‹ˆ๋‹ค.

HTTP ์ƒํƒœ ์ฝ”๋“œ ์ฝ”๋“œ ์„ค๋ช…
200 - ์š”์ฒญ ์„ฑ๊ณต
400 - ์ธ์ฆ ์‹คํŒจ, ์ž˜๋ชป๋œ ์š”์ฒญ
400 77101 ๋กœ๊ทธ์ธ ์ •๋ณด ์˜ค๋ฅ˜
400 77102 ์š”์ฒญ ์˜ค๋ฅ˜
400 77103 ์š”์ฒญํ•œ ๋ฆฌ์†Œ์Šค๊ฐ€ ์กด์žฌํ•˜์ง€ ์•Š์Œ
403 77201 ์š”์ฒญํ•œ ๋ฆฌ์†Œ์Šค์— ๋Œ€ํ•œ ๊ถŒํ•œ์ด ์—†์Œ
403 77202 ์ด๋ฉ”์ผ ์„œ๋น„์Šค ์‚ฌ์šฉ์„ ์‹ ์ฒญํ•˜์ง€ ์•Š์€ ์‚ฌ์šฉ์ž๊ฐ€ ํ˜ธ์ถœํ•œ ๊ฒฝ์šฐ
405 77001 ์ง€์›๋˜์ง€ ์•Š๋Š” ๋ฉ”์„œ๋“œ ์œ ํ˜•
415 77002 ์ง€์›๋˜์ง€ ์•Š๋Š” ๋ฏธ๋””์–ด ์œ ํ˜•
500 - ์„œ๋ฒ„ ์˜ค๋ฅ˜
500 77301 ๊ธฐ๋ณธ ํ”„๋กœ์ ํŠธ๊ฐ€ ์กด์žฌํ•˜์ง€ ์•Š์Œ
500 77302 ์™ธ๋ถ€ ์‹œ์Šคํ…œ API ์—ฐ๋™ ์˜ค๋ฅ˜
500 77303 ๊ทธ ์™ธ ๋‚ด๋ถ€ ์„œ๋ฒ„ ์˜ค๋ฅ˜

์‘๋‹ต ์˜ˆ์‹œ๋Š” ๋‹ค์Œ๊ณผ ๊ฐ™์Šต๋‹ˆ๋‹ค.

{
  "totalAddressCount": 4300,
  "groups": [
    {
      "sid": 155,
      "groupName": "10๋Œ€",
      "addressCount": 3900
    },
    {
      "sid": 159,
      "groupName": "๋‚จ์ž",
      "addressCount": 1000
    }
}
JSON