> For the complete documentation index, see [llms.txt](https://help.edgecontents.com/edgecontents/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.edgecontents.com/edgecontents/apis/status-de-players.md).

# Status de Players

Disponibilizar informações dos players cadastrados na plataforma, incluindo identificação, nome, status de conexão, último contato e informações do local ao qual o player pertence.

## Endpoints

* ### Lista de players

**URL:** \<seuprojeto>.edgecontents.com/ds/api/screenstatus

**Método:** GET

**Autenticação:** Basic Auth

**Parâmetros de Consulta:**

| Parâmetro  | Tipo | Obrigatório | Descrição                                     |
| ---------- | ---- | ----------- | --------------------------------------------- |
| page       | int  | Não         | Número da página. Padrão: `1`                 |
| page\_size | int  | Não         | Quantidade de itens por página. Padrão: `100` |

Exemplo de retorno:

```
{
    "data": [
        {
            "id": 1278,
            "name": "PLAYER_1",
            "status": "DESLIG",
            "last_seen": "2026-08-24T14:45:00.495237Z",
            "site": {
                "id": 408,
                "name": "LOCAL_01",
                "address": "Av. Paulista, 1636 - Cerqueira César",
                "lat": -23,5612594,
                "long": -46,6564803
            }
        },
        {
            "id": 1280,
            "name": "PLAYER_2",
            "status": "ATIVO",
            "last_seen": "2026-08-27T14:45:50.558575Z",
            "site": {
                "id": 408,
                "name": "LOCAL_01",
                "address": "Av. Paulista, 1636 - Cerqueira César",
                "lat": -23,5612594,
                "long": -46,6564803
            }
        },
        {
            "id": 2518,
            "name": "PLAYER_20",
            "status": "ATIVO",
            "last_seen": "2026-08-27T14:46:04.297329Z",
            "site": {
                "id": 408,
                "name": "LOCAL_02",
                "address": "R. Pirapitingui, 80 - Liberdade",
                "lat": -23,5630694,
                "long": -46,6379003
            }
        }
    ],
    "pagination": {
        "page": 1,
        "page_size": 100,
        "total": 3,
        "total_pages": 1
    }
}
```
