!!!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"