Overview
The CreateToken endpoint is used to exchange your API key for an access token that can be used to make API calls to the data endpoints.
Please read API Overview first.
API Endpoint
The CreateToken API endpoint won't change. It can be set as a constant.
https://api.autoaddress.com/3.0/createtoken
Request
To create a Token, a simple GET
request from your desired language is all that is needed.
- The createtoken endpoint requires Basic authentication.
- The username is your API key such as
pub_xxxxxxxx-xxxx-xxxx-xxxxxxxxxxxx
. The password is left blank. - This results in an Authorization header that looks like: Authorization: Basic <credentials> where
<credentials>
ispub_xxxxxxxx-xxxx-xxxx-xxxxxxxxxxxx:
Base64 encoded
The following is an example cURL CreateToken call
curl 'https://api.autoaddress.com/3.0/createtoken' \ --header 'Authorization: Basic cHViXzE5YjlmNzRmLTAxNDAtNGM5OC04ZWU4LWM0ZjBlYzE0Y2MyNzo='
Response
The following is a sample JSON response returned for a Create Token API request:
{
"token": "fvBby7sc9D+oGwJKa6f83sMca6oNynj2ehtH5P/mQpHfFpqemQ+Ge17P1lVmboVXz0/HGwS7KYDWvXn+qZJ1Ww==",
"type": "Token Create",
"transactionId": "08ef0f04-7603-4fae-aa8e-193aeb867032"
}
Output Fields
Name | Type | Description |
---|---|---|
token | string | Access token that can be used to access data endpoints |
type | string | Type of the response object |
transactionId | string | Unique UUID identifying the request |
Examples
jQuery
var settings = {
"url": "https://api.autoaddress.com/3.0/createtoken",
"method": "GET",
"timeout": 0,
"headers": {
"Authorization": "Basic cHViXzAwMDAwMDAwLTAwMDAtMDAwMC0wMDAwMDAwMDAwMDA="
},
};
$.ajax(settings).done(function (response) {
console.log(response);
});
Ruby
require "uri" require "net/http"
url = URI("https://api.autoaddress.com/3.0/createtoken")
https = Net::HTTP.new(url.host, url.port) https.use_ssl = true
request = Net::HTTP::Get.new(url) request["Authorization"] = "Basic cHViXzAwMDAwMDAwLTAwMDAtMDAwMC0wMDAwMDAwMDAwMDA="
response = https.request(request) puts response.read_body<br>
Python
import requests
url = "https://api.autoaddress.com/3.0/createtoken"
payload={}
headers = {
'Authorization': 'Basic cHViXzAwMDAwMDAwLTAwMDAtMDAwMC0wMDAwMDAwMDAwMDA='
}
response = requests.request("GET", url, headers=headers, data=payload)
print(response.text)
C#
var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Get, "https://api.autoaddress.com/3.0/createtoken");
request.Headers.Add("Authorization", "Basic cHViXzAwMDAwMDAwLTAwMDAtMDAwMC0wMDAwMDAwMDAwMDA=");
var response = await client.SendAsync(request);
response.EnsureSuccessStatusCode();
Console.WriteLine(await response.Content.ReadAsStringAsync());