Help Documentation 〉API 〉
/projects/:document_identifier/reports/:report_uuid/links/:link_uuid
This resource supports the GET method.
URL Parameters
| Label |
Description |
| :document_identifier |
The project's document identifier |
| :report_uuid |
The UUID of the report |
| :link_uuid |
The UUID of the link |
GET
Returns information about the link.
GET Request Query String Parameters
| Name |
Required |
Description |
| fields |
No |
A comma-separated list of the keys you want returned for the link. Default is to return all keys. |
GET Response Status Codes
| Code |
Description |
| 503 Service Unavailable |
Server is undergoing maintenance and is unavailable |
| 429 Rate Limited |
Rate limiting in effect, try again later |
| 404 Not Found |
The resource could not be found or your API key has not been granted access to it |
| 403 Forbidden |
Direct Mail account is disabled |
| 401 Unauthorized |
API key, secret, or authentication method is incorrect |
| 200 OK |
Success |
GET Response Body
A JSON object representing the link.
| Key |
Value |
Description |
| uuid |
String |
The UUID of the link |
| title |
String |
The title of the link |
| url |
String |
The URL of the link |
| number_of_unique_clicks |
Integer |
The number of recipients that clicked on this link at least once |
| number_of_clicks |
Integer |
The total number of clicks on this link |
| links |
Array of Object |
URLs for the link (rel:self) and this link's click events (rel:clicks) |
GET Example
GET /api/v2/projects/187812f26ba37d9769d8691d2a83c95c/reports/F4B2E4E6-B94F-462C-AFEC-1F9497BA98A0/links/0022F304-3CBA-4D31-A4F8-1875A3F4F1EA HTTP/1.1
Authorization: Basic QzFENDREMjEtNTA4MC00NTM3LUFFOD
Accept: application/json; charset=utf-8
Host: secure.directmailmac.com
HTTP/1.1 200 OK
Date: Thu, 23 Apr 2015 23:36:34 GMT
Content-Type: application/json; charset=utf-8
{
"links": [
{
"href": "https://secure.directmailmac.com/api/v2/projects/187812f26ba37d9769d8691d2a83c95c/reports/F4B2E4E6-B94F-462C-AFEC-1F9497BA98A0/links/0022F304-3CBA-4D31-A4F8-1875A3F4F1EA",
"rel": "self"
},
{
"href": "https://secure.directmailmac.com/api/v2/projects/187812f26ba37d9769d8691d2a83c95c/reports/F4B2E4E6-B94F-462C-AFEC-1F9497BA98A0/links/0022F304-3CBA-4D31-A4F8-1875A3F4F1EA/clicks",
"rel": "clicks"
}
],
"number_of_clicks": 192,
"number_of_unique_clicks": 192,
"title": "visit our website",
"url": "http://directmailmac.com",
"uuid": "0022F304-3CBA-4D31-A4F8-1875A3F4F1EA"
}
