From c93d84c7d2ec6d79786f6c12efe790c7645fbf4c Mon Sep 17 00:00:00 2001 From: Johannes Marbach Date: Mon, 14 Oct 2024 13:22:58 +0200 Subject: [PATCH 1/3] Clarify that pusher URLs have a fixed path Fixes: #809 Signed-off-by: Johannes Marbach --- data/api/push-gateway/push_notifier.yaml | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/data/api/push-gateway/push_notifier.yaml b/data/api/push-gateway/push_notifier.yaml index e23d33b0b..4fd0ba4d5 100644 --- a/data/api/push-gateway/push_notifier.yaml +++ b/data/api/push-gateway/push_notifier.yaml @@ -35,9 +35,9 @@ paths: updating counts of unread notifications should be idempotent and therefore do not require duplicate suppression. - Notifications are sent to the URL configured when the pusher is created. - This means that the HTTP path may be different depending on the push - gateway. + Clients interested in receiving notifications via this endpoint MUST + configure its concrete URL when creating the associated pusher via + [`/_matrix/client/v3/pushers/set`](/client-server-api/#post_matrixclientv3pushersset). operationId: notify requestBody: content: From bc5531f8465478ff4bc503d254f0c54ab5b85466 Mon Sep 17 00:00:00 2001 From: Johannes Marbach Date: Mon, 14 Oct 2024 13:27:13 +0200 Subject: [PATCH 2/3] Add changelog --- changelogs/push_gateway/newsfragments/1974.clarification | 1 + 1 file changed, 1 insertion(+) create mode 100644 changelogs/push_gateway/newsfragments/1974.clarification diff --git a/changelogs/push_gateway/newsfragments/1974.clarification b/changelogs/push_gateway/newsfragments/1974.clarification new file mode 100644 index 000000000..46c086a9f --- /dev/null +++ b/changelogs/push_gateway/newsfragments/1974.clarification @@ -0,0 +1 @@ +The path of HTTP pusher URLs is fixed to `/_matrix/push/v1/notify`. From 5d2022457500fba814207798e2ad740c31489e8a Mon Sep 17 00:00:00 2001 From: Andrew Morgan <1342360+anoadragon453@users.noreply.github.com> Date: Thu, 7 Nov 2024 14:55:17 +0000 Subject: [PATCH 3/3] concrete -> full --- data/api/push-gateway/push_notifier.yaml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/data/api/push-gateway/push_notifier.yaml b/data/api/push-gateway/push_notifier.yaml index 4fd0ba4d5..8ff8d3e7e 100644 --- a/data/api/push-gateway/push_notifier.yaml +++ b/data/api/push-gateway/push_notifier.yaml @@ -36,7 +36,7 @@ paths: therefore do not require duplicate suppression. Clients interested in receiving notifications via this endpoint MUST - configure its concrete URL when creating the associated pusher via + configure its full URI when creating the associated pusher via [`/_matrix/client/v3/pushers/set`](/client-server-api/#post_matrixclientv3pushersset). operationId: notify requestBody: