Hoppa till huvudinnehåll
「Ansökan(Application)」representerar det aktuella kontots prenumerationsrelation till en viss tjänst — du måste först ansöka innan du kan skapa API-autentiseringsuppgifter för denna ansökan och anropa verksamhetsgränssnitt. När du ansöker om en tjänst för första gången får Application tjänstens för närvarande konfigurerade free_amount; detta värde kan vara 0.
ℹ️ Detta gränssnitt tillhör AceDataCloud-plattformens hanterings-API, med det gemensamma prefixet https://platform.acedata.cloud/api/v1/. Se Hämta AceDataCloud-plattformens dokumentlista för ett fullständigt gränssnittsindex.

Fullständig integrationsprocess

Nya användare går vanligtvis igenom dessa 5 steg från registrering till att lyckas anropa sitt första verksamhetsgränssnitt:
  1. Skaffa kontotoken → Hantera AceDataCloud-plattformens kontotoken
  2. Välj tjänst → Hämta AceDataCloud-plattformens tjänstelista
  3. Skapa ansökan(detta dokument) → Få initial kvot enligt tjänstekonfigurationen
  4. Skapa API-autentiseringsuppgifter → Skapa AceDataCloud-plattformens API-autentiseringsuppgifter
  5. Anropa verksamhetsgränssnitt → Anropa https://api.acedata.cloud/<path> med den erhållna 32-siffriga Token

Gränssnittsöversikt

Autentiseringsbeskrivning(hur man hämtar kontotoken)

Begärandehuvud:
Kontotoken(Account Token)är utvecklarens “kontonivånyckel” för att hantera egna kontoresurser via API. Hämtningsmetoder:
  1. Skapa med ett klick i konsolen(rekommenderas):Logga in på AceDataCloud-plattformen → Account Token-konsolen → Klicka på 「Skapa」för att få en token som börjar med platform-v1-.
  2. Skapa via API:Använd en befintlig kontotoken eller JWT för webbläsarens inloggningssession för att anropa POST /api/v1/platform-tokens/, se Hantera AceDataCloud-plattformens kontotoken för detaljer.
⚠️ Kontotoken är lika känslig som ett lösenord och får inte skrivas i frontend-kod eller offentliga kodarkiv. Om den läcker ska du omedelbart radera och skapa om den i konsolen.

Begärandetext

Begärandeexempel

cURL

Python

Node.js

Svarsexempel

Lyckades(HTTP 201)

Strukturen för returnerade fält är densamma som i Hämta detaljer om AceDataCloud-plattformens tjänstansökan.

Redan ansökt om(HTTP 400)

Detta är en hård begränsning i designen: varje användare kan endast ha en Application för varje tjänst. När den redan finns, sök efter den befintliga via Hämta AceDataCloud-plattformens tjänstansökningslista.

Tjänsten finns inte(HTTP 404)

Tjänsten kräver granskning(HTTP 403)

Om tjänstens need_verify=true(detta fält kan ses i tjänstelistan)måste du följa ärendeprocessen för att ansöka om vitlistning.

Felhantering

Enhetligt format för felsvar:

Praktiska tips

  • Själva skapandet debiteras inte: Vid första skapandet anges den initiala kvoten enligt tjänstens aktuella free_amount; värdet kan vara 0, och upprepat skapande av samma typ av Application garanterar inte att den kostnadsfria kvoten ges igen.
  • Om betalning krävs avgörs av fältet paid: Precis efter ansökan är paid=false, och efter att skapa AceDataCloud-plattformens påfyllningsorder har anropats för att slutföra betalningen ändras det till true.
  • disabled=true innebär att den har inaktiverats tillfälligt—till exempel vid utlöst riskkontroll, obetalda avgifter osv. När den är inaktiverad returnerar affärsgränssnittet 403.
  • Skapa inte med obegränsad parallellitet: Hämta först mål-service_id från den paginerade tjänstelistan och ansök sedan om dem en efter en enligt verksamhetsbehov; återanvänd befintlig Application när duplication uppstår.

Relaterade gränssnitt

allow_overdraft är avstängt som standard och beviljas separat av administratören; det kan inte aktiveras på egen hand via begärandeparametrar när en Application skapas.