Difference between revisions of "API Method DirectSimpleSend"
From Updox API
(→Request) |
(→Request) |
||
| Line 28: | Line 28: | ||
"attachments": [ | "attachments": [ | ||
{ | { | ||
| − | "content": "CgoKCgoKCgoKCgoKCgoKCgoKCgoKVEhJU0lTQVRFU1QgVEhJU0lTQVRFU1QgVEhJU0lTQVRFU1Qg, | + | "content": "CgoKCgoKCgoKCgoKCgoKCgoKCgoKVEhJU0lTQVRFU1QgVEhJU0lTQVRFU1QgVEhJU0lTQVRFU1Qg", |
"mimeType": "text/plain", | "mimeType": "text/plain", | ||
"fileName": "test.txt" | "fileName": "test.txt" | ||
Revision as of 14:15, 3 December 2013
An outbound direct message method which sends a direct message (with optional attachments) from the authenticated user to a single recipient (represents a simpler interface than the DirectMessageSend API).
Contents |
Fields
Please refer to the Interactive API for a list of the fields for this method.
Code Samples
| Language | Source Code Examples |
|---|---|
| C# | |
| Java |
public void TalkToUpdox() throws Exception {
String uri = "https://updoxqa.com/io/DirectSimpleSend";
ObjectMapper mapper = new ObjectMapper();
Map<String,Object> messageData = BuildMessage();
String jsonData = mapper.writeValueAsString(messageData);
HttpResponse httpResponse = SendReceiveJSON(jsonData, uri);
HttpEntity responseEntity = httpResponse.getEntity();
String response = EntityUtils.toString(responseEntity);
JsonNode actualObj = mapper.readTree(response);
System.out.println(actualObj.get("responseCode"));
System.out.println(actualObj.get("responseMessage"));
}
private Map<String,Object> BuildMessage() throws Exception
{
Map<String,Object> messageData = new HashMap();
messageData.put("to","dublin@direct.updoxqa.com");
messageData.put("subject","Test Subject");
messageData.put("textMessage","Test message body");
List<Map<String,String>> attachments = new ArrayList<Map<String,String>>();
Map<String,String> attachment = new HashMap();
attachment.put("content", "CgoKCgoKCgoKCgoKCgoKCgoKCgoKVEhJU0lTQVRFU1QgVEhJU0lTQVRFU1QgVEhJU0lTQVRFU1Qg
VEhJU0lTQVRFU1QgVEhJU0lTQVRFU1QgVEhJU0lTQVRFU1QgVEhJU0lTQVRFU1QgVEhJU0lTQVRF
U1QgVEhJU0lTQVRFU1QgVEhJU0lTQVRFU1QgVEhJU0lTQVRFU1QgVEhJU0lTQVRFU1QgVEhJU0lT
QVRFU1QgVEhJU0lTQVRFU1QgVEhJU0lTQVRFU1QgVEhJU0lTQVRFU1QgVEhJU0lTQVRFU1QgVEhJ
U0lTQVRFU1QgVEhJU0lTQVRFU1QgVEhJU0lTQVRFU1QgVEhJU0lTQVRFU1QgVEhJU0lTQVRFU1Qg
VEhJU0lTQVRFU1QgVEhJU0lTQVRFU1QgVEhJU0lTQVRFU1QgVEhJU0lTQVRFU1QgVEhJU0lTQVRF
U1QgVEhJU0lTQVRFU1QgVEhJU0lTQVRFU1QgVEhJU0lTQVRFU1QgVEhJU0lTQVRFU1QgVEhJU0lT
QVRFU1QgVEhJU0lTQVRFU1QgVEhJU0lTQVRFU1QgVEhJU0lTQVRFU1QgVEhJU0lTQVRFU1QgVEhJ
U0lTQVRFU1QgVEhJU0lTQVRFU1QgVEhJU0lTQVRFU1QgVEhJU0lTQVRFU1QgVEhJU0lTQVRFU1Qg
VEhJU0lTQVRFU1QgVEhJU0lTQVRFU1QgVEhJU0lTQVRFU1QgVEhJU0lTQVRFU1QgVEhJU0lTQVRF
U1QgVEhJU0lTQVRFU1QgVEhJU0lTQVRFU1QgVEhJU0lTQVRFU1QgVEhJU0lTQVRFU1QgVEhJU0lT
QVRFU1QgVEhJU0lTQVRFU1QgVEhJU0lTQVRFU1QgVEhJU0lTQVRFU1QgVEhJU0lTQVRFU1QgVEhJ
U0lTQVRFU1QgVEhJU0lTQVRFU1QgVEhJU0lTQVRFU1QgVEhJU0lTQVRFU1QgVEhJU0lTQVRFU1Qg
VEhJU0lTQVRFU1QgVEhJU0lTQVRFU1QgVEhJU0lTQVRFU1QgVEhJU0lTQVRFU1Qg");
attachment.put("mimeType", "text/plain");
attachment.put("fileName", "test.txt");
attachments.add(attachment);
Map<String,String>[] attachmentMap = attachments.toArray(new HashMap[attachments.size()]);
messageData.put("attachments", attachmentMap);
Map<String,String> authData = new HashMap();
authData.put("applicationId", "updox");
authData.put("applicationPassword", "password");
authData.put("accountId", "605");
authData.put("userId", "605");
messageData.put("auth", authData);
return messageData;
}
private HttpResponse SendReceiveJSON(String jsonData, String uri) throws Exception {
HttpClient httpClient = new DefaultHttpClient();
HttpResponse response = null;
StringEntity params = new StringEntity(jsonData);
try {
HttpPost request = new HttpPost(uri);
request.addHeader("content-type", "application/json");
request.setEntity(params);
response = httpClient.execute(request);
} catch (Exception ex) {
// handle exception here
} finally {
httpClient.getConnectionManager().shutdown();
}
return response;
}
|
Sample Request and Response
Request
{
"to": "dublin@direct.updoxqa.com",
"subject": "Test subject",
"textMessage": "Test message body",
"attachments": [
{
"content": "CgoKCgoKCgoKCgoKCgoKCgoKCgoKVEhJU0lTQVRFU1QgVEhJU0lTQVRFU1QgVEhJU0lTQVRFU1Qg",
"mimeType": "text/plain",
"fileName": "test.txt"
}
],
"auth": {
"applicationId": "updox",
"applicationPassword": "password",
"accountId": "605",
"userId": "605"
}
}
Response
{
"successful": true,
"responseMessage": "OK",
"responseCode": 2000,
"recipient": "contact:227683",
"name": "dublin@direct.updoxqa.com",
"directAddress": "dublin@direct.updoxqa.com",
"reason": null,
"messageId": 251802
}
Error Codes
In addition to the General Error Set, this method may return:
- 4640: direct address error: invalid direct address
- 4641: direct address error: no direct address found for this user
- 4650: direct error: send failed
