Przejdź do głównej treści
„Wniosek (Application)” oznacza relację subskrypcji bieżącego konta z określoną usługą — należy najpierw złożyć wniosek, aby następnie móc utworzyć dla niego poświadczenia API i wywoływać interfejsy biznesowe. Przy pierwszym wniosku o daną usługę Application otrzyma bieżąco skonfigurowaną dla tej usługi wartość free_amount; wartość ta może wynosić 0.
ℹ️ Ten interfejs należy do API zarządzania platformą AceDataCloud, ze wspólnym prefiksem https://platform.acedata.cloud/api/v1/. Pełny indeks interfejsów znajdziesz w sekcji Pobieranie listy dokumentacji platformy AceDataCloud.

Pełny proces integracji

Nowi użytkownicy od rejestracji do uruchomienia pierwszego interfejsu biznesowego zwykle przechodzą przez te 5 kroków:
  1. Uzyskanie tokenu konta → Zarządzanie tokenami konta platformy AceDataCloud
  2. Wybór usługi → Pobieranie listy usług platformy AceDataCloud
  3. Tworzenie wniosku (ten dokument) → uzyskanie początkowego limitu zgodnie z konfiguracją usługi
  4. Tworzenie poświadczeń API → Tworzenie poświadczeń API platformy AceDataCloud
  5. Wywoływanie interfejsu biznesowego → użyj uzyskanego 32-znakowego Tokena do wywołania https://api.acedata.cloud/<path>

Przegląd interfejsu

Informacje o uwierzytelnianiu (jak uzyskać token konta)

Nagłówek żądania:
Token konta (Account Token) jest „kluczem na poziomie konta”, którego deweloperzy używają przez API do zarządzania zasobami własnego konta. Sposoby uzyskania:
  1. Tworzenie jednym kliknięciem w konsoli (zalecane): zaloguj się do platformy AceDataCloud → konsola Account Token → kliknij „Utwórz”, aby uzyskać token zaczynający się od platform-v1-.
  2. Tworzenie przez API: użyj istniejącego tokenu konta lub JWT sesji przeglądarki, aby wywołać POST /api/v1/platform-tokens/; szczegóły znajdziesz w sekcji Zarządzanie tokenami konta platformy AceDataCloud.
⚠️ Token konta jest równie wrażliwy jak hasło; nie wolno umieszczać go w kodzie frontendu ani w publicznych repozytoriach. W przypadku wycieku natychmiast usuń go w konsoli i utwórz ponownie.

Treść żądania

Przykłady żądań

cURL

Python

Node.js

Przykłady odpowiedzi

Sukces (HTTP 201)

Struktura zwracanych pól jest zgodna z Pobieraniem szczegółów wniosku o usługę platformy AceDataCloud.

Wniosek został już złożony (HTTP 400)

Jest to twarde ograniczenie projektowe: każdy użytkownik może mieć tylko jeden Application dla każdej usługi. Jeśli już istnieje, znajdź istniejący wniosek przez Pobieranie listy wniosków o usługi platformy AceDataCloud.

Usługa nie istnieje (HTTP 404)

Usługa wymaga weryfikacji (HTTP 403)

Jeśli usługa ma need_verify=true (to pole jest widoczne na liście usług), należy przejść przez proces zgłoszenia, aby ubiegać się o dodanie do białej listy.

Obsługa błędów

Ujednolicony format odpowiedzi błędu:

Praktyczne wskazówki

  • Samo utworzenie nie powoduje opłaty: przy pierwszym utworzeniu początkowy limit jest ustawiany zgodnie z bieżącym free_amount usługi; wartość ta może wynosić 0, a ponowne utworzenie Application tego samego typu nie gwarantuje ponownego przyznania darmowego limitu.
  • O tym, czy wymagana jest płatność, decyduje pole paid: tuż po zgłoszeniu paid=false, po wywołaniu utworzenia zlecenia doładowania platformy AceDataCloud i zakończeniu płatności zmienia się na true.
  • disabled=true oznacza tymczasowe wyłączenie — na przykład z powodu uruchomienia kontroli ryzyka, zaległości płatniczych itp. Gdy usługa jest wyłączona, interfejs biznesowy zwróci 403.
  • Nie twórz bez ograniczeń równolegle: najpierw pobierz docelowe service_id z listy usług stronicowanych, a następnie zgłaszaj je pojedynczo zgodnie z potrzebami biznesowymi; w przypadku duplication wykorzystaj istniejące Application.

Powiązane interfejsy

allow_overdraft jest domyślnie wyłączone i autoryzowane indywidualnie przez administratora; nie można go samodzielnie włączyć za pomocą parametrów żądania podczas tworzenia Application.