Skip to content

Commit 3cebf27

Browse files
committed
Updated sending domains doc and examples for api format. Fixed callback in other docs.
1 parent e0376e0 commit 3cebf27

File tree

8 files changed

+22
-36
lines changed

8 files changed

+22
-36
lines changed

docs/resources/recipientLists.md

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -8,8 +8,7 @@ This library provides easy access to the [Recipient Lists](https://www.sparkpost
88
* `callback` - executed after task is completed. **required**
99
* standard `callback(err, data)`
1010
* `err` - any error that occurred
11-
* `data.res` - full response from request client
12-
* `data.body` - payload from response
11+
* `data` - full response from request client
1312
* **find(options, callback)**
1413
Retrieve details about a specified recipient list by its id
1514
* `options.id` - the id of the recipient list you want to look up **required**

docs/resources/sendingDomains.md

Lines changed: 3 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -8,11 +8,10 @@ This library provides easy access to the [Sending Domains](https://www.sparkpost
88
* `callback` - executed after task is completed. **required**
99
* standard `callback(err, data)`
1010
* `err` - any error that occurred
11-
* `data.res` - full response from request client
12-
* `data.body` - payload from response
11+
* `data` - full response from request client
1312
* **find(domainName, callback)**
1413
Retrieve a sending domain by its domain name
15-
* `domainName` - the name of the domain you want to look up **required**
14+
* `domain` - the name of the domain you want to look up **required**
1615
* `callback` - see all function
1716
* **create(domainBody, callback)**
1817
Create a new sending domain
@@ -24,22 +23,10 @@ This library provides easy access to the [Sending Domains](https://www.sparkpost
2423
* `callback` - see all function
2524
* **verify(options, callback)**
2625
Validate the specified verification field types for a sending domain
27-
* `options.domainName` - the name of the domain you want to verify **required**
26+
* `options.domain` - the name of the domain you want to verify **required**
2827
* `options.verifyDKIM` - initiates a check against the DKIM record default: `true`
2928
* `options.verifySPF` - initiates a check against the SPF record default: `true`
3029

31-
32-
### domainBody
33-
| Field Name | Required? | Description | Data Type |
34-
| ---------- | --------- | --------------------------------------------------------------- | --------- |
35-
| domainName | yes | Name of the sending domain | String |
36-
| privateKey | yes** | Private key used to create the DKIM Signature. | String |
37-
| publicKey | yes** | Public key to be retrieved from the DNS of the sending domain. | String |
38-
| selector | yes** | DomainKey selector that indicates the DKIM public key location. | String |
39-
| headers | no | Header fields to be included in the DKIM signature | String |
40-
41-
** - If specifying a privateKey, publicKey, or selector, all three fields are required.
42-
4330
## Examples
4431

4532
```js

docs/resources/suppressionList.md

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -9,8 +9,7 @@ This library provides easy access to the [Suppression List](https://www.sparkpos
99
* `callback` - executed after task is completed. **required**
1010
* standard `callback(err, data)`
1111
* `err` - any error that occurred
12-
* `data.res` - full response from request client
13-
* `data.body` - payload from response
12+
* `data` - full response from request client
1413
* **checkStatus(email, callback)**
1514
* `email` - `String` email address to check **required**
1615
* `callback` - see search function

docs/resources/templates.md

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -8,8 +8,7 @@ This library provides easy access to the [Templates](https://www.sparkpost.com/a
88
* `callback` - executed after task is completed. **required**
99
* standard `callback(err, data)`
1010
* `err` - any error that occurred
11-
* `data.res` - full response from request client
12-
* `data.body` - payload from response
11+
* `data` - full response from request client
1312
* **find(options, callback)**
1413
Retrieve details about a specified template by its id
1514
* `options.id` - the id of the template you want to look up **required**

docs/resources/transmissions.md

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -8,8 +8,7 @@ This library provides easy access to the [Transmissions](https://www.sparkpost.c
88
* `callback` - executed after task is completed. **required**
99
* standard `callback(err, data)`
1010
* `err` - any error that occurred
11-
* `data.res` - full response from request client
12-
* `data.body` - payload from response
11+
* `data` - full response from request client
1312
* **find(transmissionID, callback)**
1413
Retrieve the details about a transmission by its ID
1514
* `transmissionID` - the id of the transmission you want to look up **required**

docs/resources/webhooks.md

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -9,8 +9,7 @@ This library provides easy access to the [Webhooks](https://www.sparkpost.com/ap
99
* `callback` - executed after task is completed. **required**
1010
* standard `callback(err, data)`
1111
* `err` - any error that occurred
12-
* `data.res` - full response from request client
13-
* `data.body` - payload from response
12+
* `data` - full response from request client
1413
* **describe(options, callback)**
1514
Retrieve details about a specified webhook by its id
1615
* `options.id` - the id of the webhook you want to describe **required**

examples/sendingDomains/create_sendingDomain.js

Lines changed: 7 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -5,11 +5,13 @@ var key = 'YOURAPIKEY'
55
, client = new SparkPost(key);
66

77
var domain = {
8-
domainName: 'example1.com',
9-
privateKey: 'MIICXgIBAAKBgQC+W6scd3XWwvC/hPRksfDYFi3ztgyS9OSqnnjtNQeDdTSD1DRx/xFar2wjmzxp2+SnJ5pspaF77VZveN3P/HVmXZVghr3asoV9WBx/uW1nDIUxU35L4juXiTwsMAbgMyh3NqIKTNKyMDy4P8vpEhtH1iv/BrwMdBjHDVCycB8WnwIDAQABAoGBAITb3BCRPBi5lGhHdn+1RgC7cjUQEbSb4eFHm+ULRwQ0UIPWHwiVWtptZ09usHq989fKp1g/PfcNzm8c78uTS6gCxfECweFCRK6EdO6cCCr1cfWvmBdSjzYhODUdQeyWZi2ozqd0FhGWoV4VHseh4iLj36DzleTLtOZj3FhAo1WJAkEA68T+KkGeDyWwvttYtuSiQCCTrXYAWTQnkIUxduCp7Ap6tVeIDn3TaXTj74UbEgaNgLhjG4bX//fdeDW6PaK9YwJBAM6xJmwHLPMgwNVjiz3u/6fhY3kaZTWcxtMkXCjh1QE82KzDwqyrCg7EFjTtFysSHCAZxXZMcivGl4TZLHnydJUCQQCx16+M+mAatuiCnvxlQUMuMiSTNK6Amzm45u9v53nlZeY3weYMYFdHdfe1pebMiwrT7MI9clKebz6svYJVmdtXAkApDAc8VuR3WB7TgdRKNWdyGJGfoD1PO1ZE4iinOcoKV+IT1UCY99Kkgg6C7j62n/8T5OpRBvd5eBPpHxP1F9BNAkEA5Nf2VO9lcTetksHdIeKK+F7sio6UZn0Rv7iUo3ALrN1D1cGfWIh2dj3ko1iSreyNVSwGW0ePP27qDmU+u6/Y1g==',
10-
publicKey: 'MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQC+W6scd3XWwvC/hPRksfDYFi3ztgyS9OSqnnjtNQeDdTSD1DRx/xFar2wjmzxp2+SnJ5pspaF77VZveN3P/HVmXZVghr3asoV9WBx/uW1nDIUxU35L4juXiTwsMAbgMyh3NqIKTNKyMDy4P8vpEhtH1iv/BrwMdBjHDVCycB8WnwIDAQAB',
11-
selector: 'brisbane',
12-
headers: 'from:to:subject:date'
8+
domain: 'example1.com',
9+
dkim: {
10+
private: 'MIICXgIBAAKBgQC+W6scd3XWwvC/hPRksfDYFi3ztgyS9OSqnnjtNQeDdTSD1DRx/xFar2wjmzxp2+SnJ5pspaF77VZveN3P/HVmXZVghr3asoV9WBx/uW1nDIUxU35L4juXiTwsMAbgMyh3NqIKTNKyMDy4P8vpEhtH1iv/BrwMdBjHDVCycB8WnwIDAQABAoGBAITb3BCRPBi5lGhHdn+1RgC7cjUQEbSb4eFHm+ULRwQ0UIPWHwiVWtptZ09usHq989fKp1g/PfcNzm8c78uTS6gCxfECweFCRK6EdO6cCCr1cfWvmBdSjzYhODUdQeyWZi2ozqd0FhGWoV4VHseh4iLj36DzleTLtOZj3FhAo1WJAkEA68T+KkGeDyWwvttYtuSiQCCTrXYAWTQnkIUxduCp7Ap6tVeIDn3TaXTj74UbEgaNgLhjG4bX//fdeDW6PaK9YwJBAM6xJmwHLPMgwNVjiz3u/6fhY3kaZTWcxtMkXCjh1QE82KzDwqyrCg7EFjTtFysSHCAZxXZMcivGl4TZLHnydJUCQQCx16+M+mAatuiCnvxlQUMuMiSTNK6Amzm45u9v53nlZeY3weYMYFdHdfe1pebMiwrT7MI9clKebz6svYJVmdtXAkApDAc8VuR3WB7TgdRKNWdyGJGfoD1PO1ZE4iinOcoKV+IT1UCY99Kkgg6C7j62n/8T5OpRBvd5eBPpHxP1F9BNAkEA5Nf2VO9lcTetksHdIeKK+F7sio6UZn0Rv7iUo3ALrN1D1cGfWIh2dj3ko1iSreyNVSwGW0ePP27qDmU+u6/Y1g==',
11+
public: 'MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQC+W6scd3XWwvC/hPRksfDYFi3ztgyS9OSqnnjtNQeDdTSD1DRx/xFar2wjmzxp2+SnJ5pspaF77VZveN3P/HVmXZVghr3asoV9WBx/uW1nDIUxU35L4juXiTwsMAbgMyh3NqIKTNKyMDy4P8vpEhtH1iv/BrwMdBjHDVCycB8WnwIDAQAB',
12+
selector: 'brisbane',
13+
headers: 'from:to:subject:date'
14+
}
1315
};
1416

1517
client.sendingDomains.create(domain, function(err, res) {

examples/sendingDomains/update_sendingDomain.js

Lines changed: 7 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -5,11 +5,13 @@ var key = 'YOURAPIKEY'
55
, client = new SparkPost(key);
66

77
var domain = {
8-
domainName: 'example1.com',
9-
privateKey: 'MIICXgIBAAKBgQC+W6scd3XWwvC/hPRksfDYFi3ztgyS9OSqnnjtNQeDdTSD1DRx/xFar2wjmzxp2+SnJ5pspaF77VZveN3P/HVmXZVghr3asoV9WBx/uW1nDIUxU35L4juXiTwsMAbgMyh3NqIKTNKyMDy4P8vpEhtH1iv/BrwMdBjHDVCycB8WnwIDAQABAoGBAITb3BCRPBi5lGhHdn+1RgC7cjUQEbSb4eFHm+ULRwQ0UIPWHwiVWtptZ09usHq989fKp1g/PfcNzm8c78uTS6gCxfECweFCRK6EdO6cCCr1cfWvmBdSjzYhODUdQeyWZi2ozqd0FhGWoV4VHseh4iLj36DzleTLtOZj3FhAo1WJAkEA68T+KkGeDyWwvttYtuSiQCCTrXYAWTQnkIUxduCp7Ap6tVeIDn3TaXTj74UbEgaNgLhjG4bX//fdeDW6PaK9YwJBAM6xJmwHLPMgwNVjiz3u/6fhY3kaZTWcxtMkXCjh1QE82KzDwqyrCg7EFjTtFysSHCAZxXZMcivGl4TZLHnydJUCQQCx16+M+mAatuiCnvxlQUMuMiSTNK6Amzm45u9v53nlZeY3weYMYFdHdfe1pebMiwrT7MI9clKebz6svYJVmdtXAkApDAc8VuR3WB7TgdRKNWdyGJGfoD1PO1ZE4iinOcoKV+IT1UCY99Kkgg6C7j62n/8T5OpRBvd5eBPpHxP1F9BNAkEA5Nf2VO9lcTetksHdIeKK+F7sio6UZn0Rv7iUo3ALrN1D1cGfWIh2dj3ko1iSreyNVSwGW0ePP27qDmU+u6/Y1g==',
10-
publicKey: 'MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQC+W6scd3XWwvC/hPRksfDYFi3ztgyS9OSqnnjtNQeDdTSD1DRx/xFar2wjmzxp2+SnJ5pspaF77VZveN3P/HVmXZVghr3asoV9WBx/uW1nDIUxU35L4juXiTwsMAbgMyh3NqIKTNKyMDy4P8vpEhtH1iv/BrwMdBjHDVCycB8WnwIDAQAB',
11-
selector: 'hello_selector',
12-
headers: 'from:to:subject:date'
8+
domain: 'example1.com',
9+
dkim: {
10+
private: 'MIICXgIBAAKBgQC+W6scd3XWwvC/hPRksfDYFi3ztgyS9OSqnnjtNQeDdTSD1DRx/xFar2wjmzxp2+SnJ5pspaF77VZveN3P/HVmXZVghr3asoV9WBx/uW1nDIUxU35L4juXiTwsMAbgMyh3NqIKTNKyMDy4P8vpEhtH1iv/BrwMdBjHDVCycB8WnwIDAQABAoGBAITb3BCRPBi5lGhHdn+1RgC7cjUQEbSb4eFHm+ULRwQ0UIPWHwiVWtptZ09usHq989fKp1g/PfcNzm8c78uTS6gCxfECweFCRK6EdO6cCCr1cfWvmBdSjzYhODUdQeyWZi2ozqd0FhGWoV4VHseh4iLj36DzleTLtOZj3FhAo1WJAkEA68T+KkGeDyWwvttYtuSiQCCTrXYAWTQnkIUxduCp7Ap6tVeIDn3TaXTj74UbEgaNgLhjG4bX//fdeDW6PaK9YwJBAM6xJmwHLPMgwNVjiz3u/6fhY3kaZTWcxtMkXCjh1QE82KzDwqyrCg7EFjTtFysSHCAZxXZMcivGl4TZLHnydJUCQQCx16+M+mAatuiCnvxlQUMuMiSTNK6Amzm45u9v53nlZeY3weYMYFdHdfe1pebMiwrT7MI9clKebz6svYJVmdtXAkApDAc8VuR3WB7TgdRKNWdyGJGfoD1PO1ZE4iinOcoKV+IT1UCY99Kkgg6C7j62n/8T5OpRBvd5eBPpHxP1F9BNAkEA5Nf2VO9lcTetksHdIeKK+F7sio6UZn0Rv7iUo3ALrN1D1cGfWIh2dj3ko1iSreyNVSwGW0ePP27qDmU+u6/Y1g==',
11+
public: 'MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQC+W6scd3XWwvC/hPRksfDYFi3ztgyS9OSqnnjtNQeDdTSD1DRx/xFar2wjmzxp2+SnJ5pspaF77VZveN3P/HVmXZVghr3asoV9WBx/uW1nDIUxU35L4juXiTwsMAbgMyh3NqIKTNKyMDy4P8vpEhtH1iv/BrwMdBjHDVCycB8WnwIDAQAB',
12+
selector: 'hello_selector',
13+
headers: 'from:to:subject:date'
14+
}
1315
};
1416

1517
client.sendingDomains.update(domain, function(err, res) {

0 commit comments

Comments
 (0)