Dies ist eine alte Version des Dokuments!
C) Clowder Service
Der Discovery-Service verwaltet eine Liste aller Kitten-Bots.
Wenn ein Bot bereit zum Spielen ist, registriert er sich beim Clowder Service. Dieser verwaltet eine Collection aller Bots.
Aktionen
Register
Registriert einen Bot als spielbereit. Falls bereits ein Bot mit dem gleichen Namen existiert, wird der Eintrag aktualisiert.
Request
- action: 'REGISTER'
- ip: IP-Adresse des Bots
- name: Name des Bots
Response
- HTTP-Status: 201
- UUID: UUID unter der ein Bot registriert ist.
- Port: Eine zufällige Portnummer. Unter dieser Portnummer muss der Bot einen Socket öffnen und auf Nachrichten warten.
Heartbeat
Ein Bot bestätigt, dass er immer noch aktiv ist. Der Clowder-Service aktualisiert den Zeitstempel des letzten Herzschlags für diesen Bot.
Request
- action: 'HEARTBEAT'
- UUID: UUID unter der ein Bot registriert ist.
Response
- HTTP-Status: 200
Unregister
Ein Bot meldet sich aktiv ab. Der Clowder-Service entfernt den Bot aus der Collection der spielbereiten Bots.
Request
- action: 'UNREGISTER'
- UUID: UUID unter der ein Bot registriert ist.
Response
- HTTP-Status: 200
Exil
Der Arena-Service kann einen Bot ins Exil schicken. In diesem Fall darf sich dieser Bot während 5 Minuten nicht neu registrieren. Diese Aktion darf nur vom Arena-Service aufgerufen werden. Überlegen Sie sich, wie Sie einen Missbrauch verhindern können.
Request
- action: 'EXIL'
- UUID: UUID unter der ein Bot registriert ist.
Response
- HTTP-Status: 200