Crear una clave de API

Crea claves en la consola con límite de gasto y caducidad opcionales; la clave completa solo se muestra una vez.

Necesitas una clave de API antes de llamar a la API. Las claves se crean y se gestionan en la página «Claves de API» de la consola; una cuenta puede tener varias claves para distintos fines.

Cómo crear una clave

  1. Inicia sesión y abre la consola, y elige Claves de API en la navegación izquierda.
  2. Haz clic en «Crear clave» y rellena lo siguiente:
CampoObligatorioDescripción
NombreSíPonle un nombre según su finalidad para distinguirla fácilmente, por ejemplo production, test.
Límite de gasto (USD)OpcionalTope de gasto acumulado de esta clave. Déjalo vacío para que sea ilimitado.
Fecha de caducidadOpcionalLa clave deja de funcionar automáticamente después de esa fecha. Déjala vacía para que no caduque.
  1. Envía el formulario para crearla. El diálogo muestra la clave completa una única vez: cópiala y guárdala en un lugar seguro de inmediato.

Cómo se muestran las claves

  • La clave completa se muestra solo una vez, en el momento de crearla. Después de cerrar el diálogo ya no se puede volver a ver.
  • La lista de claves muestra siempre una forma enmascarada (prefijo y últimos 4 caracteres) para protegerte de miradas ajenas.
  • ¿Has perdido una clave? Elimínala y crea otra nueva: la nueva clave funciona de inmediato.

Recomendaciones de seguridad

  • No pongas nunca una clave en código de frontend, en un repositorio público ni en un mensaje de chat: cualquiera que tenga la clave puede gastar tu saldo.
  • Separa las claves por entorno (una para producción, otra para pruebas) y define un límite de gasto en la clave de producción para acotar el daño potencial.
  • Si sospechas de una filtración, elimina la clave y crea otra nueva de inmediato. La eliminación surte efecto al momento: las llamadas con la clave antigua reciben 401.
  • Para dar acceso temporal a alguien, crea una clave aparte con un límite pequeño y elimínala después, en lugar de compartir tu clave principal.