Administrar claves de API
Cree, copie y revoque las claves de API que usan sus integraciones para realizar llamadas a Apropos Public API. Solo los administradores del espacio de trabajo pueden administrar las claves, y el acceso a la API está disponible en los planes que incluyen esta función.
Crear una clave de API
Cree una clave desde Configuración > Claves de API y, luego, guárdela donde la use su integración. La clave sin procesar se muestra una sola vez, así que cópiela antes de cerrar el cuadro de diálogo.
Abra Configuración y seleccione la pestaña Claves de API.
Haga clic en Crear clave.
Introduzca un Nombre para la clave para poder reconocerla en la lista.
En el cuadro de diálogo Clave de API creada, copie la clave. Comienza con
ak_live_seguido de 64 caracteres hexadecimales y se muestra una sola vez; haga clic en Listo para cerrar el cuadro de diálogo y la clave sin procesar desaparecerá para siempre.
Guarde la clave en un lugar seguro y agréguela a su servicio conectado como credencial Bearer. Solo se almacena un hash de la clave, por lo que no podrá recuperar una clave perdida y deberá revocarla y crearla de nuevo.
Autenticar solicitudes
Envíe la clave en el encabezado Authorization de cada solicitud a Public API:
Authorization: Bearer ak_live_<secret>Las claves están vinculadas a su organización, por lo que cada consulta de clientes, propuestas y elementos se limita a los datos de esa organización. v1 no tiene ámbitos para las claves de API: una clave válida tiene acceso completo a Public API para su organización. Cada clave está limitada a 100 solicitudes por cada período de 60 segundos.
Revocar una clave de API
Revoque una clave cuando una integración ya no esté en uso o sospeche que la clave ha quedado expuesta. La lista de claves muestra el nombre de cada clave, la fecha de creación, el uso reciente y el estado de revocación. Revocar una clave hace que fallen inmediatamente todas las solicitudes que la utilizan, y las claves revocadas permanecen en la lista con la marca Revocada.
Consulte Apropos Public API para ver los recursos y endpoints a los que puede llamar con una clave.