Autenticación

ArchiCore utiliza claves API para la autenticación.

Obtener una Clave API

1. Inicia sesión en ArchiCore
2. Ve a Configuración → Desarrollador
3. Haz clic en Generar Clave API
4. Copia y guarda tu clave de forma segura

aviso

Las claves API solo se muestran una vez. ¡Guárdalas de forma segura!

Usar la Clave API

Incluye la clave en el header Authorization:

curl -H "Authorization: Bearer sk_live_xxxxx" \
  https://api.archicore.io/api/v1/projects

O como parámetro de consulta (no recomendado):

curl "https://api.archicore.io/api/v1/projects?api_key=sk_live_xxxxx"

Tipos de Clave

Prefijo	Tipo	Descripción
sk_live_	Producción	Acceso completo a tu cuenta
sk_test_	Prueba	Acceso limitado, para desarrollo

Permisos de Clave

Las claves API heredan permisos según el nivel de tu cuenta:

Permiso	Gratis	Pro	Empresa
Leer proyectos	✓	✓	✓
Crear proyectos	✓	✓	✓
Análisis	✓	✓	✓
Webhooks	-	✓	✓
Acceso de equipo	-	-	✓

Revocar Claves

Para revocar una clave API:

1. Ve a Configuración → Desarrollador
2. Encuentra la clave en la lista
3. Haz clic en Revocar

Las claves revocadas dejan de funcionar inmediatamente.

Mejores Prácticas de Seguridad

1. Nunca commits claves API en el control de versiones
2. Usa variables de entorno para almacenar claves
3. Rota las claves regularmente (recomendado: cada 90 días)
4. Usa claves de prueba para desarrollo
5. Monitorea el uso en el dashboard

Variables de Entorno

# .env (¡añadir a .gitignore!)
ARCHICORE_API_KEY=sk_live_xxxxx

const client = new ArchiCore({
  apiKey: process.env.ARCHICORE_API_KEY
});

OAuth (Próximamente)

El soporte para OAuth 2.0 está planeado para integraciones de equipo.