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 znajduje się w dokumencie Pobieranie listy dokumentów platformy AceDataCloud.
Pełny proces integracji
Nowi użytkownicy, od rejestracji do uruchomienia pierwszego interfejsu biznesowego, zazwyczaj przechodzą przez tych 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życie uzyskanego 32-znakowego Tokena do wywołania
https://api.acedata.cloud/<path>
Przegląd interfejsu
Opis uwierzytelniania (jak uzyskać token konta)
Nagłówek żądania:- Tworzenie jednym kliknięciem w konsoli (zalecane): zaloguj się do platformy AceDataCloud → konsoli Account Token → kliknij „Utwórz”, aby uzyskać token rozpoczynający się od
platform-v1-. - Tworzenie przez API: użyj istniejącego tokenu konta albo JWT sesji logowania w przeglądarce, aby wywołać
POST /api/v1/platform-tokens/; szczegóły znajdują się w Zarządzaniu tokenami konta platformy AceDataCloud.
⚠️ Token konta jest równie wrażliwy jak hasło; nie wolno umieszczać go w kodzie frontendowym ani publicznych repozytoriach. W przypadku wycieku natychmiast usuń go w konsoli i utwórz ponownie.
Treść żądania
Przykłady żądań
cURL
Python
Node.js
Przykład 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 wnioskować 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 aktualnym
free_amountusługi; wartość ta może wynosić 0, a ponowne utworzenie Application tego samego typu nie gwarantuje ponownego przyznania darmowego limitu. - To, czy wymagana jest płatność, sprawdza się w polu
paid: bezpośrednio po złożeniu wnioskupaid=false, po wywołaniu Utwórz zlecenie doładowania na platformie 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 w płatności itd. Gdy usługa jest wyłączona, interfejs biznesowy zwróci403.- Nie twórz bezgranicznie równolegle: najpierw pobierz docelowe
service_idz paginowanej listy usług, a następnie składaj wnioski pojedynczo zgodnie z potrzebami biznesowymi; w przypadkuduplicationużyj istniejącego Application.
Powiązane interfejsy
- Pobierz listę usług platformy AceDataCloud — najpierw wybierz usługę
- Pobierz listę wniosków o usługi platformy AceDataCloud — zobacz wszystkie złożone wnioski
- Pobierz szczegóły wniosku o usługę platformy AceDataCloud — zobacz pojedynczy wniosek
- Utwórz poświadczenia API platformy AceDataCloud — następny krok po pomyślnym złożeniu wniosku
- Utwórz zlecenie doładowania na platformie AceDataCloud — doładuj po wykorzystaniu darmowego limitu

