https://api.getincloud.online/jacaerys/v1/forwards/origin-owners/{origin}Listar propietarios de origen
Recupera los propietarios que tienen procesos de reenvío configurados para un origen.
GET https://api.getincloud.online/jacaerys/v1/forwards/origin-owners/{origin}Permite recuperar todos los propietarios (usuarios o entidades) que tienen procesos de reenvío configurados para un origen (shortcode, longcode o ID alfanumérico). Es fundamental para la gestión de permisos y la auditoría de quién usa un recurso de entrada compartido.
Parámetros de la ruta
| Campo | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| origin | string | Sí | Código corto, número largo o identificador alfanumérico del cual se desean consultar los propietarios. |
Parámetros de consulta
| Campo | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| clientId | string | No | Filtra los propietarios asociados a un identificador de cliente específico. |
| externalId | string | No | Filtra los resultados según un identificador de sistema externo vinculado a la propiedad del origen. |
| page | integer | No | Número de página para la paginación. |
| limit | integer | No | Número de registros devueltos por página. |
Encabezados
| Campo | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| Authorization | string | Sí | Token de portador (Bearer token). Formato: Bearer <TU_TOKEN>. |
| accept | string | No | application/json. |
Respuestas
- 200 OK: la solicitud fue exitosa.
- owners (array de objetos): propietarios identificados. Cada objeto contiene:
- ownerId (string): identificador único del propietario.
- name (string): nombre o descripción del propietario.
- processesCount (integer): cantidad de procesos de reenvío que este propietario tiene activos en el origen.
- clientId (string): ID del cliente asociado.
- meta (objeto): información de paginación.
- totalItems (integer): total de propietarios encontrados.
- itemCount (integer): número de propietarios en la respuesta actual.
- itemsPerPage (integer): límite de registros por página.
- totalPages (integer): total de páginas disponibles.
- currentPage (integer): página actual.
- 400 Bad Request: formato de origen no soportado o parámetros de consulta incorrectos.
- 401 Unauthorized: el token es inválido, ha expirado o no tiene acceso a la API Jacaerys.
- 403 Forbidden: el usuario no tiene permisos suficientes para consultar la propiedad de este origen.
- 404 Not Found: no se encontró el origen especificado o no tiene propietarios con procesos asignados.
- 500 Internal Server Error: el documento continúa en la siguiente parte.