API overview
Generating and storing a unique Bike Identification Number has never been so easy in three steps!
You authenticate all your requests by simply sending an X-AUTH-TOKEN.
Second step is to create a BIN pattern – template used to generate a set of Bike Identification Numbers. You pass a simple bike specification and get a BIN pattern.
Last but not least, you pass a pattern generated in the second step and get a set of Bike Identification Numbrs
Auntentication
You have received two access tokens when you became a partner.
Dev API key is the access token that allows you to access to our sanbdox at:
https://dev.api.bikeidnumber.org/api2
Production API key allows you to access the production API at:
https://api.bikeidnumber.org/api2
<?php
$url = „http://api.bikeidnumber.org/api2”;
$curl = curl_init($url);
curl_setopt($curl, CURLOPT_URL, $url);
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
$headers = array(
„Authorization: Bearer your-token-here”,
);
curl_setopt($curl, CURLOPT_HTTPHEADER, $headers);
//for debug only!
curl_setopt($curl, CURLOPT_SSL_VERIFYHOST, false);
curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, false);
$resp = curl_exec($curl);
curl_close($curl);
var_dump($resp);
?>
const url = 'http://api.bikeidnumber.org/api2′;
const response = await fetch(url, {
headers: {
’Authorization’: 'Bearer your-token-here’,
},
});
const text = await response.text();
console.log(text);
import requests
from requests.structures import CaseInsensitiveDict
url = „http://api.bikeidnumber.org/api2”
headers = CaseInsensitiveDict()
headers[„Authorization”] = „Bearer your-token-here”
resp = requests.get(url, headers=headers)
print(resp.status_code)
var url = „http://api.bikeidnumber.org/api2”;
var httpRequest = (HttpWebRequest)WebRequest.Create(url);
httpRequest.Headers[„Authorization”] = „Bearer your-token-here”;
var httpResponse = (HttpWebResponse)httpRequest.GetResponse();
using (var streamReader = new StreamReader(httpResponse.GetResponseStream()))
{
var result = streamReader.ReadToEnd();
}
Console.WriteLine(httpResponse.StatusCode);
Generating a BIN pattern
POST https://api.bikeidnumber.org/api2/bin_pattern
Endpoint allows you to create a BIN pattern – a template storing bike specification but not a sequential number of a particular bike.
<?php
$url = „http://api.bikeidnumber.org/api2”;
$curl = curl_init($url);
curl_setopt($curl, CURLOPT_URL, $url);
curl_setopt($curl, CURLOPT_POST, true);
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
$headers = array(
„Authorization: Bearer your-token-here”,
„Content-Type: application/json”,
);
curl_setopt($curl, CURLOPT_HTTPHEADER, $headers);
$data = <<<DATA
{
„model”: {
„name”: „ECOBIKE SX 7”,
„symbol”: „SX7”
},
„symbol”: „SX7”,
„year”: 2024,
„frame”: {
„value”: 24,
„unit”: „in”
},
„wheel”: {
„value”: 28.5,
„unit”: „in”
},
„type”: „AB”,
„manufacturer”: „EB”,
„factory”: 1,
„ean”: „59484329341123”,
„json”: {
„param1”: „value1”,
„param2”: „value2”,
„param3”: 3,
„param4”: 4.4
}
}
DATA;
curl_setopt($curl, CURLOPT_POSTFIELDS, $data);
//for debug only!
curl_setopt($curl, CURLOPT_SSL_VERIFYHOST, false);
curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, false);
$resp = curl_exec($curl);
curl_close($curl);
var_dump($resp);
?>
const url = 'http://api.bikeidnumber.org/api2′;
const data = `{
„model”: {
„name”: „ECOBIKE SX 7”,
„symbol”: „SX7”
},
„symbol”: „SX7”,
„year”: 2024,
„frame”: {
„value”: 24,
„unit”: „in”
},
„wheel”: {
„value”: 28.5,
„unit”: „in”
},
„type”: „AB”,
„manufacturer”: „EB”,
„factory”: 1,
„ean”: „59484329341123”,
„json”: {
„param1”: „value1”,
„param2”: „value2”,
„param3”: 3,
„param4”: 4.4
}
}`;
const response = await fetch(url, {
method: 'POST’,
headers: {
'Authorization’: 'Bearer your-token-here’,
'Content-Type’: 'application/json’,
},
body: data,
});
const text = await response.text();
console.log(text);
import requests
from requests.structures import CaseInsensitiveDict
url = „http://api.bikeidnumber.org/api2”
headers = CaseInsensitiveDict()
headers[„Authorization”] = „Bearer your-token-here”
headers[„Content-Type”] = „application/json”
data = „””
{
„model”: {
„name”: „ECOBIKE SX 7”,
„symbol”: „SX7”
},
„symbol”: „SX7”,
„year”: 2024,
„frame”: {
„value”: 24,
„unit”: „in”
},
„wheel”: {
„value”: 28.5,
„unit”: „in”
},
„type”: „AB”,
„manufacturer”: „EB”,
„factory”: 1,
„ean”: „59484329341123”,
„json”: {
„param1”: „value1”,
„param2”: „value2”,
„param3”: 3,
„param4”: 4.4
}
}
„””
resp = requests.post(url, headers=headers, data=data)
print(resp.status_code)
var url = „http://api.bikeidnumber.org/api2”;
var httpRequest = (HttpWebRequest)WebRequest.Create(url);
httpRequest.Method = „POST”;
httpRequest.Headers[„Authorization”] = „Bearer your-token-here”;
httpRequest.ContentType = „application/json”;
var data = @”{
„”model””: {
„”name””: „”ECOBIKE SX 7″”,
„”symbol””: „”SX7″”
},
„”symbol””: „”SX7″”,
„”year””: 2024,
„”frame””: {
„”value””: 24,
„”unit””: „”in””
},
„”wheel””: {
„”value””: 28.5,
„”unit””: „”in””
},
„”type””: „”AB””,
„”manufacturer””: „”EB””,
„”factory””: 1,
„”ean””: „”59484329341123″”,
„”json””: {
„”param1″”: „”value1″”,
„”param2″”: „”value2″”,
„”param3″”: 3,
„”param4″”: 4.4
}
}”;
using (var streamWriter = new StreamWriter(httpRequest.GetRequestStream()))
{
streamWriter.Write(data);
}
var httpResponse = (HttpWebResponse)httpRequest.GetResponse();
using (var streamReader = new StreamReader(httpResponse.GetResponseStream()))
{
var result = streamReader.ReadToEnd();
}
Console.WriteLine(httpResponse.StatusCode);
Generating BIN
POST https://api.bikeidnumber.org/api2/bin
Endpoint allows you to create a set of Bike Identification Numbers based on a previously generated pattern.
<?php
$url = „http://api.bikeidnumber.org/api2/bin”;
$curl = curl_init($url);
curl_setopt($curl, CURLOPT_URL, $url);
curl_setopt($curl, CURLOPT_POST, true);
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
$headers = array(
„Authorization: Bearer your-token-here”,
„Content-Type: application/json”,
);
curl_setopt($curl, CURLOPT_HTTPHEADER, $headers);
$data = <<<DATA
{
„binPattern”: „PLEBABES95SX7_A21”,
„numOfItems”: 50,
„specification”: {
„param1”: „value”,
„param2”: „value2”,
„param3”: „value3”
}
}
DATA;
curl_setopt($curl, CURLOPT_POSTFIELDS, $data);
//for debug only!
curl_setopt($curl, CURLOPT_SSL_VERIFYHOST, false);
curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, false);
$resp = curl_exec($curl);
curl_close($curl);
var_dump($resp);
?>
const url = 'http://api.bikeidnumber.org/api2/bin’;
const data = `{
„binPattern”: „PLEBABES95SX7_A21”,
„numOfItems”: 50,
„specification”: {
„param1”: „value”,
„param2”: „value2”,
„param3”: „value3”
}
}`;
const response = await fetch(url, {
method: 'POST’,
headers: {
'Authorization’: 'Bearer your-token-here’,
'Content-Type’: 'application/json’,
},
body: data,
});
const text = await response.text();
console.log(text);
import requests
from requests.structures import CaseInsensitiveDict
url = „http://api.bikeidnumber.org/api2/bin”
headers = CaseInsensitiveDict()
headers[„Authorization”] = „Bearer your-token-here”
headers[„Content-Type”] = „application/json”
data = „””
{
„binPattern”: „PLEBABES95SX7_A21”,
„numOfItems”: 50,
„specification”: {
„param1”: „value”,
„param2”: „value2”,
„param3”: „value3”
}
}
„””
resp = requests.post(url, headers=headers, data=data)
print(resp.status_code)
var url = „http://api.bikeidnumber.org/api2/bin”;
var httpRequest = (HttpWebRequest)WebRequest.Create(url);
httpRequest.Method = „POST”;
httpRequest.Headers[„Authorization”] = „Bearer your-token-here”;
httpRequest.ContentType = „application/json”;
var data = @”{
„”binPattern””: „”PLEBABES95SX7_A21″”,
„”numOfItems””: 50,
„”specification””: {
„”param1″”: „”value””,
„”param2″”: „”value2″”,
„”param3″”: „”value3″”
}
}”;
using (var streamWriter = new StreamWriter(httpRequest.GetRequestStream()))
{
streamWriter.Write(data);
}
var httpResponse = (HttpWebResponse)httpRequest.GetResponse();
using (var streamReader = new StreamReader(httpResponse.GetResponseStream()))
{
var result = streamReader.ReadToEnd();
}
Console.WriteLine(httpResponse.StatusCode);
Headquarter:
Ratajczaka 26/6
61-815 Poznan
POLAND
© Copyright 2015-2020