瀏覽代碼

readme su pizzicore

boyska 2 年之前
父節點
當前提交
fabbc9f978
共有 1 個文件被更改,包括 23 次插入1 次删除
  1. 23 1
      pizzicore/README.md

+ 23 - 1
pizzicore/README.md

@@ -3,4 +3,26 @@ espone HTTP e WebSocket.
 
 Alcune API richiedono autenticazione.
 
-Il docker-compose incluso è solo per comodità di sviluppo, non è strettamente necessario.
+Il docker incluso è solo per comodità di sviluppo, non è strettamente necessario.
+
+## Concetti
+
+### Contatori multipli
+
+Il codice gestisce più di un contatore, per generalità, anche se non è chiaro se questa cosa ci servirà. I
+contatori partono da 0, quindi in genere useremo sempre 0.
+
+### Storage
+
+Il sistema ha un suo storage, in modo che al riavvio i contatori ripartano da dove erano.
+
+## HTTP API
+
+`GET /counter/0` ti dà il valore
+
+`POST /counter/0/increment` incrementa, ma richiede basic-auth
+
+## WebSocket API
+
+`/ws/counter/0` ti dà il valore e ti riaggiorna ogni volta che questo cambia. Ignora ogni messaggio in
+ingresso.