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:- Uzyskanie tokenu konta → Zarządzanie tokenami konta platformy AceDataCloud
- Wybór usługi → Pobieranie listy usług platformy AceDataCloud
- Tworzenie wniosku (ten dokument) → uzyskanie początkowego limitu zgodnie z konfiguracją usługi
- Tworzenie poświadczeń API → Tworzenie poświadczeń API platformy AceDataCloud
- 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:- 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-. - 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)
Wniosek został już złożony (HTTP 400)
Usługa nie istnieje (HTTP 404)
Usługa wymaga weryfikacji (HTTP 403)
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_amountusł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łoszeniupaid=false, po wywołaniu utworzenia zlecenia doładowania platformy AceDataCloud i zakończeniu płatności zmienia się natrue. disabled=trueoznacza 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óci403.- Nie twórz bez ograniczeń równolegle: najpierw pobierz docelowe
service_idz listy usług stronicowanych, a następnie zgłaszaj je pojedynczo zgodnie z potrzebami biznesowymi; w przypadkuduplicationwykorzystaj istniejące Application.
Powiązane interfejsy
- Pobierz listę usług platformy AceDataCloud — najpierw wybierz usługę
- Pobierz listę zgłoszeń usług platformy AceDataCloud — zobacz wszystkie już zgłoszone
- Pobierz szczegóły zgłoszenia usługi platformy AceDataCloud — zobacz pojedyncze zgłoszenie
- Utwórz poświadczenie API platformy AceDataCloud — następny krok po pomyślnym zgłoszeniu
- Utwórz zlecenie doładowania platformy AceDataCloud — doładuj po wykorzystaniu darmowego limitu
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.
