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"