Grupos de assets de la organización
Crear grupo de assets de la organización
Create a new asset group for organizing your organization’s assets.
POST
Create asset group
Descripción general
Crea un nuevo grupo de Assets (activos digitales: URL, direcciones, perfiles, apps, etc.) para ordenar los assets de tu organización. Los grupos te ayudan a clasificar los assets por tipo, proyecto, propósito o cualquier otro criterio que tenga sentido para tu caso de uso.Inicio rápido
Autenticación
Incluye tu clave de API en el encabezadoX-API-KEY:
Solicitud de ejemplo
Cuerpo de la solicitud
Respuesta
Respuesta exitosa
Campos de la respuesta
Respuestas de error
400 Bad Request
Se devuelve cuando la solicitud tiene un formato incorrecto o falla la validación:401 Unauthorized
Se devuelve cuando la clave de API falta, no es válida o no tiene acceso a la organización:409 Conflict
Se devuelve cuando ya existe un grupo con el mismo nombre:Buenas prácticas
Convenciones de nombres
Usa nombres claros y descriptivos que reflejen el propósito del grupo:Verifica si ya existe el grupo
Antes de crear un grupo, verifica si ya existe uno con el mismo nombre:Creación de grupos por lotes
Crea varios grupos en secuencia:Casos de uso
Inicializar la estructura de grupos
Configura una estructura de grupos estándar para una organización nueva:Grupos por proyecto
Crea grupos para distintos proyectos:Grupos por entorno
Organiza por entorno (producción, staging, desarrollo):Creación dinámica de grupos
Crea grupos de forma dinámica según el tipo de asset:Mensajes de error comunes
Notas
- Los nombres de los grupos deben ser únicos dentro de tu organización
- Los nombres distinguen entre mayúsculas y minúsculas al verificar que sean únicos
- Los nombres de los grupos tienen una longitud máxima de 255 caracteres
- La organización se determina automáticamente a partir de tu clave de API
- Los grupos recién creados empiezan con cero assets
- Los grupos se pueden renombrar más adelante con el endpoint de actualización
- No hay un límite fijo para la cantidad de grupos por organización
Autorizaciones
Your API key. This is required by most endpoints to access our API programatically. Reach out to us at support@chainpatrol.io to get an API key for your use.
Cuerpo
application/json