Configurare Postman per l'utilizzo con Amazon Pinpoint - Amazon Pinpoint

Avviso di fine del supporto: il 30 ottobre 2026 AWS terminerà il supporto per Amazon Pinpoint. Dopo il 30 ottobre 2026, non potrai più accedere alla console Amazon Pinpoint o alle risorse Amazon Pinpoint (endpoint, segmenti, campagne, percorsi e analisi). Per ulteriori informazioni, consulta la pagina relativa alla fine del supporto di Amazon Pinpoint. Nota: per quanto APIs riguarda gli SMS, i comandi vocali, i messaggi push su dispositivi mobili, l'OTP e la convalida del numero di telefono non sono interessati da questa modifica e sono supportati da AWS End User Messaging.

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Configurare Postman per l'utilizzo con Amazon Pinpoint

Dopo aver creato un account utente in grado di accedere all'API Amazon Pinpoint, puoi configurare Postman. In questa sezione, crea uno o più ambienti in Postman. Quindi, importa una raccolta contenente modello di richiesta di ciascuna delle operazioni nell'API Amazon Pinpoint.

In Postman, un workspace è un container organizzativo per progetti e ambienti. In questa sezione, dovrai creare almeno un workspace da utilizzare con Amazon Pinpoint.

Creare un'area di lavoro

In Postman, scegli Altre azioni, quindi seleziona File, Nuovo.

  1. Nella finestra Crea nuovo, scegli Workspace.

  2. Inserisci un nome, un riepilogo e imposta la visibilità su Personale. Quindi, scegli Crea workspace.

In Postman, un ambiente è un set di variabili che vengono memorizzate come coppie chiave-valore. È possibile utilizzare gli ambienti per modificare la configurazione delle richieste effettuate tramite Postman, senza dover modificare le richieste API.

In questa sezione, dovrai creare almeno un ambiente da utilizzare con Amazon Pinpoint. Ogni ambiente creato contiene un set di variabili specifiche per l'account in un'unica Regione AWS. Se utilizzi le procedure di questa sezione per creare più di un ambiente, puoi passare da una regione a un'altra selezionando un ambiente diverso nel menu Ambiente in Postman.

Per creare un ambiente

  1. In Postman, scegli il menu Altre azioni, quindi seleziona File, Nuovo.

  2. Nella finestra Create New (Crea nuovo), scegliere Environment (Ambiente).

  3. Nella finestra MANAGE ENVIRONMENTS (GESTISCI AMBIENTI), per Environment Name (Nome ambiente), inserire Amazon Pinpoint - Region Name. Sostituisci Region Name con uno dei seguenti valori:

    • Stati Uniti orientali (Virginia settentrionale)

    • US West (Oregon)

    • Asia Pacifico (Mumbai)

    • Asia Pacifico (Sydney)

    • Europa (Francoforte)

    • Europa (Irlanda)

    Nota

    È necessario creare almeno un ambiente per ogni singolo ambiente Regione AWS, che Regione AWS deve contenere un solo progetto. Se non hai creato un progetto in uno dei progetti elencati in precedenza Regioni AWS, consulta Creazione di un progetto Amazon Pinpoint con supporto via e-mail nella Guida per l'utente di Amazon Pinpoint.

  4. Creare sei nuove variabili: endpoint, region, serviceName, accountId, accessKey e secretAccessKey. Utilizza la tabella seguente per determinare il valore da inserire nelle colonne Valore iniziale e Valore corrente per ogni variabile.

    Regione Variabile Valore iniziale/Valore corrente
    Stati Uniti orientali (Virginia settentrionale) endpoint pinpoint.us-east-1.amazonaws.com
    region us-east-1
    serviceName mobiletargeting
    accountId (l'ID del tuo AWS account)
    accessKey (ID della chiave di accesso IAM)
    secretAccessKey (chiave di accesso segreta IAM)
    US West (Oregon) endpoint pinpoint.us-west-2.amazonaws.com
    region us-west-2
    serviceName mobiletargeting
    accountId (l'ID AWS del tuo account)
    accessKey (ID della chiave di accesso IAM)
    secretAccessKey (chiave di accesso segreta IAM)
    Asia Pacifico (Mumbai) endpoint pinpoint.ap-south-1.amazonaws.com
    region ap-south-1
    serviceName mobiletargeting
    accountId (l'ID AWS del tuo account)
    accessKey (ID della chiave di accesso IAM)
    secretAccessKey (chiave di accesso segreta IAM)
    Asia Pacifico (Sydney) endpoint pinpoint.ap-southeast-2.amazonaws.com
    region ap-southeast-2
    serviceName mobiletargeting
    accountId (l'ID AWS del tuo account)
    accessKey (ID della chiave di accesso IAM)
    secretAccessKey (chiave di accesso segreta IAM)
    Europa (Francoforte) endpoint pinpoint.eu-central-1.amazonaws.com
    region eu-central-1
    serviceName mobiletargeting
    accountId (l'ID AWS del tuo account)
    accessKey (ID della chiave di accesso IAM)
    secretAccessKey (chiave di accesso segreta IAM)
    Europa (Irlanda) endpoint pinpoint.eu-west-1.amazonaws.com
    region eu-west-1
    serviceName mobiletargeting
    accountId (l'ID AWS del tuo account)
    accessKey (ID della chiave di accesso IAM)
    secretAccessKey (chiave di accesso segreta IAM)

    Una volta create queste variabili, l'aspetto della finestra MANAGE ENVIRONMENTS (GESTISCI AMBIENTI) è simile a quello dell'esempio mostrato nella seguente immagine.

    Finestra Gestisci ambienti in Postman. Lo screenshot mostra un ambiente "US East (N. Virginia)" (Stati Uniti orientali (Virginia settentrionale)). L'ambiente contiene le seguenti variabili: Una variabile denominata «endpoint» e un valore iniziale di»pinpoint.us-east-1.amazonaws.com". Variabile denominata "region" con un valore iniziale di "us-east-1". Variabile denominata "serviceName" con un valore iniziale di "mobiletargeting". Una variabile denominata «accountID» e un valore iniziale di 123456789012 (un ID account fittizio). AWS Una variabile denominata «AccessKey» e un valore iniziale di AKIAIOSFODNN7EXAMPLE (un ID di chiave di accesso fittizio). Una variabile denominata "secretAccessKey" e un valore iniziale di wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY (una chiave di accesso segreta fittizia).

    Al termine, scegli Salva.

    Importante

    Le chiavi di accesso mostrate nell'immagine precedente sono fittizie. Non condividere le chiavi di accesso IAM con altri utenti.

    Postman include funzionalità che consentono di condividere ed esportare ambienti. Se utilizzi queste funzionalità, assicurati di non condividere l'ID chiave di accesso e la chiave di accesso segreta con chiunque non debba avere accesso a tali credenziali.

    Per ulteriori informazioni, consultare la sezione best practice IAM nella Guida per l'utente IAM.

  5. (Facoltativo) Ripeti i passaggi da 1 a 4 per ogni altro ambiente che desideri creare.

    Suggerimento

    In Postman, è possibile creare tutti gli ambienti di cui si ha bisogno. Puoi utilizzare gli ambienti nei seguenti modi:

    • Creare un ambiente separato per ogni regione in cui è necessario testare l'API Amazon Pinpoint.

    • Creare ambienti associati a diversi Account AWS.

    • Creare ambienti che utilizzano credenziali associate a un altro utente.

  6. Una volta terminata la creazione di ambienti, procedere alla sezione successiva.

In Postman, una raccolta è un gruppo di richieste API. Le richieste in una raccolta sono in genere unite da uno scopo comune. In questa sezione, dovrai creare una nuova raccolta contenente un modello di richiesta per ciascuna operazione nell'API Amazon Pinpoint.

Per creare la raccolta Amazon Pinpoint

  1. In Postman, scegli il menu Altre azioni, quindi seleziona File, Importa.

  2. Nella finestra Importa, scegli Importa da link, quindi inserisci il seguente URL: https://raw.githubusercontent.com/awsdocs/amazon-pinpoint-developer-guide/master/Amazon %20Pinpoint.postman_collection.json.

    Seleziona Importa. Postman importa la raccolta Amazon Pinpoint, contenente 120 richieste di esempio.

Dopo aver importato la raccolta Amazon Pinpoint, è consigliabile eseguire un test rapido per verificare la corretta configurazione di tutti i componenti. È possibile provare la configurazione inviando una richiesta GetApps. Questa richiesta restituisce l'elenco di tutti i progetti esistenti nell'account Amazon Pinpoint nella Regione AWS attuale. Questa richiesta non necessita di configurazioni aggiuntive e per tale motivo rappresenta un valido modo per testare la configurazione.

Per testare la configurazione della raccolta Amazon Pinpoint

  1. Nel riquadro di navigazione, seleziona Raccolte, espandi la raccolta Amazon Pinpoint e quindi espandi la cartella App.

  2. Nell'GetAppselenco delle richieste, scegli.

  3. Usa il selettore Ambiente per scegliere l'ambiente che hai creato in Ambienti Create Postman.

  4. Scegli Invia. Se la richiesta viene inviata correttamente, il riquadro di risposta mostra lo stato 200 OK. Viene visualizzata una risposta simile all'esempio riportato nella seguente immagine.

    La risposta mostra valori di esempio per Name, Id, Arn e Tags.
    Nota

    Se non hai creato alcun progetto nel, Regione AWS restituisce Amazon Pinpoint. { "Item": [] }

    Questa risposta mostra l'elenco di tutti i progetti Amazon Pinpoint esistenti nell'account nella regione scelta al Passaggio 3.

Risoluzione dei problemi

Quando invii la richiesta, è possibile che venga visualizzato un errore. Di seguito sono elencati i diversi errori comuni che possono verificarsi e le relative fasi per la risoluzione.

Messaggio di errore Problema Risoluzione

Could not get any response (Impossibile ottenere una risposta)

There was an error connecting to https://%7B%7Bendpoint%7D%7D/v1/apps. (Si è verificato un errore durante la connessione a https://%7B%7Bendpoint%7D%7D/v1/apps.)

Non esiste alcun valore attuale per la variabile {{endpoint}}, che è impostata quando scegli un ambiente.

Utilizza il selettore di ambiente per scegliere un ambiente.

Il token di sicurezza incluso nella richiesta non è valido.

Postman non era in grado di individuare il valore attuale dell'ID chiave di accesso o della chiave di accesso segreta.

Scegli l'icona a forma di ingranaggio accanto al selettore di ambiente e quindi scegli l'ambiente attuale. Assicurati che i valori accessKey e secretAccessKey vengano visualizzati in entrambe le colonne VALORE INIZIALE e VALORE CORRENTE e verifica di aver inserito le credenziali correttamente.

«Message»: «User: arn:aws:iam: :123456789012:user/ non PinpointPostmanUser è autorizzato a eseguire: mobiletargeting: on resource: arn:aws:mobiletargeting:us-west- 2:123456789012: *» GetApps

La policy IAM associata all'utente non include le autorizzazioni appropriate.

Verifica che il tuo utente disponga delle autorizzazioni descritte in Creare una policy IAM e di aver fornito le credenziali corrette quando hai creato l'ambiente nell'area di lavoro Create Postman.

Successivo: Invio di richieste aggiuntive