Cloud API · Claves

Emitir clave de la Local API

Emite el secreto de firma de un terminal y la huella de su certificado local.

POST/terminals/:terminalId/device-bridge-key

Cabeceras

Nombre	Valor
`Content-Type`	`application/json`
`Authorization`	`Bearer <clientSecret>`
`venue-api-key`	El identificador del restaurante

Son las mismas credenciales que en el resto de la Cloud API: consulta Autorización.

Cuerpo

No hace falta enviar cuerpo.

Respuesta

200 OK

JSON

{
    "secret": "d8bb77883e6b1704bf475d24fd4c041b5c46019d887d1d646ab97f2110a631c",
    "issuedAt": 1789480095634,
    "certificateFingerprint": "e454287e3e6a200c71f670e0b5ef3887866495e017f57ac4d43a33dc1f953566"
}

secret: la clave compartida con la que se firma cada petición de la Local API. Guárdala: esta respuesta es la única vez que la verás en claro.
issuedAt: cuándo se emitió el secreto, en milisegundos desde epoch.
certificateFingerprint: huella SHA-256 del certificado HTTPS local del terminal, para fijarlo (consulta URL base). Es null si el terminal aún no la ha comunicado. En ese caso, vuelve a intentarlo más tarde: la envía poco después de arrancar.

403 Forbidden

JSON

{
    "status": 403,
    "message": "Not authorized"
}

Se devuelve si alguna cabecera es incorrecta o si el terminal no pertenece a tu integración.

404 Not Found

JSON

{
    "status": 404,
    "message": "Terminal not found"
}