!!!Matrix

Das Matrix-Protokoll ist eine Spezifikation für einen föderierten Messenger.

!!Client-API mit {{curl}} bedienen

Hier meine Notizen für die Nutzung über die Client-API mir {{curl}}

Mein Beispiel-Matrix-Account sei {{klaus}} mit dem Passwort {{strenggeheim}}. Der Matrix-Server sei {{matrix.example.com}}

Ein Anmeldung beim Matrix-Server mit User und Passwort ist mit folgendem Befehl möglich:

 curl -s -XPOST -d '{ "type":"m.login.password", "user": "klaus", "password": "strenggeheim" }' https://matrix.example.com/_matrix/client/r0/login | json_pp
 
Die Antwort ist etwa:

 {
   "access_token" : "syt_cGV0ZXI_DDeSeksiFtcKqPLujGRp_2nvNqO",
   "device_id" : "JXUUKXOGVO",
   "home_server" : "matrix.example.com",
   "user_id" : "@klaus:matrix.example.com"
 }

Für das Senden von Nachrichten benötigen wird das Access-Token aus der Login-Nachricht und die technische Raum Kennung, etwa {{!P2OJJIHlzoyasmmsfg:matrix.example.com}}

 curl -XPOST -d '{ "msgtype": "m.text", "body": "Test-Nachricht" }' \\
    "https://matrix.example.com/_matrix/client/r0/rooms/%21P2OJJIHlzoyasmmsfg:matrix.example.com/send/m.room.message?access_token=syt_cGV0ZXI_DDeSeksiFtcKqPLujGRp_2nvNqO"