Claves de API

Consulta tus claves de API, crea una clave limitada a algunos de tus proyectos (por ejemplo, una por cada proyecto de cliente) o revoca una de ellas. Estos endpoints requieren una clave de API que vea toda la cuenta y tenga el ámbito read_write.

GET/api_keys

Tus claves de API, primero las más recientes, incluidas las revocadas, con name, el prefix visible, scope, project_ids (vacío si la clave ve toda la cuenta), last_used_at y revoked_at. Nunca se devuelve el token secreto. También está disponible por debajo del plan Scale, para que puedas seguir revocando las claves antiguas.

Parámetros:
  • page
  • per_pagepor defecto 20, máximo 100

POST/api_keys

Crea una clave limitada a los proyectos de project_ids y que pertenece al usuario de la clave que hace la llamada. Su token secreto solo se devuelve en esta respuesta, así que guárdalo. La clave nunca ve otros proyectos, y este endpoint nunca crea una clave que vea toda la cuenta. Si incluyes un proyecto al que no tienes acceso, se devuelve ERR_PROJECT_NOT_FOUND; si ya tienes 500 claves activas, se devuelve ERR_LIMIT_REACHED hasta que revoques una. Requiere el plan Scale o superior.

Cuerpo (JSON):
  • nameobligatorio, hasta 100 caracteres
  • project_idsobligatorio, al menos un id de proyecto
  • scoperead por defecto, o read_write

DELETE/api_keys/:id

Revoca una de tus claves: deja de funcionar de inmediato y no se puede restaurar. Volver a revocarla no cambia nada. También está disponible por debajo del plan Scale.

Ruta:
  • :idid de la clave en GET /api_keys

Devuelve ERR_NOT_FOUND para una clave de otro usuario.