Hämta Proxy-anropsposter från AceDataCloud-plattformen

Fråga efter den aktuella kontots användningsposter under tjänster av typen Proxy. För vanliga API-anrop, använd API-anropsposter. Om tjänsttypen är osäker kan du först kontrollera type i tjänstdetaljer.

Förberedelser

Logga in på AceDataCloud-plattformen.
Skapa en kontotoken i Account Token-konsolen, och spara den omedelbart i en lösenordshanterare eller Secret Manager.
Öppna profilsidan, kopiera UUID för det aktuella kontot och spara det som USER_ID. user_id i svaret när kontotoken skapas kan också användas.
Hämta application_id för tjänster av typen Proxy från listan över tjänsteansökningar. Om filtrering efter Proxy-slutpunkt krävs, hämta proxy_id från Proxy-listan under tjänsten.

Fullständig tokeninformation finns i Hantera kontotoken. Detta gränssnitt använder Account Token, inte Credential som används för att anropa affärs-API:er.

export PLATFORM_TOKEN='din kontotoken'
export USER_ID='ditt konto-UUID'
export APPLICATION_ID='ditt Proxy Application ID'

API-översikt

Punkt	Innehåll
Metod	`GET`
URL	`https://platform.acedata.cloud/api/v1/usage/proxies/`
Autentisering	`Authorization: Bearer ${PLATFORM_TOKEN}`
Scope	`usage:read`
Sidindelning	`count` + `items`, 10 poster per sida som standard

När Application-ägaren frågar med application_id synkroniserar servern först tillgängliga poster för denna Application och returnerar sedan listan. Därför kan svarstiden vara längre än för vanliga API usage-listor. Auktoriserade användare kan läsa befintliga synliga poster, men utlöser inte synkronisering på ägarsidan.

Frågeparametrar

Parameter	Typ	Obligatorisk	Standard	Beskrivning
`user_id`	UUID	Obligatorisk för vanliga användare	—	UUID för aktuellt konto; att skicka ett annat konto returnerar `403`
`application_id`	UUID	Rekommenderas	—	Filtrera efter Proxy Application; upprepade parametrar stöds
`proxy_id`	UUID	Nej	—	Filtrera efter Proxy-slutpunkt; upprepade parametrar stöds
`limit`	integer	Nej	10	Antal poster per sida, högst 100
`offset`	integer	Nej	0	Sidförskjutning
`ordering`	string	Nej	`-created_at`	Fallande ordning efter skapandetid

Det aktuella gränssnittet stöder inte direkt filtrering efter modell, HTTP-statuskod, Credential eller tidsintervall, och stöder inte heller parametern perspective från API usage-gränssnittet. Lägg inte till dessa parametrar som inte stöds i begäran och anta att de har trätt i kraft.

Begäransexempel

curl --get 'https://platform.acedata.cloud/api/v1/usage/proxies/' \
  --data-urlencode "user_id=${USER_ID}" \
  --data-urlencode "application_id=${APPLICATION_ID}" \
  --data-urlencode 'limit=100' \
  --data-urlencode 'ordering=-created_at' \
  -H "Authorization: Bearer ${PLATFORM_TOKEN}"

Python-exempel för sidindelning:

import os
import requests

response = requests.get(
    "https://platform.acedata.cloud/api/v1/usage/proxies/",
    headers={"Authorization": f"Bearer {os.environ['PLATFORM_TOKEN']}"},
    params={
        "user_id": os.environ["USER_ID"],
        "application_id": os.environ["APPLICATION_ID"],
        "limit": 100,
    },
    timeout=60,
)
response.raise_for_status()
data = response.json()

for usage in data["items"]:
    print(usage["created_at"], usage["deducted_amount"], usage["remaining_amount"])

Svarsexempel

{
  "count": 1,
  "items": [
    {
      "id": "00000000-0000-4000-8000-000000000001",
      "user_id": "00000000-0000-4000-8000-000000000002",
      "actor_user_id": null,
      "application_id": "00000000-0000-4000-8000-000000000003",
      "proxy_id": "00000000-0000-4000-8000-000000000004",
      "credential_id": null,
      "used_amount": null,
      "deducted_amount": 1.25,
      "remaining_amount": 98.75,
      "metadata": null,
      "created_at": "2026-09-01T08:00:00Z",
      "updated_at": "2026-09-01T08:00:00Z",
      "service": {
        "id": "00000000-0000-4000-8000-000000000005",
        "title": "Example Proxy Service"
      },
      "credential": null
    }
  ]
}

Nyckelfält

Fält	Beskrivning
`user_id`	Kontot som står för denna debitering
`actor_user_id`	Den faktiska anroparen; äldre poster kan vara tomma
`application_id`	Proxy Application som genererade denna post
`proxy_id`	Motsvarande Proxy-slutpunkt
`credential_id`	ID för associerad autentiseringsuppgift; äldre poster kan vara tomma
`used_amount`	Användning i den ursprungliga posten; kan vara tom
`deducted_amount`	Slutligt faktiskt avdragen kvot
`remaining_amount`	Application återstående kvot efter debitering
`metadata`	Offentliga metadata; kan vara tomma
`service` / `credential`	Sammanfattning av associerade objekt för enkel visning; kan vara tom när det associerade objektet inte finns

Kvotenheten bestäms av service.unit för motsvarande Application.

Felhantering

HTTP	Betydelse	Hantering
401	Kontotoken saknas eller är ogiltig	Kontrollera Account Token, använd inte av misstag affärs-Credential
403	Saknar behörighet att visa posterna i begäran	Använd Application som tillhör det aktuella kontot, ta bort obehörig `user_id`
5xx	Synkronisering eller fråga misslyckades tillfälligt	Behåll filtreringsvillkoren och försök igen med backoff; vid fortsatta fel, ange Application ID och tid till supportpersonalen

Nästa steg

Visa API-anropsposter: Fråga efter detaljer för vanliga tjänster av typen API.
Hämta Proxy-listan under tjänsten: Hämta proxy_id.
Visa tjänsteansökningsdetaljer: Bekräfta återstående kvot och enhet.

Getting Started

AI Samtal

AI Bild

AI Video

AI Ljud

Web & Data

CAPTCHA

Identitet

Coding

Fler guider

Hämta Proxy-anropsposter från AceDataCloud-plattformen

Förberedelser

API-översikt

Frågeparametrar

Begäransexempel

Svarsexempel

Nyckelfält

Felhantering

Nästa steg

​Förberedelser

​API-översikt

​Frågeparametrar

​Begäransexempel

​Svarsexempel

​Nyckelfält

​Felhantering

​Nästa steg

Förberedelser

API-översikt

Frågeparametrar

Begäransexempel

Svarsexempel

Nyckelfält

Felhantering

Nästa steg