Crear una clave para el cliente
POST
/cloud/plataforma/clientes/{id}/claves
const url = 'https://app.openfactura.co/cloud/plataforma/clientes/example/claves';const options = { method: 'POST', headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'}, body: '{"nombre":"POS Casa Barista","modo":"test","scopes":["dte:emit","dte:read"],"expiraEnDias":1}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request POST \ --url https://app.openfactura.co/cloud/plataforma/clientes/example/claves \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "nombre": "POS Casa Barista", "modo": "test", "scopes": [ "dte:emit", "dte:read" ], "expiraEnDias": 1 }'Clave de API en el espacio del cliente: emite a su nombre y sólo ve sus datos. La clave completa sólo aparece en esta respuesta. Una clave de pruebas tuya sólo crea claves de pruebas.
Authorizations
Sección titulada «Authorizations»Parameters
Sección titulada «Parameters»Path Parameters
Sección titulada «Path Parameters»id
required
string
Id del cliente (cli_… o uuid)
Request Bodyrequired
Sección titulada «Request Bodyrequired»Media typeapplication/json
object
nombre
required
string
Example
POS Casa Baristamodo
required
string
scopes
required
Array<string>
Example
[ "dte:emit", "dte:read"]expiraEnDias
integer | null
Responses
Sección titulada «Responses»Clave creada.
Media typeapplication/json
object
id
string
nombre
string
prefijo
string
modo
string
estado
string
creado
integer
clave
Sólo aparece aquí.
string
Example
{ "modo": "test", "clave": "of_live_…"}Datos inválidos
Media typeapplication/json
object
error
object
code
string
message
string
details
Example
{ "error": { "code": "plan_requerido" }}Tu plan no lo incluye (plan_requerido)
Media typeapplication/json
object
error
object
code
string
message
string
details
Example
{ "error": { "code": "plan_requerido" }}Sin permiso o clave no habilitada para Plataforma (clave_sin_plataforma)
Media typeapplication/json
object
error
object
code
string
message
string
details
Example
{ "error": { "code": "plan_requerido" }}No existe o no es tuyo
Media typeapplication/json
object
error
object
code
string
message
string
details
Example
{ "error": { "code": "plan_requerido" }}Conflicto (p. ej. cliente_no_pendiente, external_id_repetido)
Media typeapplication/json
object
error
object
code
string
message
string
details
Example
{ "error": { "code": "plan_requerido" }}Para asistentes de IA: llms.txt ·llms-full.txt ·cada página en Markdown añadiendo .md a su ruta.