219 lines
8.1 KiB
Handlebars
219 lines
8.1 KiB
Handlebars
<ol class="breadcrumb">
|
||
<li><a href="/">{{#translate}}Home{{/translate}}</a></li>
|
||
<li class="active">{{#translate}}API{{/translate}}</li>
|
||
</ol>
|
||
|
||
<h2>{{#translate}}API{{/translate}}</h2>
|
||
|
||
<hr>
|
||
|
||
<div class="panel panel-default">
|
||
<div class="panel-body">
|
||
<div class="pull-right">
|
||
<form class="form-horizontal confirm-submit" {{#if accessToken}} data-confirm-message="{{#translate}}Are you sure? Resetting would invalidate the currently existing token.{{/translate}}" {{else}} data-confirm-message="{{#translate}}Are you sure?{{/translate}}" {{/if}} method="post" action="/users/api/reset-token">
|
||
<input type="hidden" name="_csrf" value="{{csrfToken}}">
|
||
<button type="submit" class="btn btn-info"><span class="glyphicon glyphicon-retweet" aria-hidden="true"></span>
|
||
{{#if accessToken}}
|
||
{{#translate}}Reset Access Token{{/translate}}
|
||
{{else}}
|
||
{{#translate}}Generate Access Token{{/translate}}
|
||
{{/if}}
|
||
</button>
|
||
</form>
|
||
</div>
|
||
{{#if accessToken}}
|
||
{{#translate}}Personal access token:{{/translate}} <code>{{accessToken}}</code>
|
||
{{else}}
|
||
{{#translate}}Access token not yet generated{{/translate}}
|
||
{{/if}}
|
||
</div>
|
||
</div>
|
||
|
||
<div class="well">
|
||
|
||
<h3>{{#translate}}Notes about the API{{/translate}}</h3>
|
||
|
||
<ul>
|
||
<li>
|
||
{{#translate}}API response is a JSON structure with <code>error</code> and <code>data</code> properties. If the response <code>error</code> has a value set then the request failed.{{/translate}}
|
||
</li>
|
||
<li>
|
||
{{#translate}}You need to define proper <code>Content-Type</code> when making a request. You can either use <code>application/x-www-form-urlencoded</code> for normal form data or <code>application/json</code> for a JSON payload. Using <code>multipart/form-data</code> is not supported.{{/translate}}
|
||
</li>
|
||
</ul>
|
||
</div>
|
||
|
||
<h3>POST /api/subscribe/:listId – {{#translate}}Add subscription{{/translate}}</h3>
|
||
|
||
<p>
|
||
{{#translate}}This API call either inserts a new subscription or updates existing. Fields not included are left as is, so if you update only LAST_NAME value, then FIRST_NAME is kept untouched for an existing subscription.{{/translate}}
|
||
</p>
|
||
|
||
<p>
|
||
<strong>GET</strong> {{#translate}}arguments{{/translate}}
|
||
</p>
|
||
<ul>
|
||
<li><strong>access_token</strong> – {{#translate}}your personal access token{{/translate}}
|
||
</ul>
|
||
|
||
<p>
|
||
<strong>POST</strong> {{#translate}}arguments{{/translate}}
|
||
</p>
|
||
<ul>
|
||
<li><strong>EMAIL</strong> – {{#translate}}subscriber's email address{{/translate}} (<em>{{#translate}}required{{/translate}}</em>)</li>
|
||
<li><strong>FIRST_NAME</strong> – {{#translate}}subscriber's first name{{/translate}}</li>
|
||
<li><strong>LAST_NAME</strong> – {{#translate}}subscriber's last name{{/translate}}</li>
|
||
<li><strong>TIMEZONE</strong> – {{#translate}}subscriber's timezone (eg. "Europe/Tallinn", "PST" or "UTC"). If not set defaults to "UTC"{{/translate}}</li>
|
||
<li><strong>MERGE_TAG_VALUE</strong> – {{#translate}}custom field value. Use yes/no for option group values (checkboxes, radios, drop downs){{/translate}}</li>
|
||
</ul>
|
||
|
||
<p>
|
||
{{#translate}}Additional POST arguments{{/translate}}:
|
||
</p>
|
||
|
||
<ul>
|
||
<li>
|
||
<strong>FORCE_SUBSCRIBE</strong> – {{#translate}}set to "yes" if you want to make sure the email is marked as subscribed even if it was previously marked as unsubscribed. If the email was already unsubscribed/blocked then subscription status is not changed{{/translate}}
|
||
by default.
|
||
</li>
|
||
<li>
|
||
<strong>REQUIRE_CONFIRMATION</strong> – {{#translate}}set to "yes" if you want to send confirmation email to the subscriber before actually marking as subscribed{{/translate}}
|
||
</li>
|
||
</ul>
|
||
|
||
<p>
|
||
<strong>{{#translate}}Example{{/translate}}</strong>
|
||
</p>
|
||
|
||
<pre>curl -XPOST {{serviceUrl}}api/subscribe/B16uVTdW?access_token={{accessToken}} \
|
||
--data 'EMAIL=test@example.com&MERGE_CHECKBOX=yes&REQUIRE_CONFIRMATION=yes'</pre>
|
||
|
||
<h3>POST /api/unsubscribe/:listId – {{#translate}}Remove subscription{{/translate}}</h3>
|
||
|
||
<p>
|
||
{{#translate}}This API call marks a subscription as unsubscribed{{/translate}}
|
||
</p>
|
||
|
||
<p>
|
||
<strong>GET</strong> {{#translate}}arguments{{/translate}}
|
||
</p>
|
||
<ul>
|
||
<li><strong>access_token</strong> – {{#translate}}your personal access token{{/translate}}
|
||
</ul>
|
||
|
||
<p>
|
||
<strong>POST</strong> {{#translate}}arguments{{/translate}}
|
||
</p>
|
||
<ul>
|
||
<li><strong>EMAIL</strong> – {{#translate}}subscriber's email address{{/translate}} (<em>{{#translate}}required{{/translate}}</em>)
|
||
</ul>
|
||
|
||
<p>
|
||
<strong>{{#translate}}Example{{/translate}}</strong>
|
||
</p>
|
||
|
||
<pre>curl -XPOST {{serviceUrl}}api/unsubscribe/B16uVTdW?access_token={{accessToken}} \
|
||
--data 'EMAIL=test@example.com'</pre>
|
||
|
||
<h3>POST /api/delete/:listId – {{#translate}}Delete subscription{{/translate}}</h3>
|
||
|
||
<p>
|
||
{{#translate}}This API call deletes a subscription{{/translate}}
|
||
</p>
|
||
|
||
<p>
|
||
<strong>GET</strong> {{#translate}}arguments{{/translate}}
|
||
</p>
|
||
<ul>
|
||
<li><strong>access_token</strong> – {{#translate}}your personal access token{{/translate}}
|
||
</ul>
|
||
|
||
<p>
|
||
<strong>POST</strong> {{#translate}}arguments{{/translate}}
|
||
</p>
|
||
<ul>
|
||
<li><strong>EMAIL</strong> – {{#translate}}subscriber's email address{{/translate}} (<em>{{#translate}}required{{/translate}}</em>)
|
||
</ul>
|
||
|
||
<p>
|
||
<strong>{{#translate}}Example{{/translate}}</strong>
|
||
</p>
|
||
|
||
<pre>curl -XPOST {{serviceUrl}}api/delete/B16uVTdW?access_token={{accessToken}} \
|
||
--data 'EMAIL=test@example.com'</pre>
|
||
|
||
<h3>GET /api/blacklist/get – {{#translate}}Get list of blacklisted emails{{/translate}}</h3>
|
||
|
||
<p>
|
||
{{#translate}}This API call get list of blacklisted emails.{{/translate}}
|
||
</p>
|
||
|
||
<p>
|
||
<strong>GET</strong> {{#translate}}arguments{{/translate}}
|
||
</p>
|
||
<ul>
|
||
<li><strong>access_token</strong> – {{#translate}}your personal access token{{/translate}}
|
||
<li><strong>start</strong> – {{#translate}}Start position{{/translate}} (<em>{{#translate}}optional, default 0{{/translate}}</em>)</li>
|
||
<li><strong>limit</strong> – {{#translate}}limit emails count in response{{/translate}} (<em>{{#translate}}optional, default 10000{{/translate}}</em>)</li>
|
||
<li><strong>search</strong> – {{#translate}}filter by part of email{{/translate}} (<em>{{#translate}}optional, default ''{{/translate}}</em>)</li>
|
||
</ul>
|
||
|
||
<p>
|
||
<strong>{{#translate}}Example{{/translate}}</strong>
|
||
</p>
|
||
|
||
<pre>curl -XGET '{{serviceUrl}}api/blacklist/get?access_token={{accessToken}}&limit=10&start=10&search=gmail' </pre>
|
||
|
||
<h3>POST /api/blacklist/add – {{#translate}}Add email to blacklist{{/translate}}</h3>
|
||
|
||
<p>
|
||
{{#translate}}This API call either add emails to blacklist{{/translate}}
|
||
</p>
|
||
|
||
<p>
|
||
<strong>GET</strong> {{#translate}}arguments{{/translate}}
|
||
</p>
|
||
<ul>
|
||
<li><strong>access_token</strong> – {{#translate}}your personal access token{{/translate}}
|
||
</ul>
|
||
|
||
<p>
|
||
<strong>POST</strong> {{#translate}}arguments{{/translate}}
|
||
</p>
|
||
<ul>
|
||
<li><strong>EMAIL</strong> – {{#translate}}email address{{/translate}} (<em>{{#translate}}required{{/translate}}</em>)</li>
|
||
</ul>
|
||
|
||
<p>
|
||
<strong>{{#translate}}Example{{/translate}}</strong>
|
||
</p>
|
||
|
||
<pre>curl -XPOST '{{serviceUrl}}api/blacklist/add?access_token={{accessToken}}' \
|
||
--data 'EMAIL=test@example.com&'</pre>
|
||
|
||
<h3>POST /api/blacklist/delete – {{#translate}}Delete email from blacklist{{/translate}}</h3>
|
||
|
||
<p>
|
||
{{#translate}}This API call either delete emails from blacklist{{/translate}}
|
||
</p>
|
||
|
||
<p>
|
||
<strong>GET</strong> {{#translate}}arguments{{/translate}}
|
||
</p>
|
||
<ul>
|
||
<li><strong>access_token</strong> – {{#translate}}your personal access token{{/translate}}
|
||
</ul>
|
||
|
||
<p>
|
||
<strong>POST</strong> {{#translate}}arguments{{/translate}}
|
||
</p>
|
||
<ul>
|
||
<li><strong>EMAIL</strong> – {{#translate}}email address{{/translate}} (<em>{{#translate}}required{{/translate}}</em>)</li>
|
||
</ul>
|
||
|
||
<p>
|
||
<strong>{{#translate}}Example{{/translate}}</strong>
|
||
</p>
|
||
|
||
<pre>curl -XPOST '{{serviceUrl}}api/blacklist/delete?access_token={{accessToken}}' \
|
||
--data 'EMAIL=test@example.com&'</pre>
|