---
title: "Pobierz listę agentów druku"
description: "Pobierz agentów CloudPrint konta oraz sprawdź ich status, wersję i stan aktualizacji."
---
# Pobierz listę agentów druku
Pobierz agentów CloudPrint konta oraz sprawdź ich status, wersję i stan aktualizacji.
GET/api/v1/agentsWersja API: v1operationId:listAgentsOtwórz w Markdown
## Działanie metody
Pobierz agentów CloudPrint konta oraz sprawdź ich status, wersję i stan aktualizacji.
## Uwierzytelnianie
Przekaż krótkotrwały token w `Authorization: Bearer `.
**Wymagane uprawnienia:** `agents:read`
## Żądanie
**Podstawowy adres API:** `https://public-api.cloudprint.me/api/v1/agents`
### Parametry
| Nazwa | Położenie | Typ | Wymagane | Opis | Ograniczenia |
| --- | --- | --- | --- | --- | --- |
| `limit` | query | `integer` | nie | Pole kontraktu API; uwzględnij podany typ i ograniczenia. | min: 1; max: 100; default: `50` |
| `cursor` | query | `string \| null` | nie | Pole kontraktu API; uwzględnij podany typ i ograniczenia. | — |
### Treść żądania
Metoda nie ma treści żądania.
### Przykładowe żądania
#### cURL
```bash
curl -sS 'https://public-api.cloudprint.me/api/v1/agents?limit=50' \
-H "Authorization: Bearer $ACCESS_TOKEN"
```
## Odpowiedź
**Status HTTP:** `200` — Żądanie zostało wykonane.
### Pola odpowiedzi
| Nazwa | Typ | Wymagane | Opis | Ograniczenia |
| --- | --- | --- | --- | --- |
| `agents` | `array` | tak | Agenci zarejestrowani na bieżącym koncie CloudPrint. | — |
| `next_cursor` | `string \| null` | tak | Nieprzezroczysty kursor następnej strony; przekaż go bez zmian. | — |
### Przykładowa odpowiedź
```json
{
"agents": [
{
"agent_id": "11111111-1111-4111-8111-111111111111",
"name": "Warehouse PC agent",
"status": "online",
"agent_instance_id": null,
"hostname": null,
"version": null,
"update": {
"status": "available",
"current_version": "0.1.0",
"latest_version": "0.1.1",
"minimum_supported_version": "0.1.0",
"channel": "stable",
"required": false
},
"last_seen_at": null
}
],
"next_cursor": null
}
```
## Błędy
| Status HTTP | Opis |
| --- | --- |
| `401` | Brak uwierzytelnienia albo jest ono nieprawidłowe. |
| `403` | Brak uprawnień wymaganych do tej operacji. |
| `422` | Pola żądania nie przeszły walidacji. |
| `429` | Przekroczono limit żądań; zastosuj Retry-After. |
| `500` | Wewnętrzny błąd CloudPrint. |
## Wskazówki integracyjne
- Status agenta jest informacją operacyjną, a nie kluczem routingu drukarki.
- Sprawdź stan aktualizacji agenta przed diagnozowaniem drukarki lub dokumentu.
## Powiązana dokumentacja