Opt Outs - Remove

서비스:

Communication

API 버전:

2025-05-29-preview

옵트아웃 목록에서 전화 번호를 제거합니다.

POST {endpoint}/sms/optouts:remove?api-version=2025-05-29-preview

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
endpoint	path	True	string (url)	통신 리소스(예: https://my-resource.communication.azure.com
api-version	query	True	string	호출할 API의 버전입니다.

요청 본문

Name	필수	형식	Description
from	True	string minLength: 1	인증된 계정이 소유한 보낸 사람의 식별자(일반적으로 E.164 형식의 전화 번호)입니다.
recipients	True	OptOutRecipient[]	단일 옵트아웃 받는 사람 번호입니다.

응답

Name	형식	Description
200 OK	OptOutResponse	성공

예제

Opt In

샘플 요청

HTTP

POST {endpoint}/sms/optouts:remove?api-version=2025-05-29-preview

{
  "from": "+18001234567",
  "recipients": [
    {
      "to": "+15555555551"
    },
    {
      "to": "+123"
    },
    {
      "to": "+15555555553"
    }
  ]
}

샘플 응답

상태 코드:

200

{
  "value": [
    {
      "to": "+15555555551",
      "httpStatusCode": 200
    },
    {
      "to": "+123",
      "httpStatusCode": 400,
      "errorMessage": "Invalid recipient phone number format"
    },
    {
      "to": "+15555555553",
      "httpStatusCode": 500,
      "errorMessage": "Internal Server Error"
    }
  ]
}

정의

Name	Description
OptOutRecipient	단일 옵트아웃 받는 사람 번호입니다.
OptOutRequest	옵트아웃 요청입니다.
OptOutResponse	옵트아웃 요청에 대한 응답입니다. 응답에서 반환된 항목의 유효성을 검사하여 옵트아웃 목록에서 성공적으로 추가되거나 제거된 받는 사람을 확인합니다.
OptOutResponseItem

OptOutRecipient

Object

단일 옵트아웃 받는 사람 번호입니다.

Name	형식	Description
to	string minLength: 1	받는 사람의 전화 번호(E.164 형식)입니다.

OptOutRequest

Object

옵트아웃 요청입니다.

Name	형식	Description
from	string minLength: 1	인증된 계정이 소유한 보낸 사람의 식별자(일반적으로 E.164 형식의 전화 번호)입니다.
recipients	OptOutRecipient[]	단일 옵트아웃 받는 사람 번호입니다.

OptOutResponse

Object

옵트아웃 요청에 대한 응답입니다. 응답에서 반환된 항목의 유효성을 검사하여 옵트아웃 목록에서 성공적으로 추가되거나 제거된 받는 사람을 확인합니다.

Name	형식	Description
value	OptOutResponseItem[]

OptOutResponseItem

Object

Name	형식	Description
errorMessage	string	4xx/5xx 오류의 경우 선택적 오류 메시지입니다.
httpStatusCode	integer (int32)
isOptedOut	boolean	메시지가 수신되지 않도록 옵트아웃된 번호를 지정하는 선택적 플래그
to	string minLength: 1	받는 사람 전화 번호(E.164 형식)입니다.