Ir al contenido
POST
/cloud/plataforma/clientes/{id}/claves
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.

id
required
string

Id del cliente (cli_… o uuid)

Media typeapplication/json
object
nombre
required
string
<= 80 characters

Example

POS Casa Barista
modo
required
string
Allowed values: test live
scopes
required
Array<string>

Example

[
"dte:emit",
"dte:read"
]
expiraEnDias
integer | null
>= 1 <= 3650

Clave creada.

Media typeapplication/json
object
id
string
nombre
string
prefijo
string
modo
string
Allowed values: test live
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.