Introduction RESTful API´s from iP.1
Getting started
Our SMS API allows you to connect your web services and applications to mobile operators around the world and is designed to handle high volumes of SMS traffic. This API is optimal for larger group sendings such as marketing, but also single sendings for automated SMS alarms etc.
Create account
To get started you will need an account, which you can create here
Once you have created your account, log in to our user portal to access your credentials, which are described in more detail in the step below.
API Endpoint
The base URL for all our endpints in our RESTful API is the following: https://api.ip1sms.com
All requests must be made using HTTPS.
Authentication
All endpoints are protected by authentication using HTTP Bearer tokens provided by us. Any account may have several API tokens with different restrictions on allowed IP-addresses etc. These can be accessed, created and edited in our User Portal
Sign in to the user portal with your iP.1 User that was created when you registered your account. Watch the instruction video below in order to create your API key.
Pagination
All endpoints in /v2/ which return a collection of documents (batches, messages etc.) have pagination turned on. We use the database style of pagination with start, limit and order as it's parameter names. start, limit and order are set to 0, 50 and ASC respectively but you may change them to your liking by adding them as query parameters when making your HTTP request like this
?start=0&limit=200&order=DESC
Link header
You'll also receive a Link header which includes pagination information.
Link: ; rel="next", ; rel="load"
This example includes a line break for readability.
Possible values for rel is:
Name | Description |
---|---|
self | The link relation for the requested page of results. |
first | The link relation for the first page of results. |
prev | The link relation for the immediate previous page of results. |
next | The link relation for the immediate next page of results. |
last | The link relation for the last page of results. |