Criar ordens de trabalho
Cria uma ou várias ordens de trabalho. O corpo é um array JSON, mesmo para um único registo.
A criação é idempotente por nome: os espaços nas extremidades dos nomes são removidos e os duplicados são eliminados, uma ordem de trabalho que já existe é devolvida tal como está, e uma que foi eliminada é restaurada em vez de duplicada.
Corpo do pedido
application/json
Definições de TypeScript
Utilize o tipo request body em TypeScript.
Corpo da resposta
application/json
application/json
curl -X POST "https://example.com/v1/simple-work-orders" \ -H "Content-Type: application/json" \ -d '[ { "name": "WO-2024-001" } ]'[ { "id": "36f7b519-d93e-4ec8-8245-7f4b8c123456", "company": { "id": 1, "name": "Company 1" }, "name": "WO-2024-001", "createdAt": "2024-01-01T00:00:00.000Z", "updatedAt": "2024-01-01T00:00:00.000Z" }]Ler dados de um sinal GET
Devolve os pontos agregados de um sinal de sensor em bruto. As amostras são agrupadas em intervalos antes de serem devolvidas. A largura de cada intervalo é `agg_period` x `agg_unit` (`agg_period=15`, `agg_unit=m` é um intervalo de 15 minutos) e `agg_function` define como são reduzidas as amostras dentro de um intervalo. Por predefinição, os pontos são devolvidos como uma lista `data` de objetos `{timestamp, value}`. Passe `transpose=true` para receber, em vez disso, dois arrays do mesmo comprimento, `timestamps` e `values`, em que `values[i]` corresponde a `timestamps[i]`. Contém os mesmos pontos numa resposta mais pequena. Aplicam-se dois limites, e ambos rejeitam o pedido em vez de truncar a resposta: a janela entre `start_time` e `end_time` não pode exceder **7 dias**, e uma consulta não pode produzir mais de **12 000 pontos**. Os valores predefinidos (`agg_unit=s`, `agg_period=1`) atingem o limite de pontos em menos de três horas e meia, por isso a maioria das chamadas define-os explicitamente.
Pesquisar ordens de trabalho POST
Pesquisa ordens de trabalho, ou percorre-as página a página com `{}`. Os resultados são ordenados por nome. `simpleWorkOrders` aceita `include` / `exclude` por ID. `names.search` é um padrão `LIKE` de SQL: use `%` como caráter universal, por exemplo `WO-2024%`.