Skip to content

skuflo Developers skuflo.iov1 Changelog

Pair a station

POST/v1/stations/pairNone, this endpoint is publicBase URL api.skuflo.io

Tablet or phone swaps a pairing code for its station token (shown once)

Body parameters#

Name	Type	Description
`code`required	`string`	·
`device`optional	`object`	The device the scanner runs on, as its browser reports it
`brand`optional	`string, max 40`	·
`model`optional	`string, max 60`	·
`platform`optional	`string, max 40`	·
`platform_version`optional	`string, max 20`	·
`browser`optional	`string, max 40`	·
`mobile`optional	`boolean`	·
`input`optional	`string, max 60`	How it last read a label: scanner trigger, camera or keyboard

Responses#

Status	Meaning
201	Created. The new record is in the body.
400	The request is malformed or refers to something that does not exist.

Other errors#

Status	Meaning
422	The body failed validation. The response lists every problem at once.
429	More than 600 requests a minute. Wait `retry-after` seconds.

Try it

POST /v1/stations/pair

Request

curl -X POST "https://api.skuflo.io/v1/stations/pair" \
  -H "Content-Type: application/json" \
  -d '{ "code": "K7Q2M9XR" }'

Response

{
  "id": "stn_4a1c",
  "name": "Loading bay 1",
  "role": "dispatch",
  "token": "st_live_..."
}

The token is shown once. Store it on the device. Every response carries x-ratelimit-limit, x-ratelimit-remaining and x-ratelimit-reset.