> ## Documentation Index
> Fetch the complete documentation index at: https://docs.acedata.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# Obtener la lista de solicitudes de servicio de la plataforma AceDataCloud

> Platform API guide - Ace Data Cloud

Devuelve de forma paginada las Application que posee la cuenta o cuyo uso le ha sido autorizado, incluidos el saldo, el estado, el resumen del servicio y las credenciales asociadas. Adecuado para la supervisión masiva de saldos, la búsqueda de Application ID y el acceso a la gestión de credenciales.

## Preparativos

1. Inicie sesión en la [plataforma AceDataCloud](https://platform.acedata.cloud).
2. Cree un token de cuenta en la [consola de Account Token](https://platform.acedata.cloud/console/platform-tokens).
3. Los usuarios normales usan `user_id=me`; también puede obtener su propio UUID desde `GET /api/v1/platform-tokens/me/`.

```shell theme={null}
export PLATFORM_TOKEN='tu token de cuenta'
```

## Resumen de la API

| Elemento | Contenido |
| - | - |
| Método | `GET` |
| URL | `https://platform.acedata.cloud/api/v1/applications/` |
| Autenticación | Account Token, el token OAuth requiere `applications:read` |
| Paginación | `count` + `items` |

Los usuarios normales deben pasar `user_id=me`. Si no se pasa, la consulta no se restringe primero por cuenta, y la paginación podría devolver `403` al encontrar objetos sin autorización; los administradores pueden ver toda la tabla si no lo pasan.

## Parámetros de consulta

| Parámetro | Tipo | Obligatorio | Descripción |
| - | - | - | - |
| `user_id` | UUID / `me` | Obligatorio para usuarios normales | Sujeto de consulta; admite parámetros repetidos |
| `affiliation` | string | No | `owner` (predeterminado) o `granted`; se pueden pasar ambos repetidamente para obtener la unión, solo tiene efecto cuando existe `user_id` |
| `service_id` | UUID | No | Filtrar por servicio; admite parámetros repetidos |
| `scope` | string | No | `Individual` o `Global`; admite parámetros repetidos |
| `type` | string | No | `Usage` o `Period`; admite parámetros repetidos |
| `limit` | integer | No | Número de elementos por página, máximo 100 |
| `offset` | integer | No | Desplazamiento de paginación |
| `ordering` | string | No | Solo admite `created_at` o `-created_at` |

`paid`, `disabled`, `expired`, `low_balance` y `tag` actualmente no son parámetros de filtrado del servidor. Para las alertas de saldo, se debe obtener la lista y determinar en el cliente según `remaining_amount`, `service.unit` y el umbral de negocio de cada Application.

## Ejemplo de solicitud

```shell theme={null}
curl --get 'https://platform.acedata.cloud/api/v1/applications/' \
  --data-urlencode 'user_id=me' \
  --data-urlencode 'affiliation=owner' \
  --data-urlencode 'limit=100' \
  -H "Authorization: Bearer ${PLATFORM_TOKEN}"
```

Ver simultáneamente las Application que posee y las que otros le han autorizado:

```shell theme={null}
curl --get 'https://platform.acedata.cloud/api/v1/applications/' \
  --data-urlencode 'user_id=me' \
  --data-urlencode 'affiliation=owner' \
  --data-urlencode 'affiliation=granted' \
  -H "Authorization: Bearer ${PLATFORM_TOKEN}"
```

## Descripción de la respuesta

La respuesta es `{count, items}`. Cada elemento incluye los campos del modelo Application y añade:

* `service`: `id`, `alias`, `title`, `type`, `unit`, `icon_url`;
* `credentials`: el resumen de credenciales que el llamador actual tiene permitido ver;
* `paid`, `remaining_amount`, `used_amount`, `disabled`, `allow_consume_global`;
* el valor real de `scope` es `Individual` o `Global`;
* el valor real de `type` es `Usage` o `Period`.

`remaining_amount` puede estar vacío; el cliente debe comprobar primero si está vacío antes de realizar comparaciones numéricas. La unidad de cuota está determinada por `service.unit`.

## Siguiente paso

* [Consultar los detalles de una sola Application](https://platform.acedata.cloud/documents/platform-application-detail)
* [Guía rápida de supervisión de saldo](https://platform.acedata.cloud/documents/application-remaining-amount)
* [Crear credenciales de API](https://platform.acedata.cloud/documents/platform-credential-create)
* [Crear una orden de recarga](https://platform.acedata.cloud/documents/platform-order-create)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.