Skip to main content
„Wniosek (Application)” oznacza relację subskrypcji bieżącego konta dla określonej usługi — należy najpierw złożyć wniosek, aby następnie utworzyć dla tego wniosku poświadczenia API i wywoływać interfejsy biznesowe. Przy pierwszym złożeniu wniosku o daną usługę Application otrzyma aktualnie 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 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:
  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ż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:
Token konta (Account Token) to „klucz na poziomie konta”, za pomocą którego deweloper zarządza przez API zasobami własnego konta. Sposoby uzyskania:
  1. 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-.
  2. 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)

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 za pomocą Pobierania 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 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_amount usł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 wniosku paid=false, po wywołaniu Utwórz zlecenie doładowania na platformie 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 w płatności itd. Gdy usługa jest wyłączona, interfejs biznesowy zwróci 403.
  • Nie twórz bezgranicznie równolegle: najpierw pobierz docelowe service_id z paginowanej listy usług, a następnie składaj wnioski pojedynczo zgodnie z potrzebami biznesowymi; w przypadku duplication użyj istniejącego Application.

Powiązane interfejsy