Przejdź do treści

Pobierz wersje CloudPrint Agent ​

Pobierz bez uwierzytelniania aktualne instalatory CloudPrint Agent i ich sumy kontrolne.

GET/agent-download-api/v1/releasesWersja API: v1operationId: listPublicAgentReleasesOtwórz w Markdown

Działanie metody ​

Pobierz bez uwierzytelniania aktualne instalatory CloudPrint Agent i ich sumy kontrolne.

Uwierzytelnianie ​

Ta metoda nie wymaga tokenu Bearer.

Żądanie ​

Podstawowy adres API: https://public-api.cloudprint.me/agent-download-api/v1/releases

Parametry ​

NazwaPołożenieTypWymaganeOpisOgraniczenia
X-Request-IdheaderstringnieOpcjonalny identyfikator do śledzenia żądania; CloudPrint zwróci bezpieczną wartość w nagłówku odpowiedzi.maxLength: 128; example: "order-100045-attempt-1"

Treść żądania ​

Metoda nie ma treści żądania.

Przykładowe żądania ​

cURL ​

bash
curl -sS https://public-api.cloudprint.me/agent-download-api/v1/releases

Odpowiedź ​

Status HTTP: 200 — Żądanie zostało wykonane.

Pola odpowiedzi ​

NazwaTypWymaganeOpisOgraniczenia
availablebooleantakCzy opublikowany instalator jest dostępny dla wybranej platformy.—
channelstring | nulltakKanał wydania, do którego należy ta wersja Agent.—
releasesarraytakOpublikowane instalatory Agent pogrupowane według obsługiwanych platform.—
unavailable_reasonstring | nullniePowód braku opublikowanego instalatora dla tej platformy.—

Przykładowa odpowiedź ​

json
{
  "available": true,
  "channel": "string",
  "releases": [
    {
      "version": "string",
      "channel": "string",
      "published_at": "2026-08-06T12:00:00Z",
      "installers": [
        {
          "filename": "string",
          "platform": "macos",
          "architecture": "string",
          "format": "string",
          "size_bytes": 1,
          "sha256": "0000000000000000000000000000000000000000000000000000000000000000",
          "download_url": "/resource"
        }
      ]
    }
  ]
}

Błędy ​

Status HTTPOpis
429Przekroczono limit żądań; zastosuj Retry-After.
500Wewnętrzny błąd CloudPrint.
503Usługa jest tymczasowo niedostępna.

Powiązana dokumentacja ​

Przewodniki dotyczące integracji CloudPrint, podłączania lokalnego agenta i obsługi procesów drukowania.