diff --git a/api/client-server/v1/application_service.yaml b/api/client-server/v1/application_service.yaml index 22b4dfc5..a7400bd4 100644 --- a/api/client-server/v1/application_service.yaml +++ b/api/client-server/v1/application_service.yaml @@ -87,7 +87,7 @@ paths: the existence of a given room alias. The homeserver will only query room aliases inside the application service's ``aliases`` namespace. The homeserver will send this request when it receives a request to join a - room alias within the application services's namespace. + room alias within the application service's namespace. parameters: - in: path name: roomAlias @@ -101,7 +101,7 @@ paths: The application service indicates that this room alias exists. The application service MUST have created a room and associated it with the queried room alias using the client-server API. Additional - information about the room such as its' name and topic can be set + information about the room such as its name and topic can be set before responding. examples: application/json: |- diff --git a/specification/3-application_service_api.rst b/specification/3-application_service_api.rst index c4bedf3f..decb6f81 100644 --- a/specification/3-application_service_api.rst +++ b/specification/3-application_service_api.rst @@ -12,10 +12,10 @@ irrespective of the underlying homeserver implementation. Add in Client-Server services? Overview of bots? Seems weird to be in the spec given it is VERY implementation specific. -Passive Application Services ----------------------------- -"Passive" application services can only observe events from a given home server, -and inject events into a room they are participating in. +Application Services +-------------------- +Application services are passive and can only observe events from a given +homeserver. They can inject events into rooms they are participating in. They cannot prevent events from being sent, nor can they modify the content of the event being sent. In order to observe events from a homeserver, the homeserver needs to be configured to pass certain types of traffic to the @@ -139,33 +139,6 @@ this request (e.g. to join a room alias). room alias mappings. -Pushing -+++++++ -This API is called by the HS when the HS wants to push an event (or batch of -events) to the AS. - -Inputs: - - HS Credentials - - Event(s) to give to the AS - - HS-generated transaction ID -Output: - - None. - - -Ordering notes: - - - -:: - - PUT /transactions/$transaction_id?access_token=$hs_token - - Request format - { - events: [ - ... - ] - } - HTTP APIs +++++++++ @@ -177,7 +150,7 @@ application services MUST implement these APIs. These APIs are defined below. Client-Server v2 API Extensions ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -Passive application services can utilise a more powerful version of the +Application services can utilise a more powerful version of the client-server API by identifying itself as an application service to the home server.