**지원 종료 공지:** 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 최종 사용자 메시징에서 지원됩니다. 기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다. # 자습서: Postman을 Amazon Pinpoint API와 함께 사용 Postman은 사용하기 쉬운 그래픽 환경에서 API를 테스트하는 인기 있는 도구입니다. Postman을 사용하여 API 요청을 REST API로 전송하고 요청에 대한 응답을 수신할 수 있습니다. Postman 사용은 Amazon Pinpoint API에 대해 수행하는 호출을 테스트하고 문제를 해결하는 편리한 방법입니다. 이 자습서에는 Amazon Pinpoint에서 Postman을 설정하고 사용하기 위한 절차가 포함되어 있습니다. **참고** Postman은 타사에서 개발되었습니다. Amazon Web Services(AWS)에서 개발 또는 지원하지 않습니다. Postman 사용에 대해 자세히 알아보거나 Postman 관련 문제에 대한 지원을 받으려면 Postman 웹 사이트의 [지원 센터](https://support.postman.com/hc/en-us)를 참조하세요. ## 이 자습서 소개 이 단원에서는 이 자습서의 개요를 다룹니다. **수강 대상** 이 자습서는 개발자와 시스템 구현자를 위해 계획되었습니다. Amazon Pinpoint 또는 Postman에 익숙하지 않아도 이 자습서의 단계를 완료할 수 있습니다. IAM 정책 관리 및 JSON 코드 예제 수정에 익숙해야 합니다. 이 자습서의 절차는 신규 사용자가 Amazon Pinpoint 리소스를 영구적으로 삭제할 수 있는 API 작업을 사용하지 않도록 하기 위해 설계되었습니다. 고급 사용자는 사용자와 연결된 정책을 수정하여 이 제한을 제거할 수 있습니다. **사용된 기능** 이 자습서에는 다음과 같은 Amazon Pinpoint 기능에 대한 사용 예제가 포함되어 있습니다. + Postman을 사용하여 Amazon Pinpoint API와 상호 작용 **필요 시간** 이 자습서를 완료하려면 약 15분 정도 걸립니다. **지역별 제한** 이 솔루션의 사용과 관련된 지역별 제한은 없습니다. **리소스 사용 비용** AWS 계정 생성에는 요금이 부과되지 않습니다. 그러나이 솔루션을 구현하면 Postman을 사용하여 다음 중 하나를 수행하는 경우 AWS 사용 비용이 발생할 수 있습니다. + 이메일, SMS, 모바일 푸시 또는 음성 메시지 전송 + 캠페인 생성 및 전송 + 전화 번호 확인 기능 사용 Amazon Pinpoint 사용과 관련된 요금에 대한 자세한 내용은 [Amazon Pinpoint 요금](https://aws.amazon.com/pinpoint/pricing/)을 참조하세요. # Amazon Pinpoint와 함께 Postman을 사용하기 위한 사전 조건 이 자습서를 시작하기 전에 다음 사전 조건을 완료합니다. + AWS 계정이 있어야 합니다. AWS 계정을 만들려면 [https://console.aws.amazon.com/](https://console.aws.amazon.com/)으로 이동하여 **새 AWS 계정 생성**을 선택합니다. + AWS Management Console에 로그인하는 데 사용하는 계정이 새로운 IAM 정책 및 역할을 생성할 수 있는지 확인합니다. + 이메일 기능이 켜져 있고 이메일 ID가 확인된 샘플 프로젝트가 하나 이상 생성되어 있는지 확인하세요. *Amazon Pinpoint 사용 설명서*의 [이메일 지원이 있는 Amazon Pinpoint 프로젝트 생성](https://docs.aws.amazon.com/pinpoint/latest/userguide/channels-email-setup-create.html)을 참조하세요. + AWS 계정 ID가 있는지 확인하세요. AWS 계정 ID는 콘솔의 오른쪽 상단에 있습니다. 또는 명령줄 인터페이스(CLI) 를 사용할 수 있습니다. [AWS 계정 ID 찾기](https://docs.aws.amazon.com/accounts/latest/reference/manage-acct-identifiers.html#FindAccountId)를 참조하세요. + 컴퓨터에 Postman을 다운로드하고 설치해야 합니다. [Postman 웹 사이트](https://www.getpostman.com)에서 Postman을 다운로드할 수 있습니다.. + 컴퓨터에 Postman을 설치한 후 Postman 계정을 생성해야 합니다. Postman 애플리케이션을 처음 시작할 때는 새 계정에 로그인하거나 새 계정을 생성하라는 메시지가 나타납니다. Postman에서 제공하는 지침에 따라 계정에 로그인하거나 계정이 아직 없다면 계정을 만드세요. **다음**: [IAM 정책 및 역할 생성](tutorials-using-postman-iam-user.md) # Amazon Pinpoint와 함께 사용할 IAM 정책 및 역할 생성 Postman을 사용하여 Amazon Pinpoint API를 테스트하는 경우 첫 번째 단계는 사용자를 생성하는 것입니다. 이 단원에서는 사용자에게 모든 Amazon Pinpoint 리소스와 상호 작용할 수 있는 기능을 제공하는 정책을 생성합니다. 그런 다음 사용자를 생성하고 정책을 사용자에 직접 연결합니다. ## IAM 정책 생성 IAM 정책을 생성하는 방법을 알아봅니다. 이 정책을 사용하는 사용자 및 역할은 Amazon Pinpoint API의 모든 리소스와 상호 작용할 수 있습니다. 또한 Amazon Pinpoint 이메일 API 및 Amazon Pinpoint SMS 및 보이스 API와 관련된 리소스에도 액세스할 수 있습니다. **정책 생성** 1. 에 로그인 AWS Management Console 하고 [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/) IAM 콘솔을 엽니다. 1. 탐색 창에서 **정책**을 선택한 후 **정책 생성**을 선택합니다. 1. **정책 편집기**에서 **JSON**을 선택합니다. **정책 편집기**에서 현재 JSON을 삭제하여 비어 있도록 합니다. 다음 JSON을 복사하여 **정책 편집기**에 붙여 넣은 다음 **정책 편집기**에서 *123456789012*의 모든 인스턴스를 AWS 계정 ID로 바꿉니다. AWS 계정 ID는 콘솔의 오른쪽 상단 모서리에서 찾을 수 있습니다. 또는 CLI를 사용할 수 있습니다. [AWS 계정 ID 찾기를 참조하세요](https://docs.aws.amazon.com/accounts/latest/reference/manage-acct-identifiers.html#FindAccountId). **참고** Amazon Pinpoint 계정의 데이터를 보호하기 위해 이 정책에는 리소스를 읽고 생성하고 수정하도록 허용하는 권한만 포함됩니다. 이 정책에는 리소스를 삭제하도록 허용하는 권한이 포함되지 않습니다. IAM 콘솔에서 시각적 편집기를 사용하여 이 정책을 수정할 수 있습니다. 자세한 내용은 IAM 사용 설명서의 [IAM 정책 관리](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_manage.html)를 참조하세요. 또한 IAM API의 [CreatePolicyVersion](https://docs.aws.amazon.com/IAM/latest/APIReference/API_CreatePolicyVersion.html) 작업을 사용하여 이 정책을 업데이트할 수 있습니다. 이 정책에는 `mobiletargeting` 서비스뿐 아니라 `ses` 및 `sms-voice` 서비스와 상호 작용하도록 허용하는 권한도 포함됩니다. `ses` 및 `sms-voice` 권한을 통해 각각 Amazon Pinpoint 이메일 API 및 Amazon Pinpoint SMS 및 음성 API와 상호 작용할 수 있습니다. `mobiletargeting` 권한은 Amazon Pinpoint API와 상호 작용하도록 허용합니다. ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Sid": "VisualEditor0", "Effect": "Allow", "Action": [ "mobiletargeting:Update*", "mobiletargeting:Get*", "mobiletargeting:Send*", "mobiletargeting:Put*", "mobiletargeting:Create*" ], "Resource": [ "arn:aws:mobiletargeting:*:123456789012:apps/*", "arn:aws:mobiletargeting:*:123456789012:apps/*/campaigns/*", "arn:aws:mobiletargeting:*:123456789012:apps/*/segments/*" ] }, { "Sid": "VisualEditor1", "Effect": "Allow", "Action": [ "mobiletargeting:TagResource", "mobiletargeting:PhoneNumberValidate", "mobiletargeting:ListTagsForResource", "mobiletargeting:CreateApp" ], "Resource": "arn:aws:mobiletargeting:*:123456789012:*" }, { "Sid": "VisualEditor2", "Effect": "Allow", "Action": [ "ses:TagResource", "ses:Send*", "ses:Create*", "ses:Get*", "ses:List*", "ses:Put*", "ses:Update*", "sms-voice:SendVoiceMessage", "sms-voice:List*", "sms-voice:Create*", "sms-voice:Get*", "sms-voice:Update*" ], "Resource": "*" } ] } ``` ------ **다음**을 선택합니다. 1. **정책 이름**에 정책의 이름을 입력합니다(예: **PostmanAccessPolicy**). **정책 생성**을 선택합니다. 1. (선택 사항) **태그 추가**를 선택하여 정책에 태그를 추가할 수 있습니다. 1. **다음: 검토**를 선택합니다. ## IAM 사용자를 생성합니다. **주의** IAM 사용자는 장기 자격 증명을 가지므로 보안 위험이 있습니다. 이 위험을 줄이려면 이러한 사용자에게 작업을 수행하는 데 필요한 권한만 제공하고 더 이상 필요하지 않을 경우 이러한 사용자를 제거하는 것이 좋습니다. 정책을 생성한 후 사용자를 생성하고 정책을 이 사용자에게 연결할 수 있습니다. 사용자를 생성하면 IAM은 Postman이 Amazon Pinpoint API 작업을 실행하도록 허용하는 데 사용할 수 있는 보안 인증 정보 세트를 제공합니다. **사용자를 생성하려면** 1. IAM 콘솔([https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/))을 엽니다. 1. IAM 콘솔의 탐색 창에서 **사용자**를 선택한 다음, **사용자 생성**을 선택합니다. 1. **사용자 세부 정보**의 **사용자 이름**에 사용자를 식별하는 이름을 입력합니다(예: **PostmanUser**). 그리고 **다음**을 선택합니다. 1. **권한 설정** 아래의 **권한 옵션**에서 **정책 직접 연결**을 선택합니다. 1. **권한 정책**에서 [IAM 정책 생성](#tutorials-using-postman-iam-user-create-policy)에서 생성한 정책(**PostmanAccessPolicy**)을 선택합니다. 그리고 **다음**을 선택합니다. 1. 선택적으로 **검토 및 생성** 페이지에서 사용자를 식별하는 데 도움이 되는 태그를 추가합니다. 태그 사용에 대한 자세한 내용을 알아보려면 *IAM 사용 설명서*의 [IAM 리소스에 태그 지정](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_tags.html)을 참조하세요. 1. 사용자를 생성할 준비가 되면 **사용자 생성**을 선택합니다. ## 액세스 키 생성 **주의** 이 시나리오에서는 프로그래밍 방식 액세스 권한과 장기 보안 인증이 있는 IAM 사용자가 필요하며 이는 보안 위험을 내포합니다. 이 위험을 줄이려면 이러한 사용자에게 작업을 수행하는 데 필요한 권한만 제공하고 더 이상 필요하지 않을 경우 이러한 사용자를 제거하는 것이 좋습니다. 필요한 경우 액세스 키를 업데이트할 수 있습니다. 자세한 내용은 *IAM 사용 설명서*의 [액세스 키 업데이트](https://docs.aws.amazon.com/IAM/latest/UserGuide/id-credentials-access-keys-update.html)를 참조하세요. IAM은 Postman이 Amazon Pinpoint API 작업을 실행하도록 허용하는 데 사용할 수 있는 보안 인증 정보 세트를 제공합니다. **사용자를 생성하려면** 1. IAM 콘솔([https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/))을 엽니다. 1. IAM 콘솔의 탐색 창에서 **사용자**를 선택합니다. [IAM 사용자 생성](#tutorials-using-postman-iam-user-create-user)에서 생성한 사용자(**PostmanUser**)를 선택한 다음 **보안 자격 증명** 탭을 선택합니다. 1. **액세스 키** 섹션에서 **액세스 키 생성**을 선택합니다. 1. **액세스 키 모범 사례 및 대안** 페이지에서 ** AWS외부에서 실행 중인 애플리케이션**을 선택합니다. 그리고 **다음**을 선택합니다. 1. (선택 사항) 정책에 설명 태그를 추가할 수 있습니다. 1. **액세스 키 생성**을 선택합니다. 1. **액세스 키 검색** 페이지에서 **액세스 키** 및 **비밀 액세스 키** 열에 표시되는 보안 인증 정보를 복사합니다. **참고** 이 자습서의 후반부에서 액세스 키 ID와 비밀 액세스 키를 모두 제공해야 합니다. 여기서만 비밀 액세스 키를 볼 수 있습니다. 키를 복사하여 안전한 위치에 저장하는 것이 좋습니다. 1. 두 키를 모두 저장한 후 **완료**를 선택합니다. **다음**: [Postman 설정](tutorials-using-postman-configuration.md) # Amazon Pinpoint와 함께 사용할 Postman 설정 Amazon Pinpoint API에 액세스할 수 있는 사용자를 생성했으므로 이제 Postman을 설정할 수 있습니다. 이 단원에서는 Postman에서 하나 이상의 환경을 생성합니다. 다음에는 Amazon Pinpoint API에서 각 작업에 대한 요청 템플릿이 포함된 컬렉션을 가져옵니다. ## Postman 작업 영역 생성 Postman에서 *워크스페이스*는 프로젝트 및 환경을 위한 조직 컨테이너입니다. 이 단원에서는 Amazon Pinpoint와 함께 사용할 워크스페이스를 하나 이상 생성합니다. **워크스페이스 생성** Postman에서 추가 작업을 선택하고 **파일**을 선택한 다음 **새로 만들기**를 선택합니다. 1. **새로 생성** 창에서 **워크스페이스**를 선택합니다. 1. 이름, 요약을 입력하고 표시 여부를 개인용으로 설정합니다. 그런 다음 **워크스페이스 생성**을 선택합니다. ## Postman 환경 생성 Postman에서 *환경*은 키-값 페어로 저장되는 변수 세트입니다. API 요청 자체를 변경할 필요 없이, 환경을 사용하여 Postman을 통해 수행하는 요청의 구성을 변경할 수 있습니다. 이 단원에서는 Amazon Pinpoint에 사용할 환경을 최소 하나 이상 생성합니다. 생성하는 각 환경에는 단일 AWS 리전에서 계정에 특정한 변수 세트가 포함됩니다. 이 단원의 절차를 사용하여 하나 이상의 환경을 생성하면 Postman의 **환경** 메뉴에서 다른 환경을 선택하여 리전을 전환할 수 있습니다. **환경을 생성하는 방법** 1. Postman에서 추가 작업 메뉴를 선택하고 **파일**을 선택한 다음 **새로 만들기**를 선택합니다. 1. **새로 생성** 창에서 **환경**을 선택합니다. 1. **MANAGE ENVIRONMENTS** 창의 **환경 이름**에 **Amazon Pinpoint - *Region Name***을 입력합니다. *리전 이름*을 다음 값 중 하나로 바꿉니다. + 미국 동부(버지니아 북부) + 미국 서부(오리건) + 아시아 태평양(뭄바이) + 아시아 태평양(시드니) + 유럽(프랑크푸르트) + 유럽(아일랜드) **참고** 최소한 단일에 대해 하나의 환경만 생성하면 되며 AWS 리전, 여기에는 하나의 프로젝트가 포함되어야 AWS 리전 합니다. 이전에 나열된 중 하나에서 프로젝트를 생성하지 않은 경우 [ Amazon Pinpoint 사용 설명서의 이메일 지원을 사용하여 Amazon Pinpoint 프로젝트 생성을](https://docs.aws.amazon.com/pinpoint/latest/userguide/channels-email-setup-create.html) AWS 리전참조하세요. *Amazon Pinpoint * 1. `endpoint`, `region`, `serviceName`, `accountId`, `accessKey` 및 `secretAccessKey`라는 6개의 새 변수를 생성합니다. 다음 표를 사용하여 각 변수의 **초기 값** 및 **현재 값** 열에 어떤 값을 입력해야 하는지 결정합니다. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/pinpoint/latest/userguide/tutorials-using-postman-configuration.html) 이러한 변수를 생성한 후 **MANAGE ENVIRONMENTS** 창은 다음 이미지에 표시된 예제와 비슷합니다. ![\[\]](http://docs.aws.amazon.com/ko_kr/pinpoint/latest/userguide/images/Postman_Tutorial_2.1_4.png) 마쳤으면 **저장**을 선택합니다. **중요** 이전의 이미지에 표시된 액세스 키는 가상의 키입니다. IAM 액세스 키를 다른 사람과 공유하지 마세요. Postman에는 환경을 공유하고 내보낼 수 있는 기능이 포함되어 있습니다. 이러한 기능을 사용하는 경우 액세스 키 ID와 비밀 액세스 키를 이러한 보안 인증 정보에 액세스해서는 안 되는 사람과 공유하지 않도록 주의하세요. 자세한 내용은 *IAM 사용 설명서*의 [IAM 모범 사례](https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html)를 참조하세요. 1. (선택 사항) 생성하려는 각 추가 환경에 대해 1\$14단계를 반복합니다. **작은 정보** Postman에서는 필요한 만큼 환경을 생성할 수 있습니다. 환경을 사용하는 방법은 다음과 같습니다. Amazon Pinpoint API를 테스트해야 하는 모든 리전에 대해 각각 별도의 환경을 생성합니다. 다른 AWS 계정과 연결되는 환경을 생성합니다. 다른 사용자와 연결된 보안 인증 정보를 사용하는 환경을 생성합니다. 1. 환경 생성을 완료하면 다음 단원으로 진행하세요. ## Postman에서 Amazon Pinpoint 컬렉션 생성 Postman에서 *컬렉션*은 API 요청 그룹입니다. 컬렉션의 요청은 일반적으로 공통적인 목적에 따라 통합됩니다. 이 단원에서는 Amazon Pinpoint API의 각 작업에 대한 요청 템플릿이 포함된 새 컬렉션을 생성합니다. **Amazon Pinpoint 컬렉션을 생성하려면** 1. Postman에서 추가 작업 메뉴를 선택하고 **파일**을 선택한 다음 **가져오기**를 선택합니다. 1. **가져오기** 창에서 **링크에서 가져오기**를 선택하고 [https://raw.githubusercontent.com/awsdocs/amazon-pinpoint-developer-guide/master/Amazon%20Pinpoint.postman\$1collection.json](https://raw.githubusercontent.com/awsdocs/amazon-pinpoint-developer-guide/master/Amazon%20Pinpoint.postman_collection.json)이라는 URL을 입력합니다. **가져오기**를 선택합니다. Postman은 120개 예제 요청이 포함된 Amazon Pinpoint 컬렉션을 가져옵니다. ## Postman 구성 테스트 Amazon Pinpoint 컬렉션을 가져온 후 빠른 테스트를 수행하여 모든 구성 요소가 제대로 구성되어 있는지 확인하는 것이 좋습니다. `GetApps` 요청을 제출하여 구성을 테스트할 수 있습니다. 이 요청은 현재 AWS 리전의 Amazon Pinpoint 계정에 있는 모든 프로젝트의 목록을 반환합니다. 이 요청에는 추가 구성이 필요하므로 이 요청은 구성을 테스트하는 좋은 방법입니다. **Amazon Pinpoint 컬렉션의 구성을 테스트하려면** 1. 탐색 창에서 **컬렉션**을 선택하고, **Amazon Pinpoint** 컬렉션을 확장한 다음 **Apps** 폴더를 확장합니다. 1. 요청 목록에서 **GetApps**를 선택합니다. 1. **환경** 선택기를 사용하여 [Postman 환경 생성](#tutorials-using-postman-configuration-create-environments)에서 생성한 환경을 선택합니다. 1. **전송**을 선택합니다. 요청이 성공적으로 전송되면 응답 창에 `200 OK` 상태가 표시됩니다. 다음 이미지의 예제와 비슷한 응답이 보입니다. ![\[\]](http://docs.aws.amazon.com/ko_kr/pinpoint/latest/userguide/images/Postman_Tutorial_2.3_3.png) **참고** 에서 생성된 프로젝트가 없는 경우 AWS 리전 Amazon Pinpoint는를 반환합니다`{ "Item": [] }`. 이 응답에는 3단계에서 선택한 리전의 계정에 있는 모든 Amazon Pinpoint 프로젝트의 목록이 표시됩니다. ### 문제 해결 요청을 제출하면 오류를 볼 수 있습니다. 다음 목록에서 발생할 수 있는 여러 가지 일반적인 오류와 이러한 오류를 해결하기 위해 수행할 수 있는 단계를 참조하세요. | 오류 메시지 | 문제 | 해결 방법 | | --- | --- | --- | | 응답을 받을 수 없음 https://%7B%7Bendpoint%7D%7D/v1/apps에 연결하는 동안 오류가 발생했습니다. | `{{endpoint}}` 변수의 현재 값이 없습니다. 이 값은 환경을 선택할 때 설정됩니다. | 환경 선택기를 사용하여 환경을 선택합니다. | | 요청에 포함된 보안 토큰이 잘못되었습니다. | Postman에서 액세스 키 ID 또는 보안 액세스 키의 현재 값을 찾을 수 없습니다. | 환경 선택기 근처의 기어 아이콘을 선택한 다음 현재 환경을 선택합니다. `accessKey` 및 `secretAccessKey` 값이 **INITIAL VALUE** 및 **CURRENT VALUE** 열에 모두 나타나고, 보안 인증 정보를 올바르게 입력했는지 확인합니다. | | "Message": "User: arn:aws:iam::123456789012:user/PinpointPostmanUser is not authorized to perform: mobiletargeting:GetApps on resource: arn:aws:mobiletargeting:us-west-2:123456789012:\$1" | 사용자와 연결된 IAM 정책에 적절한 권한이 포함되어 있지 않습니다. | 사용자가 [IAM 정책 생성](tutorials-using-postman-iam-user.md#tutorials-using-postman-iam-user-create-policy)에서 설명한 권한을 보유하고 있고 [Postman 작업 영역 생성](#tutorials-using-postman-configuration-create-environments)에서 환경을 생성할 때 올바른 자격 증명을 제공했는지 확인합니다. | **다음**: [추가 요청 전송](tutorials-using-postman-sample-requests.md) # 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": "" } } } ```