Przejdź do głównej treści

Wprowadzenie

QR Art to usługa AI do generowania artystycznych kodów QR oferowana przez Ace Data Cloud. Dzięki zunifikowanemu API Ace Data Cloud możesz szybko wywołać QR Art za pomocą cURL, realizując funkcje takie jak kody QR z linkiem, kody QR z tekstem, predefiniowane style oraz parametry niestandardowe.

Wymagania wstępne

  • Posiadanie konta w Ace Data Cloud oraz uzyskanie API Token
  • Środowisko terminalowe z zainstalowanym cURL

Podstawowe użycie

Główny endpoint API QR Art to:
POST https://api.acedata.cloud/qrart/generate
Pełny przykład polecenia cURL:
curl -X POST https://api.acedata.cloud/qrart/generate \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"type": "link", "content": "https://platform.acedata.cloud", "prompt": "sunset ocean waves", "preset": "neon-mech"}'
Proszę zastąpić YOUR_API_TOKEN rzeczywistym tokenem uzyskanym na platformie Ace Data Cloud.

Przykład odpowiedzi

Po pomyślnym wywołaniu zwracane są dane w formacie JSON, na przykład:
{
  "status": "success",
  "data": {
    ...
  }
}

Przetwarzanie odpowiedzi za pomocą jq

Zalecane jest użycie narzędzia jq do formatowania wyjścia:
curl -s -X POST https://api.acedata.cloud/qrart/generate \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"type": "link", "content": "https://platform.acedata.cloud", "prompt": "sunset ocean waves", "preset": "neon-mech"}' | jq .

Obsługa błędów

Typowe kody błędów:
Kod statusuOpis
401Błąd uwierzytelniania, sprawdź API Token
403Niewystarczające środki lub brak dostępu
429Przekroczono limit częstotliwości żądań
500Wewnętrzny błąd serwera

Kolejne kroki