Disponible en el plan Marketer y superiores.
La clave API es la contraseña que utilizan tus otras herramientas para comunicarse con la API REST de Pretty Links. Tu sitio web tiene una clave API, que se genera automáticamente al activar las Herramientas para desarrolladores, y puedes volver a generarla en cualquier momento.
Esta guía forma parte de la Descripción general del complemento «Pretty Links Developer Tools», el punto de acceso al complemento «Herramientas de desarrollo».
Cómo encontrar y copiar tu clave
- En el panel de administración de WordPress, ve a Panel de control > Pretty Links > Herramientas para desarrolladores.
- Abre el Clave API sección.
- Tu clave actual aparece en pantalla. Haz clic en Copiar para copiarlo en el portapapeles.
La clave es una cadena alfanumérica de 10 caracteres (una combinación de mayúsculas, minúsculas y números). Pégala en la herramienta que necesite acceder a la API.
Envío de la clave tras una solicitud
La API REST acepta la clave en cualquiera de estos dos encabezados HTTP:
PRLI-API-KEY: tu clave aquí;Autorización: yourkeyhere.
La mayoría de las herramientas tienen un campo llamado “Clave API” o “Autorización”: pega tu clave ahí. La aplicación Documentos pestaña (en Panel de control > Pretty Links > Herramientas para desarrolladores > Documentación) muestra el formato exacto del encabezado y un ejemplo de «curl» que puedes copiar.
Cómo guardar la llave de forma segura
Trata la clave de la API como si fuera una contraseña:
- No lo pegues en lugares públicos como canales de Slack, tickets de asistencia o incidencias de GitHub. Cualquier persona que tenga la clave puede leer y modificar tus Pretty Links;
- Guárdala en un gestor de contraseñas o en la caja fuerte de secretos de tu equipo. No lo anotes en una nota adhesiva;
- No lo guardes en un repositorio. Si tu código de integración está en Git, lee la clave desde una variable de entorno o un gestor de secretos; nunca la incluyas directamente en el código.
Regeneración de la clave
Si la clave se filtra, se pierde o quieres una nueva, vuelve a generarla:
- Ir a Panel de control > Pretty Links > Herramientas para desarrolladores.
- En el Clave API sección, haz clic en Regenerar.
- Confirma la acción.
La regeneración invalida inmediatamente la clave antigua y la sustituye por una nueva. Cualquier sistema que siga utilizando la clave antigua empezará a mostrar errores de autenticación; actualiza esos sistemas con la nueva clave lo antes posible.
Cuándo regenerar
Debes rotar o regenerar la clave cuando:
- Un empleado con acceso a la llave abandona el equipo;
- La llave se dejó por error en un sitio donde no debía estar;
- Se va a retirar una integración y quieres bloquear el acceso a ella;
- Estás aplicando una política de rotación periódica (cada 90 o 180 días, por ejemplo).
No hay ninguna razón “incorrecta” para regenerar la clave. Si tienes alguna duda sobre si la clave sigue siendo segura, regenera la clave.
Una clave por sitio web
Developer Tools utiliza una única clave API para todo el sitio, en lugar de claves específicas para cada integración. Esto simplifica la gestión administrativa, pero implica que la rotación de la clave afecta a todas las integraciones a la vez; por lo tanto, planifica la rotación para cuando puedas actualizar todas tus herramientas conectadas (Zapier, scripts, paneles de control) en la misma sesión.