Restofy Docs
Acceso y sesiones POST

Generar token desde clave de acceso

POST /api/auth/create-api-token

Descripción

Canjea una clave de acceso por un token de sesión para operar la API de un negocio.

Detalles

* Permite que una integración externa autentique sus llamadas a partir de una clave de acceso. * El negocio al que pertenece la clave se indica en el cuerpo de la solicitud y queda sellado dentro del token emitido. * El token emitido tiene vigencia limitada; al vencer, se debe volver a canjear la clave. * Falla si la clave no es válida o fue revocada.

Permisos requeridos

public

Request

Nombre Tipo Requerido Reglas
apiKey string
max:200
tenantKey string
max:63

Ejemplo de request

curl -X POST https://restofy.pro/api/auth/create-api-token \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <accessToken>" \
  -d '{
    "apiKey": "string",
    "tenantKey": "string"
}'

Los valores son demo: reemplázalos por datos reales del negocio.

Ejemplo de respuesta

Actualizado: 2026-09-13T21:05:19Z
HTTP 200

Request

{
    "apiKey": "rsk_93479359f3a06022c11501688200af4fafba0955b0b05163",
    "tenantKey": "restofy_test_createapikeytest_1082_1789332281_tenant"
}

Response

{
    "success": true,
    "message": "Operación realizada correctamente",
    "data": {
        "accessToken": "***",
        "actorUuid": "2d0d3d88-ee9a-4fd2-86f4-cfdf93535e71",
        "name": "Clave canjeable"
    }
}