You are viewing the Portuguese (Brazil) site, but your language preference is set to English. Switch to English site →
Rate this page:

Introdução à API do SendGrid

Há várias maneiras de começar a usar a API do SendGrid.

Pré-requisitos para enviar seu primeiro e-mail com a API do SendGrid

Estas instruções descrevem como enviar seu primeiro e-mail usando chamadas cURL. Esta é uma das muitas maneiras de enviar e-mails com a API do SendGrid. Além disso, temos bibliotecas PHP, Python, Node.js, Java, C#, Go e Ruby.

Antes de começar a usar a API, você precisa fazer o seguinte:

  1. Criar uma [conta] no SendGrid(https://sendgrid.com/pricing/).
  2. Criar uma chave de API.
  3. Verificar se o curl está instalado no seu equipamento.

O cURL é padrão nos sistemas operacionais Mac.

Como enviar um e-mail usando a API

Crie sua chamada de API

Sua chamada de API deve ter os seguintes componentes:

Um host: o host para solicitações Web API v3 sempre é https://api.sendgrid.com/v3/Um cabeçalho de autorização: uma chave de API deve ser incluída no cabeçalho de autorização. – Uma solicitação: Ao enviar dados para um recurso via POST ou PUT, você deve enviar o payload em JSON.

Limite de tamanho da mensagem: O tamanho total da mensagem não deve exceder 20 MB. Isso inclui a mensagem em si, os cabeçalhos e o tamanho combinado de quaisquer anexos.

Observe que a autenticação básica não é mais aceita; você deve usar uma chave de API.

Como enviar um e-mail usando a API do SendGrid:

curl --request POST \
--url https://api.sendgrid.com/v3/mail/send \
--header 'Authorization: Bearer <<YOUR_API_KEY>>' \
--header 'Content-Type: application/json' \
--data '{"personalizations":[{"to":[{"email":"john.doe@example.com","name":"John Doe"}],"subject":"Hello, World!"}],"content": [{"type": "text/plain", "value": "Heya!"}],"from":{"email":"sam.smith@example.com","name":"Sam Smith"},"reply_to":{"email":"sam.smith@example.com","name":"Sam Smith"}}'
  1. Copie o exemplo de curl acima.
  2. Cole a chamada curl no seu editor de texto de preferência.
  3. Copie sua chave de API e cole-a no cabeçalho "Authorization" .
  4. Na seção de dados, especifique os nomes em "to", "from", "reply to" e os endereços de e-mail e digite um assunto.
  5. Copie o código e cole-o em seu terminal.
  6. Pressione Enter.
  7. Verifique a caixa de entrada do endereço de e-mail especificado como "to" e veja sua mensagem!

Se você ainda não configurou a Sender Authentication (Autenticação do remetente) em sua conta, talvez seja necessário procurar o e-mail que acabou de enviar em sua pasta de spam.

Mensagens de resposta da API

Todas as respostas são retornadas no formato JSON. Especificamos isso ao enviar o cabeçalho Content-Type . A Web API v3 fornece uma seleção de opções de códigos de resposta, cabeçalhos de tipo de conteúdo, e paginação para ajudar você a interpretar as respostas às suas solicitações de API.

Obtenha suporte adicional para a integração. Economize tempo, aumente a qualidade do seu envio e sinta-se confiante de que está preparado para o sucesso de longo prazo com o SendGrid Onboarding Services.

Próximas etapas

Para obter mais informações sobre o SendGrid e onde você pode chegar com ele, confira estas páginas:

Referência à APIAutenticação do remetenteComo automatizar subusuários

Rate this page:

Precisa de ajuda?

We all do sometimes; code is hard. Get help now from our support team, or lean on the wisdom of the crowd browsing the SendGrid tag on Stack Overflow.

        
        
        

        Thank you for your feedback!

        We are always striving to improve our documentation quality, and your feedback is valuable to us. How could this documentation serve you better?

        Sending your feedback...
        🎉 Thank you for your feedback!
        Something went wrong. Please try again.

        Thanks for your feedback!

        Refer us and get $10 in 3 simple steps!

        Step 1

        Get link

        Get a free personal referral link here

        Step 2

        Give $10

        Your user signs up and upgrade using link

        Step 3

        Get $10

        1,250 free SMSes
        OR 1,000 free voice mins
        OR 12,000 chats
        OR more