Email Sender Address(Last Updated : 01/04/2017)
You must register your email in order to send emails through our system. You can register and remove your sender addresses through this function.
Methods
PUT | /rest/v1/{user_name}/email/sender |
GET | /rest/v1/{user_name}/email/sender |
GET | /rest/v1/{user_name}/email/sender/{sender_id} |
POST | /rest/v1/{user_name}/email/sender/{sender_id}/default |
DELETE | /rest/v1/{user_name}/email/sender/{sender_id} |
PUT Email Sender Address
Register an email sender address.
When you perform a PUT Email Sender Address request, you will receive a verification email. In order to use the email address, you must verify it using the verification link sent from the system.
Resource Information
Response Formats | JSON |
Allowed Methods | PUT |
URL | http://api.trumpia.com/rest/v1/{user_name}/email/sender |
{user_name} | Your account username (this can be found in the Account Settings page after logging in.) |
Header Parameters
Parameter | Description |
---|---|
Content-Type * | application/json |
X-Apikey * | Your API key (This can be found in the API Settings page after logging in.) Example value: 123456789abc1011 |
Body Parameters
Parameter | Description |
---|---|
address * | Register email address for "From:" or "Reply To:" address. The maximum length for a message is 100 characters. |
Code sample for PUT Email Sender Address
"Request Example:"
"PUT http://api.trumpia.com/rest/v1/{user_name}/email/sender"
{
"address" : "email0001@api.trumpia.com
}
"Response Example (Success):"
{
"request_id" : "1234561234567asdf123",
"sender_id" : 987987987980,
"status_code" : "MPCE0000"
}
"Response Example (Failure):"
{
"request_id" : "1234561234567asdf123",
"status_code" : "MPDE1101"
}
<?
// PUT Email Sender Address - Register an email sender address.
include "request_rest.php";
$request_url = "http://api.trumpia.com/rest/v1/{user_name}/email/sender";
$request_data = array(
"address" => "myemail@testemail123.com"
);
$request_rest = new RestRequest();
$request_rest->setRequestURL($request_url);
$request_rest->setAPIKey("{api_key}");
$request_rest->setRequestBody(json_encode($request_data));
$request_rest->setMethod("PUT");
$result = $request_rest->execute();
$response_status = $result[0];
$json_response_data = $result[1];
if ($response_status == "200") { //success
$response_data = json_decode($json_response_data);
echo "sender_id : " . $response_data->sender_id;
echo "request_id : " . $response_data->request_id;
echo "status_code : " . $response_data->status_code;
} else {
echo $response_status ." - connection failure";
}
?>
// PUT Email Sender Address - Register an email sender address.
<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%>
<%@ page import="org.json.simple.JSONArray" %>
<%@ page import="org.json.simple.JSONObject" %>
<%@ page import="java.io.BufferedReader" %>
<%@ page import="java.io.IOException" %>
<%@ page import="java.io.InputStreamReader" %>
<%@ page import="java.io.OutputStream" %>
<%@ page import="java.io.OutputStreamWriter" %>
<%@ page import="java.io.Writer" %>
<%@ page import="java.net.HttpURLConnection" %>
<%@ page import="java.net.URL" %>
<html>
<title>Email Sender Put Sample Code</title>
<body>
<%
String username = "username";
JSONObject emailSenderPut = new JSONObject();
emailSenderPut.put("address", "myemail@testemail123.com");
String urlStr = "http://api.trumpia.com/rest/v1/" + username + "/email/sender";
URL url = new URL(urlStr);
HttpURLConnection conn = (HttpURLConnection) url.openConnection();
conn.setRequestMethod("PUT");
conn.setDoOutput(true);
conn.setDoInput(true);
conn.setUseCaches(false);
conn.setAllowUserInteraction(false);
conn.setRequestProperty("Content-type", "application/json");
conn.setRequestProperty("X-Apikey", "12345aaaaa67890aaaaa");
OutputStream outPutStream = conn.getOutputStream();
Writer writer = new OutputStreamWriter(outPutStream, "UTF-8");
writer.write(emailSenderPut.toJSONString());
writer.close();
outPutStream.close();
if (conn.getResponseCode() != 200) {
%>
Error : <%=conn.getResponseMessage()%>
<%
}else{
// Buffer the result into a string
BufferedReader rd = new BufferedReader(new InputStreamReader(conn.getInputStream()));
StringBuilder sb = new StringBuilder();
String line;
while ((line = rd.readLine()) != null) {
sb.append(line);
}
rd.close();
conn.disconnect();
%>
Response : <%=sb.toString()%>
<%
}
%>
</body>
</html>
// PUT Email Sender Address - Register an email sender address.
using Newtonsoft.Json;
using Newtonsoft.Json.Linq;
using System;
using System.Collections.Generic;
using System.Linq;
using System.Net.Http;
using System.Net.Http.Headers;
using System.Text;
using System.Threading.Tasks;
namespace samplecode
{
class EmailSenderInfo
{
public string address { get; set; }
}
class Result
{
public string request_id { get; set; }
public string sender_id { get; set; }
public string status_code { get; set; }
}
class EmailSenderPut
{
static void Main()
{
RunAsync().Wait();
}
static async Task RunAsync()
{
using (var client = new HttpClient())
{
var apikey = "12345aaaaa67890aaaaa";
client.DefaultRequestHeaders.Accept.Clear();
client.DefaultRequestHeaders.Accept.Add(new MediaTypeWithQualityHeaderValue("application/json"));
client.DefaultRequestHeaders.Add("X-Apikey", string.Format("{0}", apikey));
var username = "username";
var emailSenderAddress = "myemail@testemail123.com";
//PUT
var info = new EmailSenderInfo() { address = emailSenderAddress };
Uri putUrl = new Uri(string.Format("http://api.trumpia.com/rest/v1/{0}/email/sender", username));
var response = client.PutAsJsonAsync(putUrl, info).Result;
if (response.IsSuccessStatusCode)
{
var p = response.Content.ReadAsAsync<Result>().Result;
string json = JsonConvert.SerializeObject(p);
Console.WriteLine(json);
}
}
}
}
}
GET Email Sender Address
Look up the IDs of created email sender addresses, or look up detailed information for a specific email sender address.
Resource Information
Response Formats | JSON |
Allowed Methods | GET |
URL |
http://api.trumpia.com/rest/v1/{user_name}/email/sender http://api.trumpia.com/rest/v1/{user_name}/email/sender/{sender_id}
|
{user_name} | Your account username (this can be found in the Account Settings page after logging in.) |
{sender_id} | The sender_id you wish to look up. |
Header Parameters
Parameter | Description |
---|---|
Content-Type * | application/json |
X-Apikey * | Your API key (This can be found in the API Settings page after logging in.) Example value: 123456789abc1011 |
Code sample for GET Email Sender Address
"Request Example (all sender email addresses):
GET http://api.trumpia.com/rest/v1/{user_name}/email/sender"
"Response Example (Success):"
[
{
"sender_id" : 987987987980,
"address" : "email0001@api.trumpia.com",
"default" : true
},
{
"sender_id" : 987987987981,
"address" : "email0002@api.trumpia.com",
"default" : false
}
]
"Response Example (Failure):"
{
"request_id" : "1234561234567asdf123",
"status_code" : "MPDE1201"
}
"Request Example (for a specific sender email address):
GET http://api.trumpia.com/rest/v1/{user_name}/email/sender/{sender_id}"
"Response Example (Success):"
{
"sender_id" : 987987987980,
"address" : "email0001@api.trumpia.com",
"default" : true
}
"Response Example (Failure):"
{
"request_id" : "1234561234567asdf123",
"status_code" : "MPDE1201"
}
<?
// GET Email Sender Address - Retrieve all email sender addresses.
include "request_rest.php";
$request_url = "http://api.trumpia.com/rest/v1/{user_name}/email/sender";
$request_rest = new RestRequest();
$request_rest->setRequestURL($request_url);
$request_rest->setAPIKey("{api_key}");
$request_rest->setMethod("GET");
$result = $request_rest->execute();
$response_status = $result[0];
$json_response_data = $result[1];
if ($response_status == "200") { //success
echo $json_response_data;
} else {
echo $response_status ." - connection failure";
}
?>
<?
// GET Email Sender Address - Retrieve an email sender address by ID.
include "request_rest.php";
$request_url = "http://api.trumpia.com/rest/v1/{user_name}/email/sender";
$sender_id = "987987987980";
$request_url = $request_url . "/" . $sender_id;
$request_rest = new RestRequest();
$request_rest->setRequestURL($request_url);
$request_rest->setAPIKey("{api_key}");
$request_rest->setMethod("GET");
$result = $request_rest->execute();
$response_status = $result[0];
$json_response_data = $result[1];
if ($response_status == "200") { //success
echo $json_response_data;
} else {
echo $response_status ." - connection failure";
}
?>
// GET Email Sender Address - Retrieve all email sender addresses.
<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%>
<%@ page import="org.json.simple.JSONArray" %>
<%@ page import="org.json.simple.JSONObject" %>
<%@ page import="java.io.BufferedReader" %>
<%@ page import="java.io.IOException" %>
<%@ page import="java.io.InputStreamReader" %>
<%@ page import="java.io.OutputStream" %>
<%@ page import="java.io.OutputStreamWriter" %>
<%@ page import="java.io.Writer" %>
<%@ page import="java.net.HttpURLConnection" %>
<%@ page import="java.net.URL" %>
<html>
<title>Email Sender Get All Sample Code</title>
<body>
<%
String username = "username";
String urlStr = "http://api.trumpia.com/rest/v1/" + username + "/email/sender";
URL url = new URL(urlStr);
HttpURLConnection conn = (HttpURLConnection) url.openConnection();
conn.setRequestProperty("Content-type", "application/json");
conn.setRequestProperty("X-Apikey", "12345aaaaa67890aaaaa");
if (conn.getResponseCode() != 200) {
%>
Error : <%=conn.getResponseMessage()%>
<%
}else{
// Buffer the result into a string
BufferedReader rd = new BufferedReader(new InputStreamReader(conn.getInputStream()));
StringBuilder sb = new StringBuilder();
String line;
while ((line = rd.readLine()) != null) {
sb.append(line);
}
rd.close();
conn.disconnect();
%>
Response : <%=sb.toString()%>
<%
}
%>
</body>
</html>
// GET Email Sender Address - Retrieve an email sender address by ID.
<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%>
<%@ page import="org.json.simple.JSONArray" %>
<%@ page import="org.json.simple.JSONObject" %>
<%@ page import="java.io.BufferedReader" %>
<%@ page import="java.io.IOException" %>
<%@ page import="java.io.InputStreamReader" %>
<%@ page import="java.io.OutputStream" %>
<%@ page import="java.io.OutputStreamWriter" %>
<%@ page import="java.io.Writer" %>
<%@ page import="java.net.HttpURLConnection" %>
<%@ page import="java.net.URL" %>
<html>
<title>Email Sender Get By Id Sample Code</title>
<body>
<%
String username = "username";
String sender_id = "987987987980";
String urlStr = "http://api.trumpia.com/rest/v1/" + username + "/email/sender/" + sender_id;
URL url = new URL(urlStr);
HttpURLConnection conn = (HttpURLConnection) url.openConnection();
conn.setRequestProperty("Content-type", "application/json");
conn.setRequestProperty("X-Apikey", "12345aaaaa67890aaaaa");
if (conn.getResponseCode() != 200) {
%>
Error : <%=conn.getResponseMessage()%>
<%
}else{
// Buffer the result into a string
BufferedReader rd = new BufferedReader(new InputStreamReader(conn.getInputStream()));
StringBuilder sb = new StringBuilder();
String line;
while ((line = rd.readLine()) != null) {
sb.append(line);
}
rd.close();
conn.disconnect();
%>
Response : <%=sb.toString()%>
<%
}
%>
</body>
</html>
// GET Email Sender Address - Retrieve all email sender addresses.
using Newtonsoft.Json;
using Newtonsoft.Json.Linq;
using System;
using System.Collections.Generic;
using System.Linq;
using System.Net.Http;
using System.Net.Http.Headers;
using System.Text;
using System.Threading.Tasks;
namespace sampleCode
{
class EmailSenderInfo
{
public string address { get; set; }
public string status { get; set; }
public long sender_id { get; set; }
public bool defaule { get; set; }
}
class EmailSenderGet
{
static void Main(string[] args)
{
RunAsync().Wait();
}
static async Task RunAsync()
{
using (var client = new HttpClient())
{
var apikey = "12345aaaaa67890aaaaa";
client.BaseAddress = new Uri("http://api.trumpia.com");
client.DefaultRequestHeaders.Accept.Clear();
client.DefaultRequestHeaders.Accept.Add(new MediaTypeWithQualityHeaderValue("application/json"));
client.DefaultRequestHeaders.Add("X-Apikey", string.Format("{0}", apikey));
var username = "username";
//GET
HttpResponseMessage response = await client.GetAsync(string.Format("/rest/v1/{0}/email/sender",username));
if (response.IsSuccessStatusCode)
{
List<EmailSenderInfo> emailSenderInfo = await response.Content.ReadAsAsync<List<EmailSenderInfo>>();
string json = JsonConvert.SerializeObject(emailSenderInfo);
Console.WriteLine(json);
}
}
}
}
}
// GET Email Sender Address - Retrieve an email sender address by ID.
using Newtonsoft.Json;
using Newtonsoft.Json.Linq;
using System;
using System.Collections.Generic;
using System.Linq;
using System.Net.Http;
using System.Net.Http.Headers;
using System.Text;
using System.Threading.Tasks;
namespace sampleCode
{
class EmailSenderInfo
{
public string sender_id { get; set; }
public string address { get; set; }
public string status { get; set; }
public string default { get; set; }
}
class EmailSenderGet
{
static void Main(string[] args)
{
RunAsync().Wait();
}
static async Task RunAsync()
{
using (var client = new HttpClient())
{
var apikey = "12345aaaaa67890aaaaa";
client.BaseAddress = new Uri("http://api.trumpia.com");
client.DefaultRequestHeaders.Accept.Clear();
client.DefaultRequestHeaders.Accept.Add(new MediaTypeWithQualityHeaderValue("application/json"));
client.DefaultRequestHeaders.Add("X-Apikey", string.Format("{0}", apikey));
var username = "username";
var sender_id = "987987987980";
//GET
HttpResponseMessage response = await client.GetAsync(string.Format("/rest/v1/{0}/email/sender/{1}",username, sender_id));
if (response.IsSuccessStatusCode)
{
EmailSenderInfo emailSenderInfo = await response.Content.ReadAsAsync<EmailSenderInfo>();
string json = JsonConvert.SerializeObject(emailSenderInfo);
Console.WriteLine(json);
}
}
}
}
}
POST Email Sender Address
Select a default email sender address.
Resource Information
Response Formats | JSON |
Allowed Methods | POST |
URL | http://api.trumpia.com/rest/v1/{user_name}/email/sender/{sender_id}/default |
{user_name} | Your account username (this can be found in the Account Settings page after logging in.) |
{sender_id} | The sender_id you wish to set as default. |
Header Parameters
Parameter | Description |
---|---|
Content-Type * | application/json |
X-Apikey * | Your API key (This can be found in the API Settings page after logging in.) Example value: 123456789abc1011 |
Code sample for POST Email Sender Address
"Request Example:
POST http://api.trumpia.com/rest/v1/{user_name}/email/sender/{sender_id}/default"
"Response Example (Success):"
{
"request_id" : "1234561234567asdf123",
"sender_id" : 987987987980,
"status_code" : "MPCE0000"
}
"Response Example (Failure):"
{
"request_id" : "1234561234567asdf123",
"status_code" : "MPDE2002"
}
<?
// POST Email Sender Address - Update an email sender address.
include "request_rest.php";
$request_url = "http://api.trumpia.com/rest/v1/{user_name}/email/sender";
$sender_id = "987987987980";
$request_url = $request_url. "/". $sender_id . "/default";
$request_rest = new RestRequest();
$request_rest->setRequestURL($request_url);
$request_rest->setAPIKey("{api_key}");
$request_rest->setMethod("POST");
$result = $request_rest->execute();
$response_status = $result[0];
$json_response_data = $result[1];
if ($response_status == "200") { //success
$response_data = json_decode($json_response_data);
echo "request_id : " . $response_data->request_id;
echo "status_code : " . $response_data->status_code;
} else {
echo $response_status ." - connection failure";
}
?>
// POST Email Sender Address - Update an email sender address.
<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%>
<%@ page import="java.io.BufferedReader" %>
<%@ page import="java.io.IOException" %>
<%@ page import="java.io.InputStreamReader" %>
<%@ page import="java.io.OutputStream" %>
<%@ page import="java.io.OutputStreamWriter" %>
<%@ page import="java.io.Writer" %>
<%@ page import="java.net.HttpURLConnection" %>
<%@ page import="java.net.URL" %>
<html>
<title>Email Sender Post Sample Code</title>
<body>
<%
String username = "username";
String sender_id = "987987987980";
String urlStr = "http://api.trumpia.com/rest/v1/" + username + "/email/sender/" + sender_id + "/default";
URL url = new URL(urlStr);
HttpURLConnection conn = (HttpURLConnection) url.openConnection();
conn.setRequestMethod("POST");
conn.setDoInput(true);
conn.setUseCaches(false);
conn.setAllowUserInteraction(false);
conn.setRequestProperty("Content-type", "application/json");
conn.setRequestProperty("X-Apikey", "12345aaaaa67890aaaaa");
if (conn.getResponseCode() != 200) {
%>
Error : <%=conn.getResponseMessage()%>
<%
}else{
// Buffer the result into a string
BufferedReader rd = new BufferedReader(new InputStreamReader(conn.getInputStream()));
StringBuilder sb = new StringBuilder();
String line;
while ((line = rd.readLine()) != null) {
sb.append(line);
}
rd.close();
conn.disconnect();
%>
Response : <%=sb.toString()%>
<%
}
%>
</body>
</html>
// POST Email Sender Address - Update an email sender address.
using Newtonsoft.Json;
using Newtonsoft.Json.Linq;
using System;
using System.Collections.Generic;
using System.Linq;
using System.Net.Http;
using System.Net.Http.Headers;
using System.Text;
using System.Threading.Tasks;
namespace samplecode
{
class Result
{
public string request_id { get; set; }
public string status_code { get; set; }
}
class EmailSenderPost
{
static void Main()
{
RunAsync().Wait();
}
static async Task RunAsync()
{
using (var client = new HttpClient())
{
var apikey = "12345aaaaa67890aaaaa";
client.DefaultRequestHeaders.Accept.Clear();
client.DefaultRequestHeaders.Accept.Add(new MediaTypeWithQualityHeaderValue("application/json"));
client.DefaultRequestHeaders.Add("X-Apikey", string.Format("{0}", apikey));
var username = "username";
var sender_id = "987987987989";
//POST
Uri postUrl = new Uri(string.Format("http://api.trumpia.com/rest/v1/{0}/email/sender/{1}/default", username, sender_id));
var response = client.PostAsync(postUrl, null).Result;
if (response.IsSuccessStatusCode)
{
var p = response.Content.ReadAsAsync<Result>().Result;
string json = JsonConvert.SerializeObject(p);
Console.WriteLine(json);
}
}
}
}
}
DELETE Email Sender Address
Permanently remove an email sender address.
Resource Information
Response Formats | JSON |
Allowed Methods | DELETE |
URL | http://api.trumpia.com/rest/v1/{user_name}/email/sender/{sender_id} |
{user_name} | Your account username (this can be found in the Account Settings page after logging in.) |
{sender_id} | The sender_id of the email sender address information being deleted. |
Header Parameters
Parameter | Description |
---|---|
Content-Type * | application/json |
X-Apikey * | Your API key (This can be found in the API Settings page after logging in.) Example value: 123456789abc1011 |
Code sample for DELETE Email Sender Address
"Request Example: DELETE http://api.trumpia.com/rest/v1/{user_name}/email/sender/{sender_id}"
"Response Example (Success):"
{
"request_id" : "1234561234567asdf123",
"sender_id" : 987987987980,
"status_code" : "MPCE0000"
}
"Response Example (Failure):"
{
"request_id" : "1234561234567asdf123",
"status_code" : "MPDE1201"
}
<?
// DELETE Email Sender Address - Delete an email sender address.
include "request_rest.php";
$request_url = "http://api.trumpia.com/rest/v1/{user_name}/email/sender";
$sender_id = "987987987980";
$request_url = $request_url . "/" . $sender_id;
$request_rest = new RestRequest();
$request_rest->setRequestURL($request_url);
$request_rest->setAPIKey("{api_key}");
$request_rest->setMethod("DELETE");
$result = $request_rest->execute();
$response_status = $result[0];
$json_response_data = $result[1];
if ($response_status == "200") { //success
echo $json_response_data;
} else {
echo $response_status ." - connection failure";
}
?>
// DELETE Email Sender Address - Delete an email sender address.
<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%>
<%@ page import="org.json.simple.JSONArray" %>
<%@ page import="org.json.simple.JSONObject" %>
<%@ page import="java.io.BufferedReader" %>
<%@ page import="java.io.IOException" %>
<%@ page import="java.io.InputStreamReader" %>
<%@ page import="java.io.OutputStream" %>
<%@ page import="java.io.OutputStreamWriter" %>
<%@ page import="java.io.Writer" %>
<%@ page import="java.net.HttpURLConnection" %>
<%@ page import="java.net.URL" %>
<html>
<title>Email Sender Delete Sample Code</title>
<body>
<%
String username = "username";
String sender_id = "987987987980";
String urlStr = "http://api.trumpia.com/rest/v1/" + username + "/email/sender/" + sender_id;
URL url = new URL(urlStr);
HttpURLConnection conn = (HttpURLConnection) url.openConnection();
conn.setRequestMethod("DELETE");
conn.setDoOutput(true);
conn.setAllowUserInteraction(false);
conn.setRequestProperty("Content-type", "application/json");
conn.setRequestProperty("X-Apikey", "12345aaaaa67890aaaaa");
if (conn.getResponseCode() != 200) {
%>
Error : <%=conn.getResponseMessage()%>
<%
}else{
// Buffer the result into a string
BufferedReader rd = new BufferedReader(new InputStreamReader(conn.getInputStream()));
StringBuilder sb = new StringBuilder();
String line;
while ((line = rd.readLine()) != null) {
sb.append(line);
}
rd.close();
conn.disconnect();
%>
Response : <%=sb.toString()%>
<%
}
%>
</body>
</html>
// DELETE Email Sender Address - Delete an email sender address.
using Newtonsoft.Json;
using System;
using System.Collections.Generic;
using System.Linq;
using System.Net.Http;
using System.Net.Http.Headers;
using System.Text;
using System.Threading.Tasks;
namespace samplecode
{
class Result
{
public string request_id { get; set; }
public string status_code { get; set; }
}
class EmailSenderDelete
{
static void Main()
{
RunAsync().Wait();
}
static async Task RunAsync()
{
using (var client = new HttpClient())
{
var apikey = "12345aaaaa67890aaaaa";
client.DefaultRequestHeaders.Accept.Clear();
client.DefaultRequestHeaders.Accept.Add(new MediaTypeWithQualityHeaderValue("application/json"));
client.DefaultRequestHeaders.Add("X-Apikey", string.Format("{0}", apikey));
var username = "username";
var sender_id = "987987987980";
//DELETE
Uri deleteUrl = new Uri(string.Format("http://api.trumpia.com/rest/v1/{0}/email/sender/{1}", username, sender_id));
var response = client.DeleteAsync(deleteUrl).Result;
if (response.IsSuccessStatusCode)
{
var p = response.Content.ReadAsAsync<Result>().Result;
string json = JsonConvert.SerializeObject(p);
Console.WriteLine(json);
}
}
}
}
}