Ir al contenido

Tokens de API y la licencia de sandbox

82 vistas · Actualizado Nov 22, 2026

Los autores tienen dos herramientas para integrar comprobaciones de licencia en un producto: los tokens de API, que autentican solicitudes a la API de AppTrovo en nombre de tu cuenta, y las licencias de prueba para desarrolladores gratuitas, que te permiten ejecutar todo el flujo de verificación de licencias en tu propia máquina antes de que cualquier comprador tenga una clave.

Tokens de API

Cuándo necesitas un token

El endpoint de verificación de licencias (/api/v1/licenses/verify) es público. Tu producto no necesita un token para comprobar la clave de un comprador. Los tokens son para las partes autenticadas de la API, como listar las licencias que tiene tu cuenta (/api/v1/licenses) o leer tus propios datos de autor en /api/v2/author/.

Un token actúa como tu cuenta. Nunca incluyas un token en un producto que vendes, en un repositorio público ni en código del lado del cliente. Cualquiera que lo tenga puede hacer llamadas a la API en tu nombre.

Crear un token

  1. Ve a /author/api-tokens con la sesión iniciada en tu cuenta de autor.
  2. En Crear nuevo token, ingresa un Nombre del token que indique dónde se usará, por ejemplo, "Servidor de compilación".
  3. Haz clic en Crear token.
  4. Copia el token del recuadro verde de inmediato. No se volverá a mostrar. Haz clic en Descartar cuando lo hayas guardado en un lugar seguro.
Página Tokens de API con un campo Nombre del token y un botón Crear token, una sección Tus tokens que indica que aún no se han creado tokens de API y un recuadro Uso de la API con un ejemplo de solicitud de verificación y sus encabezados
La página Tokens de API en el Panel de autor.

Envía el token en el encabezado Authorization: Bearer , junto con Accept: application/json.

Gestionar y revocar tokens

Tus tokens muestra cada token con su nombre, la fecha en que se creó y cuándo se usó por última vez, o "Nunca usado". Puedes tener hasta 10 tokens a la vez. Los tokens no caducan por sí solos, así que revoca los que ya no necesites: haz clic en Revocar y confirma. Un token revocado deja de funcionar de inmediato. Si un token pudo haberse filtrado, revócalo y crea uno nuevo.

La licencia de sandbox del SDK

El sandbox te permite probar la verificación de licencias antes de haber creado un producto. Te da una clave de desarrollador para un producto de sandbox compartido cuyo slug es apptrovo-sdk-sandbox.

  1. Abre /author/sandbox-license. Si todavía no tienes productos, tu panel de autor también muestra un botón Obtener licencia de sandbox.
  2. Haz clic en Generar. Tu clave aparece con un botón para copiarla, su fecha de vencimiento, los espacios de dominio en uso y el slug del producto.
  3. Copia los comandos de Prueba rápida de humo que se muestran debajo de la clave. El primero, con domain=localhost, debe devolver "valid": true. El segundo, con un dominio público, debe ser rechazado.
  4. Apunta tu instalador al slug del sandbox y recorre tus escenarios de verificación.
Página Licencia de sandbox del SDK con una tarjeta de tu licencia de desarrollo de sandbox que enumera los dominios locales permitidos y un botón Generar, seguida de un aviso amarillo sobre qué hacer al publicar tu propio producto y un enlace de vuelta a la guía de integración de licencias
Genera una clave de sandbox desde la página Licencia de sandbox del SDK.

Licencias de desarrollador para tus propios productos

Una vez que tengas un producto, haz las pruebas directamente con él:

  1. Abre Mis productos y haz clic en el producto para abrir su página de detalle.
  2. Busca la tarjeta Licencia de prueba para desarrolladores y haz clic en Generar.
  3. Copia la clave y el slug del producto de la tarjeta y luego usa el comando de Prueba rápida para confirmar que funciona.

Cuando publiques, cambia el slug del sandbox en la configuración de tu instalador por el slug real de tu producto. El resto de tu integración sigue igual.

Reglas de las licencias de desarrollador

Las licencias de sandbox y las licencias de desarrollador por producto funcionan de la misma manera:

  • Solo se validan en nombres de host locales: localhost, 127.0.0.1, ::1 y nombres que terminan en .test, .local o .localhost. Un dominio real se rechaza, así que la clave no se puede usar en producción.
  • Cada comprobación debe incluir el parámetro domain.
  • Cada clave tiene 5 espacios de dominio y es válida por 30 días. Haz clic en Extender 30 días en la misma tarjeta para aplazar el vencimiento. La clave sigue siendo la misma.
  • Obtienes una licencia de desarrollador por producto. Si vuelves a generarla, se extiende la clave existente en lugar de crear una nueva.
  • La respuesta de verificación indica "license_type": "developer" e "is_dev": true, para que tu código pueda distinguir las claves de prueba.

Preguntas frecuentes

¿Por qué no veo Tokens de API en la barra lateral?

Por ahora la página no tiene una entrada en el menú. Guarda /author/api-tokens en tus marcadores.

Mi clave de desarrollador dice "License has expired"

Abre la tarjeta donde la creaste y haz clic en Extender 30 días. La misma clave vuelve a funcionar.

Artículos relacionados

¿Te fue útil este artículo?