**지원 종료 공지:** 2026년 10월 30일에 Amazon Pinpoint에 대한 지원이 AWS 종료됩니다. 2026년 10월 30일 이후에는 Amazon Pinpoint 콘솔 또는 Amazon Pinpoint 리소스(엔드포인트, 세그먼트, 캠페인, 여정, 분석)에 더 이상 액세스할 수 없습니다. 자세한 내용은 [Amazon Pinpoint 지원 종료](https://docs.aws.amazon.com/console/pinpoint/migration-guide)를 참조하세요. **참고:** SMS, 음성, 모바일 푸시, OTP 및 전화번호 검증과 관련된 APIs는이 변경의 영향을 받지 않으며 AWS 최종 사용자 메시징에서 지원됩니다. 기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다. # Amazon Pinpoint API로 요청 전송 Postman 구성 및 테스트가 완료되면 Amazon Pinpoint API로 추가 요청 전송을 시작할 수 있습니다. 이 단원에는 요청 전송을 시작하기 전에 알아야 할 정보가 들어 있습니다. 또한 Amazon Pinpoint 컬렉션을 사용하는 방법을 설명하는 두 개의 샘플 요청도 포함되어 있습니다. **중요** 이 단원의 절차를 완료하면 요청을 Amazon Pinpoint API에 제출합니다. 이러한 요청은 Amazon Pinpoint 계정에서 새 리소스 생성, 기존 리소스 수정, 메시지 전송, Amazon Pinpoint 프로젝트의 구성 변경, 기타 Amazon Pinpoint 기능 사용 등의 작업을 수행할 수 있습니다. 이러한 요청을 실행할 때는 주의하세요. ## Amazon Pinpoint Postman 컬렉션의 예제 Amazon Pinpoint Postman 컬렉션을 사용하기 전에 이러한 컬렉션에서 대부분의 작업을 구성해야 합니다. `GET` 및 `DELETE` 작업의 경우 일반적으로 **요청 전 스크립트** 탭에서 설정된 변수만 수정하면 됩니다. **참고** [IAM 정책 생성](tutorials-using-postman-iam-user.md#tutorials-using-postman-iam-user-create-policy)에 표시된 IAM 정책을 사용하면 이 컬렉션에 포함된 `DELETE` 요청을 하나도 수행할 수 없습니다. 예를 들어 `GetCampaign` 작업을 수행하려면 `projectId`와 `campaignId`를 지정해야 합니다. **요청 전 스크립트** 탭에 이러한 변수가 모두 있으며 예제 값으로 채워져 있습니다. 예제 값을 삭제하고 Amazon Pinpoint 프로젝트 및 캠페인에 적절한 값으로 바꿉니다. 이러한 변수 중에서 가장 일반적으로 사용되는 변수가 `projectId` 변수입니다. 이 변수의 값은 요청이 적용되는 프로젝트의 고유 식별자여야 합니다. 프로젝트에 대한 이러한 식별자 목록을 보려면 이 자습서의 이전 단계에서 보낸 `GetApps` 요청에 대한 응답을 참조하세요. 이 응답에서 `Id` 필드는 프로젝트의 고유 식별자를 제공합니다. `GetApps` 작동 및 응답 내 각 필드의 의미에 대해 자세히 알아보려면 *Amazon Pinpoint API 참조*의 [앱](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps.html)을 참조하세요. **참고** Amazon Pinpoint에서 ‘프로젝트’는 ‘앱’ 또는 ‘애플리케이션’과 동일합니다. 또한 `POST` 및 `PUT` 작업의 경우 API에 전송하려는 값을 포함하도록 요청도 수정해야 합니다. 예를 들어 `CreateApp` 요청(`POST` 요청)을 제출할 때, 생성하는 프로젝트의 이름을 지정해야 합니다. **본문** 탭에서 요청을 수정할 수 있습니다. 이 예제에서는 `"Name"` 옆의 값을 프로젝트 이름으로 바꿉니다. 태그를 프로젝트에 추가하려는 경우 `tags` 객체에서 태그를 지정할 수 있습니다. 또는 태그를 추가하지 않으려는 경우 전체 `tags` 객체를 삭제할 수 있습니다. **참고** `UntagResource` 작업을 수행하려면 URL 파라미터도 지정해야 합니다. **파라미터** 탭에서 이러한 파라미터를 지정할 수 있습니다. **VALUE** 열의 값을 지정된 리소스에 대해 삭제하려는 태그로 바꿉니다. ## 예제 요청: `CreateApp` 작업을 사용하여 프로젝트 생성 Amazon Pinpoint에서 세그먼트와 캠페인을 생성하기 전에 먼저 프로젝트를 생성해야 합니다. Amazon Pinpoint에서 *프로젝트*는 공통 목적으로 통합된 세그먼트, 캠페인, 구성 및 데이터로 구성되어 있습니다. 예를 들어 프로젝트를 사용하여 특정 앱이나 특정 브랜드 또는 마케팅 이니셔티브와 관련된 모든 콘텐츠를 포함시킬 수 있습니다. Amazon Pinpoint에 고객 정보를 추가하면 해당 정보가 프로젝트와 연결됩니다. **CreateApp API 요청을 전송하여 프로젝트를 생성하려면** 1. **환경** 메뉴에서 프로젝트를 생성할 AWS 리전 를 선택합니다. ![\[\]](http://docs.aws.amazon.com/ko_kr/pinpoint/latest/userguide/images/Postman_Tutorial_Environments.png) 이 예제에서는 **환경** 메뉴에 다음 네 가지 옵션이 표시되도록 Postman이 구성되었습니다. + 미국 동부(버지니아 북부) + 미국 서부(오리건) + 유럽(프랑크푸르트) + 유럽(아일랜드) 1. **Apps** 폴더에서 **CreateApp** 작업을 선택합니다. ![\[\]](http://docs.aws.amazon.com/ko_kr/pinpoint/latest/userguide/images/Postman_Tutorial_3.2_2.png) Amazon Pinpoint Postman 컬렉션의 **Apps** 폴더가 확장되어 다음과 같은 요청이 표시됩니다. + `GetApp` + `GetApps` + `CreateApp` + `DeleteApp` 1. **본문** 탭의 `"Name"` 옆에서 자리 표시자 값(`"string"`)을 캠페인 이름(예: **"MySampleProject"**)으로 바꿉니다. 1. 캠페인 이름 뒤의 쉼표를 삭제한 다음 3행부터 5행까지 전체 `tags` 객체를 삭제합니다 완료되면 요청은 다음 이미지에 표시된 코드 조각과 비슷하게 됩니다. ``` { "Name": "MySampleProject" } ``` Postman은 요청을 원시 JSON 페이로드로 전송하도록 구성됩니다. 1. **전송**를 선택합니다. 캠페인이 성공적으로 생성되면 응답 창에 `201 Created` 상태가 표시됩니다. ``` { "Name": "MySampleProject" "Id": "12345678901234567890123456789012", "Arn": "arn:aws:mobiletargeting:us-east-1:123456789012:apps/12345678901234567890123456789012", "tags": {} } ``` ## 예제: `SendMessages` 작업을 사용하여 이메일 전송 Amazon Pinpoint `SendMessages` API를 사용하여 트랜잭션 메시지를 전송하는 것은 매우 일반적입니다. `SendMessages` API를 사용하여 메시지를 전송하는 장점(캠페인 생성과 비교 시) 중 하나는 메시지를 어떤 주소로든(예: 이메일 주소, 전화 번호 또는 디바이스 토큰) 전송할 수 있다는 것입니다. 메시지를 보내는 주소가 Amazon Pinpoint 계정에 이미 존재할 필요는 없습니다 이 방법을 캠페인을 생성하여 메시지를 전송하는 방법과 비교해 보겠습니다 Amazon Pinpoint에서 캠페인을 보내려면 먼저 Amazon Pinpoint 계정에 엔드포인트를 추가하고, 세그먼트를 생성하고, 캠페인을 생성하고, 캠페인을 실행해야 합니다. 이 단원의 예제에서는 특정 이메일 주소로 트랜잭션 이메일 메시지를 직접 전송하는 방법을 보여 줍니다. SMS, 모바일 푸시 또는 음성과 같은 다른 채널을 통해 메시지를 전송하도록 이 요청을 수정할 수 있습니다. **SendMessages 요청을 전송하여 이메일 메시지를 전송하려면** 1. 프로젝트에 이메일 채널이 활성화되어 있고 메시지를 보내고 받는 데 사용할 이메일 주소 또는 도메인이 구성되어 있는지 확인하세요. 자세한 내용은 *Amazon Pinpoint 사용 설명서*의 [이메일 채널 활성화 및 비활성화](pinpoint/latest/userguide/channels-email-setup.html) 및 [이메일 ID 확인](https://docs.aws.amazon.com/pinpoint/latest/userguide/channels-email-manage-verify.html)을 참조하세요. **참고** 이 단원의 절차를 완료하려면 이메일 주소를 확인해야 합니다. 1. **환경** 메뉴에서 메시지를 보낼 AWS 리전 를 선택합니다. 이 예제에서는 **환경** 메뉴에 다음 네 가지 옵션이 표시되도록 Postman이 구성되었습니다. + 미국 동부(버지니아 북부) + 미국 서부(오리건) + 유럽(프랑크푸르트) + 유럽(아일랜드) 1. **메시지** 폴더에서 **SendMessages** 작업을 선택합니다. ![\[\]](http://docs.aws.amazon.com/ko_kr/pinpoint/latest/userguide/images/Postman_Tutorial_3.3_3.png) 1. **요청 전 스크립트** 탭에서 `projectId` 변수의 값을 이 단원의 2단계에서 선택한 리전에 이미 있는 프로젝트의 ID로 바꿉니다. 1. **본문** 탭에서 요청 편집기에 표시된 예제 요청을 삭제합니다. 다음 코드를 붙여넣습니다. ``` { "MessageConfiguration":{ "EmailMessage":{ "FromAddress":"sender@example.com", "SimpleEmail":{ "Subject":{ "Data":"Sample Amazon Pinpoint message" }, "HtmlPart":{ "Data":"

Test message

This is a sample message sent from Amazon Pinpoint using the SendMessages API.

" }, "TextPart":{ "Data":"This is a sample message sent from Amazon Pinpoint using the SendMessages API." } } } }, "Addresses":{ "recipient@example.com": { "ChannelType": "EMAIL" } } } ``` 1. 이전의 코드에서 *sender@example.com*을 자신의 확인된 이메일 주소로 바꿉니다. *recipient@example.com*을 메시지를 전송하려는 확인된 이메일 주소로 바꿉니다. **참고** 계정이 여전히 Amazon Pinpoint 이메일 샌드박스에 있는 경우 Amazon Pinpoint 계정에서 확인된 이메일 주소 또는 도메인으로만 이메일을 전송할 수 있습니다. 샌드박스에서 계정을 제거하는 방법에 대한 자세한 내용은 *Amazon Pinpoint 사용 설명서*의 [이메일에 대한 프로덕션 액세스 요청](https://docs.aws.amazon.com/pinpoint/latest/userguide/channels-email-setup-production-access.html)을 참조하세요. 1. **전송**를 선택합니다. 메시지가 성공적으로 전송되면 응답 창에 `200 OK` 상태가 표시됩니다. ``` { "ApplicationId": "12345678901234567890123456789012", "RequestId": "", "Result": { "recipient@example.com": { "DeliveryStatus": "SUCCESSFUL", "StatusCode": 200, "StatusMessage": "", "MessageId": "" } } } ```