> ## 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.

# Hämta listan över tjänsteansökningar på AceDataCloud-plattformen

> Platform API guide - Ace Data Cloud

Returnerar sidindelat de Application som kontot äger eller har fått behörighet att använda, inklusive saldo, status, tjänstesammanfattning och associerade autentiseringsuppgifter. Lämpligt för batchövervakning av saldo, sökning efter Application ID och åtkomst till hantering av autentiseringsuppgifter.

## Förberedelser

1. Logga in på [AceDataCloud-plattformen](https://platform.acedata.cloud).
2. Skapa en kontotoken i [Account Token-konsolen](https://platform.acedata.cloud/console/platform-tokens).
3. Vanliga användare använder `user_id=me`; du kan också hämta din egen UUID från `GET /api/v1/platform-tokens/me/`.

```shell theme={null}
export PLATFORM_TOKEN='din kontotoken'
```

## API-översikt

| Post | Innehåll |
| - | - |
| Metod | `GET` |
| URL | `https://platform.acedata.cloud/api/v1/applications/` |
| Autentisering | Account Token, OAuth-token kräver `applications:read` |
| Sidindelning | `count` + `items` |

Vanliga användare bör skicka `user_id=me`. Om det inte skickas begränsas frågan inte först efter konto, och sidindelning kan returnera `403` vid objekt utan behörighet; om administratörer inte skickar det kan de se hela tabellen.

## Frågeparametrar

| Parameter | Typ | Obligatorisk | Beskrivning |
| - | - | - | - |
| `user_id` | UUID / `me` | Obligatorisk för vanliga användare | Frågesubjekt; stöder upprepade parametrar |
| `affiliation` | string | Nej | `owner` (standard) eller `granted`; båda kan skickas upprepade gånger för att ta unionen, gäller endast när `user_id` finns |
| `service_id` | UUID | Nej | Filtrera efter tjänst; stöder upprepade parametrar |
| `scope` | string | Nej | `Individual` eller `Global`; stöder upprepade parametrar |
| `type` | string | Nej | `Usage` eller `Period`; stöder upprepade parametrar |
| `limit` | integer | Nej | Antal poster per sida, högst 100 |
| `offset` | integer | Nej | Offset för sidindelning |
| `ordering` | string | Nej | Stöder endast `created_at` eller `-created_at` |

`paid`, `disabled`, `expired`, `low_balance` och `tag` är för närvarande inte filtreringsparametrar på serversidan. För saldoaviseringar bör listan hämtas och därefter bedömas på klientsidan utifrån varje Applications `remaining_amount`, `service.unit` och verksamhetströskelvärden.

## Begäransexempel

```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}"
```

Visa samtidigt Application som du äger och som andra har beviljat dig:

```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}"
```

## Svarsbeskrivning

Svaret är `{count, items}`. Varje post innehåller Application-modellfält och dessutom:

* `service`: `id`, `alias`, `title`, `type`, `unit`, `icon_url`;
* `credentials`: sammanfattning av autentiseringsuppgifter som den aktuella anroparen har behörighet att se;
* `paid`, `remaining_amount`, `used_amount`, `disabled`, `allow_consume_global`;
* det faktiska värdet för `scope` är `Individual` eller `Global`;
* det faktiska värdet för `type` är `Usage` eller `Period`.

`remaining_amount` kan vara tomt; klienten måste först kontrollera om det är tomt innan numeriska jämförelser görs. Kvotenheten bestäms av `service.unit`.

## Nästa steg

* [Fråga efter detaljer för en enskild Application](https://platform.acedata.cloud/documents/platform-application-detail)
* [Snabbguide för saldoövervakning](https://platform.acedata.cloud/documents/application-remaining-amount)
* [Skapa API-autentiseringsuppgifter](https://platform.acedata.cloud/documents/platform-credential-create)
* [Skapa en påfyllningsorder](https://platform.acedata.cloud/documents/platform-order-create)


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