With our SDKs

Unauthenticated requests
Some resources do not require an authenticated request to be accessible, which means you can access them solely with a BuiltOn API Key.
If you were to list products, here is how you could do it:
Core SDK
Node SDK
Python SDK
HTTP
1
const BuiltOn = require('@builton.dev/core-sdk');
2
const builton = new BuiltOn({
3
    apiKey: '<builton-api-key>'
4
});
5
​
6
builton.products.get({ size: 5 }).then((page) => {
7
    const firstProduct = page.current[0];
8
    console.log(firstProduct);
9
});
Copied!
1
// The Node SDK, although similar to the Core SDK, is intended for server-to-server communication.
2
​
3
const BuiltOn = require('@builton.dev/node-sdk');
4
const builton = new BuiltOn({
5
    apiKey: '<builton-api-key>'
6
});
7
​
8
builton.products.get({ size: 5 }).then((page) => {
9
    const firstProduct = page.current[0];
10
    console.log(firstProduct);
11
});
Copied!
1
# The Python is intended for server-to-server communication.
2
​
3
from builton_sdk import Builton
4
builton = Builton(api_key="<builton-api-key>")
5
builton.product().get_all(size=5)
Copied!
1
GET /products HTTP/1.1
2
Content-Type: application/json
3
X-Builton-Api-Key: <builton-api-key>
4
Host: api.builton.dev
Copied!
For more information about the pagination, please visit the Pagination page.
Authenticated requests
Most resources require an authenticated user to be accessible. This is the case of order for example.
To authenticate a user, do the following:
Core SDK
HTTP
1
const BuiltOn = require('@builton.dev/core-sdk');
2
​
3
const builton = new BuiltOn({
4
  bearerToken: '<jwt>',
5
  apiKey: '<builton-api-key>'
6
});
7
​
8
const userData = {
9
  first_name: 'foo',
10
  last_name: 'bar',
11
  email: '[email protected]'
12
};
13
​
14
builton.users.authenticate(userData).then((user) => {
15
  console.log(user);
16
});
Copied!
1
POST /users HTTP/1.1
2
Content-Type: application/json
3
Authorization: Bearer <jwt>
4
X-Builton-Api-Key: <builton-api-key>
5
Host: api.builton.dev
6
​
7
{
8
  "first_name": "foo",
9
  "last_name": "bar",
10
  "email": "[email protected]",
11
}
Copied!
For more information about the service accounts, please visit the Service account page.

Nuts & Bolts - Previous

Authentication

Next - Nuts & Bolts

Service Account

Last modified 2yr ago

Copy link

Contents

Unauthenticated requests

Authenticated requests