47 lines
1.4 KiB
Markdown
47 lines
1.4 KiB
Markdown
# `GET /v1/client`
|
||
|
||
Public. No cookie required.
|
||
|
||
POS discovery and pairing
|
||
|
||
Special API for POS bind and sync.
|
||
- Step 1 (Discovery): `authCode` length 1–4. Returns certificate fingerprints, serial number, and mandantId.
|
||
- Step 2 (Pairing): `authCode` length 6 (pairingpin from posterminal). Verifies the pairingpin, sets token, paired_at, and clientserial, revokes the pairingpin, and returns device credentials and company metadata.
|
||
|
||
|
||
## Query parameters
|
||
|
||
| Param | Required | Type | Description |
|
||
|-------|----------|------|-------------|
|
||
| `authCode` | yes | string | Discovery code (1-4 digits) or pairing PIN (6 digits) |
|
||
| `name` | no | string | Client device name or serial identifier (default 'JTL-POS') |
|
||
|
||
## Response `200`
|
||
|
||
Discovery or pairing successful
|
||
|
||
```json
|
||
{
|
||
"authCode": "678677",
|
||
"authToken": "df40ad2067954646abb0499548a52241",
|
||
"certificateFingerprint": "30DD111E8048B57E6A4FB75AD7E63F7E657F1262",
|
||
"certificateSerialNumber": "1BB1BD7844451E3AC6",
|
||
"mandantId": "1",
|
||
"mandantName": "eB-Standard",
|
||
"mandantDatabase": "eazybusiness",
|
||
"serverFingerprint": "30-DD-11-1E-80-48-B5-7E-6A-4F-B7-5A-D7-E6-3F-7E-65-7F-12-62",
|
||
"name": "…",
|
||
"serverTimestamp": "2026-09-29 11:00:00"
|
||
}
|
||
```
|
||
|
||
## Errors
|
||
|
||
| Status | Description |
|
||
|--------|-------------|
|
||
| 400 | Invalid or incorrect authentication code |
|
||
|
||
---
|
||
|
||
_Generated from `@openapi` JSDoc. Do not edit by hand — run `npm run docs:api`._
|