Wrapper APIs

Wrapper-APIs

Wrapper-APIs stellen sicher, dass die Entwickler beim Wechsel ihres Codes von einer unserer Mitbewerber auf die Netcore Email API keinen Code neu schreiben müssen.

Das einzige, was ein Entwickler tun muss, wenn er von unterstützten Wettbewerbern wechselt, ist, den API-Schlüssel und den Pfad der API-URL von den vom Wettbewerb bereitgestellten Werten in die von der Netcore Email API bereitgestellten Werte zu ändern, und er kann mit dem Senden von E-Mails sowie allen anderen Aktionen beginnen B. Berichterstellung, Domänenverwaltung usw., die von der Netcore E-Mail-API-Plattform unterstützt werden.

Leistungen

  • Einfache Integration - Integrieren Sie in 3 einfachen Schritten, ohne zu viel Zeit mit Codieren und Neucodieren zu verbringen.
  • Wiederverwendbarkeit des Codes - Verschwenden Sie nicht Ihre Zeit und Energie damit, erneut zu programmieren, wir haben uns bereits darum gekümmert. Alle Ihre Anfrage- und Antwortformate bleiben absolut gleich. Ändern Sie einfach API-Schlüssel und URLs und schon können Sie loslegen.
  • Minimale Tests - Keine Codeänderung bedeutet auch keine wiederholte QA. Ihr Code wird einfach funktionieren!

Derzeit unterstützt

Schritte

Voraussetzungen

Schritte zur API-Integration

  1. Ändern Sie den API-Schlüssel Ihres aktuellen Providers in Netcore Email API
  2. Ändern Sie die URL Ihres aktuellen Anbieters in die entsprechende URL, die von Netcore Email API bereitgestellt wird
  3. Bereitstellen und testen.

Beispiele

Sendegitter

Netcore E-Mail-API-URL für die Sendgrid-Migration - https://sgapi.netcorecloud.net

Beispiel für einen SendGrid API v3-Aufruf:

curl --request POST \
--url https://api.sendgrid.com/v3/mail/send \
--header 'authorization: Bearer <YOUR SENDGRID API KEY>' \
--header 'content-type: application/json' \
--data '{"personalizations":[{"to":[{"email":"<RECIPIENT EMAIL ID>","name":"<RECIPIENT NAME>"}],"subject":"This is a test mail"}],"content": [{"type": "text/plain", "value": "Hello, How are you?"}],"from":{"email":"<FROM EMAIL ID>","name":"<FROM NAME>"}}'

Netcore Email API Wrapper API-Version für die Migration (Hinweis: Der einzige Unterschied besteht in URL und API-Schlüssel)

curl --request POST \
--url https://sgapi.netcorecloud.net/v3/mail/send \
--header 'authorization: Bearer <YOUR PEPIPOST API KEY>' \
--header 'content-type: application/json'  \
--data '{"personalizations":[{"to":[{"email":"<RECIPIENT EMAIL ID>","name":"<RECIPIENT NAME>"}],"subject":"This is a test mail"}],"content": [{"type": "text/plain", "value": "Hello, How are you?"}],"from":{"email":"<FROM EMAIL ID>","name":"<FROM NAME>"}}'

Mailgun

Netcore E-Mail-API-URL für die Mailgun-Migration - https://mgapi.netcorecloud.net

Beispiel für Mailgun API V3-Aufruf:

curl -s --user 'api:<MAILGUN API KEY>' \
https://api.mailgun.net/v3/<SENDING DOMAIN>/messages \
-F from='<FROM NAME><<FROM EMAILID>>' \
    -F to='<RECIPIENT EMAILID' \
    -F subject='Hello' \
    -F text='Testing some Mailgun awesomeness!'
<?php
# Include the Autoloader (see "Libraries" for install instructions)
require 'vendor/autoload.php';
use Mailgun\Mailgun;

$client = new \Http\Adapter\Guzzle6\Client();
$mgClient = new \Mailgun\Mailgun('<MAILGUN API KEY>', $client);

# Instantiate the client.
$domain = "<SENDING DOMAIN>";

# Make the call to the client.
$result = $mgClient->sendMessage($domain, array(
    'from'    => '<FROM NAME> <<FROM EMAIL>>',
    'to'      => '<RECIPIENT NAME> <<RECIPIENT EMAIL>>',
    'subject' => 'Hello',
    'text'    => 'Testing some Mailgun awesomness!'
));
?>

Netcore Email API Wrapper API-Version für die Migration (Hinweis: Der einzige Unterschied besteht in URL und API-Schlüssel)

curl -s --user 'api:<PEPIPOST API KEY>' \
    https://mgapi.netcorecloud.net/v3/<SENDING DOMAIN>/messages \
    -F from='<FROM NAME> <FROM EMAILID>' \
    -F to='<RECIPIENT EMAILID' \
    -F subject='Hello' \
    -F text='Testing some Mailgun awesomeness!'
<?php
# Include the Autoloader (see "Libraries" for install instructions)
require 'vendor/autoload.php';
use Mailgun\Mailgun;

$client = new \Http\Adapter\Guzzle6\Client();
$mgClient = new \Mailgun\Mailgun('<PEPIPOST API KEY>', $client,'mgapi.pepipost.com');     //Changed API KEY and Added PEPIPOST DOMAIN
$mgClient->setApiVersion('v3');    //Changed API Version

# Instantiate the client.

$domain = "<SENDING DOMAIN>";

# Make the call to the client.
$result = $mgClient->sendMessage($domain, array(
    'from'    => '<FROM NAME> <<FROM EMAIL>>',
    'to'      => '<RECIPIENT NAME> <<RECIPIENT EMAIL>>',
    'subject' => 'Hello',
    'text'    => 'Testing some Mailgun awesomness!'
));
?>

Was ist abgedeckt?

SENDGRID

  • E-Mail senden (POST) - /v3/mail/send
  • Vorlage hinzufügen (POST) - /v3/templates/{template_id}/versions
  • Vorlagenansicht (GET) - /v3/templates/{template_id}
  • Vorlagenbearbeitung (PATCH) - /v3/templates/{template_id}/versions/{version_id}
  • Statistik (GET) - /v3/stats?start_date=2018-11-01&end_date=2018-12-10&aggregiert_by=month&limit=1&offset=2
  • Kategorien abrufen - /v3/categories
  • Unterdrückung hinzufügen (POST) - /v3/asm/groups/<group_id>/suppressions
  • Globale Unterdrückung (POST) hinzufügen - /v3/asm/suppressions/global (bearbeitet)

MAILGUN

  • E-Mail senden (POST) - /v3/<domain_name>/messages
  • Statistiken abrufen - /v3/<domain_name>/stats
  • Tag abrufen - /v3/<DOMAIN_NAME>/tags
  • Einzelnes Tag anzeigen - /v3/<domain_name>/tags/<tag_name>
  • Domain hinzufügen (POST) - /v3/domains
  • Einzelne E-Mail-ID auf der Whitelist (DELETE) - /v3/<domain_name>/bounces/, /v3/<domain_name>/unsubscribes/, /v3/<domain_name>/complaints/
  • Unterdrückung hinzufügen (POST) - /v3/<domain_name>/bounces, /v3/<domain_name>/complaints, /v3/<domain_name>/unsubscribes (bearbeitet)