As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Verificar identidades de e-mail usando a API do Amazon SES e o AWS SDK para PHP versão 3
Quando você começar a usar sua conta do Amazon Simple Email Service (Amazon SES), todos os remetentes e destinatários devem ser verificados na mesma região da AWS para a qual seus e-mails são enviados. Para obter mais informações sobre o envio de e-mails, consulte [Envio de e-mail com o Amazon SES](https://docs.aws.amazon.com/ses/latest/DeveloperGuide/sending-email.html).
Os exemplos a seguir mostram como:
+ Verifique um endereço de e-mail com o [VerifyEmailIdentity](https://docs.aws.amazon.com/aws-sdk-php/v3/api/api-email-2010-12-01.html#verifyemailidentity).
+ Verifique um domínio de e-mail com o [VerifyDomainIdentity](https://docs.aws.amazon.com/aws-sdk-php/v3/api/api-email-2010-12-01.html#verifydomainidentity).
+ Liste todos os endereços de e-mail com o [ListIdentities](https://docs.aws.amazon.com/aws-sdk-php/v3/api/api-email-2010-12-01.html#listidentities).
+ Liste todos os domínios de e-mail com o [ListIdentities](https://docs.aws.amazon.com/aws-sdk-php/v3/api/api-email-2010-12-01.html#listidentities).
+ Exclua um endereço de e-mail com o [DeleteIdentity](https://docs.aws.amazon.com/aws-sdk-php/v3/api/api-email-2010-12-01.html#deleteidentity).
+ Exclua um domínio de e-mail com o [DeleteIdentity](https://docs.aws.amazon.com/aws-sdk-php/v3/api/api-email-2010-12-01.html#deleteidentity).
O código de exemplo completo do AWS SDK para PHP está disponível [aqui no GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/php/example_code).
## Credenciais
Antes de executar o código de exemplo, configure suas credenciais da AWS, conforme descrito em [Autenticando com o AWS uso da AWS SDK para PHP versão 3](credentials.md). Em seguida, importe o AWS SDK para PHP, conforme descrito em [Instalando a AWS SDK para PHP versão 3](getting-started_installation.md).
Para obter mais informações sobre o uso do Amazon SES, consulte o [Guia do desenvolvedor do Amazon SES](https://docs.aws.amazon.com/ses/latest/DeveloperGuide/).
## Verificar endereços de e-mail
O Amazon SES somente pode enviar e-mails de endereços ou domínios de e-mail verificados. Ao verificar um endereço de e-mail, demonstre que é o proprietário desse endereço e deseja conceder permissão ao Amazon SES para enviar e-mails desse endereço.
Ao executar o exemplo de código a seguir, o Amazon SES envia um e-mail para o endereço especificado. Quando você (ou o destinatário do e-mail) clicar no link do e-mail, o endereço será verificado.
Para adicionar um endereço de e-mail à sua conta do Amazon SES, utilize a operação [VerifyEmailIdentity](https://docs.aws.amazon.com/ses/latest/APIReference/API_VerifyEmailIdentity.html).
**Importações**
```
require 'vendor/autoload.php';
use Aws\Exception\AwsException;
```
**Código de exemplo**
```
$SesClient = new Aws\Ses\SesClient([
'profile' => 'default',
'version' => '2010-12-01',
'region' => 'us-east-2'
]);
$email = 'email_address';
try {
$result = $SesClient->verifyEmailIdentity([
'EmailAddress' => $email,
]);
var_dump($result);
} catch (AwsException $e) {
// output error message if fails
echo $e->getMessage();
echo "\n";
}
```
## Verificar um domínio de e-mail
O Amazon SES somente pode enviar e-mails de endereços ou domínios de e-mail verificados. Ao verificar um domínio, demonstre que é o proprietário desse domínio. Ao verificar um domínio, você permite que o Amazon SES envie e-mails de qualquer endereço nesse domínio.
Ao executar o exemplo de código a seguir, o Amazon SES fornece um token de verificação. É necessário adicionar o token para configuração de DNS do seu domínio. Para obter mais informações, consulte [Verificar um domínio com o Amazon SES](https://docs.aws.amazon.com/ses/latest/DeveloperGuide/verify-domain-procedure.html) no Guia do desenvolvedor do Amazon Simple Email Service.
Para adicionar um domínio de envio à sua conta do Amazon SES, utilize a operação [VerifyDomainIdentity](https://docs.aws.amazon.com/ses/latest/APIReference/API_VerifyDomainIdentity.html).
**Importações**
```
require 'vendor/autoload.php';
use Aws\Exception\AwsException;
```
**Código de exemplo**
```
$SesClient = new Aws\Ses\SesClient([
'profile' => 'default',
'version' => '2010-12-01',
'region' => 'us-east-2'
]);
$domain = 'domain.name';
try {
$result = $SesClient->verifyDomainIdentity([
'Domain' => $domain,
]);
var_dump($result);
} catch (AwsException $e) {
// output error message if fails
echo $e->getMessage();
echo "\n";
}
```
## Listar endereços de e-mail
Para recuperar uma lista de endereços de e-mail enviada à região atual da AWS, independentemente do status de verificação, utilize a operação [ListIdentities](https://docs.aws.amazon.com/ses/latest/APIReference/API_ListIdentities.html).
**Importações**
```
require 'vendor/autoload.php';
use Aws\Exception\AwsException;
```
**Código de exemplo**
```
$SesClient = new Aws\Ses\SesClient([
'profile' => 'default',
'version' => '2010-12-01',
'region' => 'us-east-2'
]);
try {
$result = $SesClient->listIdentities([
'IdentityType' => 'EmailAddress',
]);
var_dump($result);
} catch (AwsException $e) {
// output error message if fails
echo $e->getMessage();
echo "\n";
}
```
## Listar domínios de e-mail
Para recuperar uma lista de domínios de e-mail enviada à região atual da AWS, independentemente do status de verificação, utilize a operação [ListIdentities](https://docs.aws.amazon.com/ses/latest/APIReference/API_ListIdentities.html).
**Importações**
```
require 'vendor/autoload.php';
use Aws\Exception\AwsException;
```
**Código de exemplo**
```
$SesClient = new Aws\Ses\SesClient([
'profile' => 'default',
'version' => '2010-12-01',
'region' => 'us-east-2'
]);
try {
$result = $SesClient->listIdentities([
'IdentityType' => 'Domain',
]);
var_dump($result);
} catch (AwsException $e) {
// output error message if fails
echo $e->getMessage();
echo "\n";
}
```
## Excluir um endereço de e-mail
Para excluir um endereço de e-mail verificado na lista de identidades, utilize a operação [DeleteIdentity](https://docs.aws.amazon.com/ses/latest/APIReference/API_DeleteIdentity.html).
**Importações**
```
require 'vendor/autoload.php';
use Aws\Exception\AwsException;
```
**Código de exemplo**
```
$SesClient = new Aws\Ses\SesClient([
'profile' => 'default',
'version' => '2010-12-01',
'region' => 'us-east-2'
]);
$email = 'email_address';
try {
$result = $SesClient->deleteIdentity([
'Identity' => $email,
]);
var_dump($result);
} catch (AwsException $e) {
// output error message if fails
echo $e->getMessage();
echo "\n";
}
```
## Excluir um domínio de e-mail
Para excluir um domínio de e-mail verificado na lista de identidades verificadas, utilize a operação [DeleteIdentity](https://docs.aws.amazon.com/ses/latest/APIReference/API_DeleteIdentity.html).
**Importações**
```
require 'vendor/autoload.php';
use Aws\Exception\AwsException;
```
**Código de exemplo**
```
$SesClient = new Aws\Ses\SesClient([
'profile' => 'default',
'version' => '2010-12-01',
'region' => 'us-east-2'
]);
$domain = 'domain.name';
try {
$result = $SesClient->deleteIdentity([
'Identity' => $domain,
]);
var_dump($result);
} catch (AwsException $e) {
// output error message if fails
echo $e->getMessage();
echo "\n";
}
```