Necesitas una clave API de Master Console para autenticar las solicitudes API destinadas a crear y configurar tus espacios de trabajo. Una clave API es un identificador único asociado a tu cuenta. Es necesaria tanto para el uso del servicio como para la facturación.
Crear tu clave API de Master Console
Puedes acceder a la sección Claves API desde la barra lateral izquierda de tu Master Console principal.
Ten en cuenta que puedes tener hasta 5 claves API por Master Console.
Si eliminas una clave API, ya no podrás utilizarla para autenticar tus solicitudes.
Recomendaciones
- Asigna un nombre explícito a tu clave API. Te resultará más fácil identificar qué clave API se puede eliminar, por ejemplo.
- Copie su clave API y guárdela en un lugar seguro. Por motivos de seguridad, Universign no almacena las claves API en texto sin cifrar.
Autenticar su solicitud
Una vez creada tu clave API de Master Console, ya estás listo para autenticar tu solicitud. Añádela al encabezado de la solicitud como el valor del nombre de usuario seguido de dos puntos: -u your_API_key: (el campo de la contraseña puede dejarse vacío).
Como alternativa, puedes autenticarte mediante la autenticación de portador: -H "Authorization: Bearer your_API_key".
Ten en cuenta que una clave API de Master Console no se puede utilizar para autenticar solicitudes de transacción, sello, sellado de tiempo, etc.
Errores de autenticación
Si no introduces una clave API o introduces una clave no válida cuando se requiere autenticación, recibirás una respuesta 401 - Unauthorized.
Si la clave API que has introducido no te da acceso al recurso, recibirás una respuesta 403 - Forbidden.
