API de gestión de organizaciones¶
Una organización agrupa cámaras, carpetas y usuarios. Un sistema externo de gestión puede crear organizaciones para las instalaciones de una empresa y gestionar el acceso a sus cámaras. Todos los ejemplos usan Client API v3 y autenticación Bearer.
Crear y eliminar organizaciones requiere permiso de gestión de organizaciones del dominio. El propietario también puede cambiar el nombre de su organización. Modificar límites o propietario requiere permisos de dominio; ser propietario no basta.
Obtener la lista de organizaciones¶
GET /watcher/client-api/v3/organizations?limit=100
Authorization: Bearer <token>
La respuesta contiene organizations y los campos de paginación next, prev y estimated_count. Para la siguiente página, envíe next como cursor, conservando los demás filtros. Solo se devuelven organizaciones accesibles para quien realiza la solicitud.
Crear una organización¶
En dominios sin fecha de creación o creados antes del 16 de enero de 2026 a las 08:30:29.622 UTC, existe una condición adicional: fuera del dominio principal, la creación y modificación administrativa solo se permiten al usuario billing o a un nombre terminado en _master. Téngalo en cuenta al elegir la cuenta de servicio.
El ejemplo crea una organización con un usuario existente como propietario: sustituya 15 por su ID en Watcher. Si se omite owner.id, el creador será el propietario.
POST /watcher/client-api/v3/organizations
Authorization: Bearer <token>
Content-Type: application/json
{
"title": "Edificio de calle Jardín",
"owner": {"id": 15},
"limits": {"streams": 24, "users": 50}
}
Guarde el id devuelto. Watcher crea también la carpeta raíz Cameras. En los siguientes ejemplos independientes de lectura, modificación y eliminación, sustituya 7 por el ID de la organización; 16 es el ID del nuevo propietario.
Los límites se incluyen en limits:
- streams — máximo de cámaras; valor predeterminado del esquema:
5000. - users — máximo de usuarios; valor predeterminado:
2000.
El archivo se configura mediante el preajuste y la cámara. Los antiguos campos camera_limit, user_limit y dvr_limit no se utilizan en el ejemplo v3.
Obtener información de la organización¶
GET /watcher/client-api/v3/organizations/7
Authorization: Bearer <token>
La respuesta incluye configuración y estadísticas. user_permissions describe los permisos de quien realiza la solicitud en esa organización. Ayuda a identificar acciones disponibles, pero la solicitud de modificación realiza la comprobación definitiva.
Modificar una organización¶
PUT /watcher/client-api/v3/organizations/7
Authorization: Bearer <token>
Content-Type: application/json
{"title": "Calle Jardín, edificio 2", "limits": {"streams": 32, "users": 50}}
Envíe los campos que cambian. Para cambiar el propietario, indique {"owner":{"id":16}}. Watcher retira la condición de propietario a los participantes anteriores y asigna el nuevo; si aún no es miembro, crea su pertenencia.
Un propietario sin permiso de gestión de organizaciones del dominio puede cambiar el nombre. Para límites o propietario, use una cuenta con permisos de dominio.
Eliminar una organización¶
DELETE /watcher/client-api/v3/organizations/7
Authorization: Bearer <token>
X-Force: true
Sin X-Force, Watcher rechaza eliminar organizaciones con objetos dependientes. La carpeta raíz también es dependiente. X-Force permite la eliminación en cascada junto con sus objetos. También elimina las cuentas que solo pertenecen a esa organización. Compruebe primero el contenido y el ID de la URL. No se puede eliminar la organización predeterminada del dominio. La respuesta correcta es 204.
La API de usuarios describe cómo retirar un miembro conservando su cuenta.