mod_rest/openapi.yaml

3.0.1
mod_rest API
0.2.1
MIT
Send stanzas and receive responses. Webhooks work the same way.
generic
/rest/{kind}/{type}/{to}
Even more RESTful mapping with certain components in the path.
generic
/rest/ping/{to}
query
Ping a local or remote server or other entity
/rest/version/{to}
query
Ask what software version is used.
Version query response
/rest/disco/{to}
query
Query a remote entity for supported features
/rest/items/{to}
query
Query an entity for related services, chat rooms or other items
object
Hello
chat
message
alice@example.com
active
boolean
Version query response
object
iq
string
result
true
Which kind of stanza
string
message
presence
iq
Stanza type
string
chat
normal
headline
groupchat
get
set
result
available
unavailable
subscribe
subscribed
unsubscribe
unsubscribed
recipient
alice@example.com
string
the sender
bob@localhost.example
string
Reasonably unique id. mod_rest generates one if left out.
string
Language code
en
string
Human-readable chat message
Hello, World!
string
Subject of message or group chat
Talking about stuff
string
Message thread identifier
string
indicator of availability, ie away or not
string
away
chat
dnd
xa
Textual status message.
string
Presence priority
string
Chat state notifications, e.g. "is typing..."
string
active
inactive
gone
composing
paused
composing
string
Nickname of the sender
string
Timestamp of when a stanza was delayed, in ISO 8601 / XEP-0082
format.
string
ID of message being replaced (e.g. for corrections)
For joining Multi-User-Chats
boolean
true
HTML version of 'body'
<body><p>Hello!</p></body>
string
A ping.
boolean
true
ping
urn:xmpp:ping
object
Software version query
string
My Software
string
1.0.0
string
Linux
name
version
query
jabber:iq:version
Discover supported features
A full response
object
List of URIs indicating supported features
array
string
List of abstract identities or types that describe the
entity
array
Prosody
im
server
object
string
string
string
string
object
A query with a node, or an empty response with a node
string
Either a query, or an empty response
boolean
List of references to other entities
List of items referenced
array
string
Address of item
string
string
Descriptive name
jid
object
string
A query with a node, or an empty reply list with a node
An items query or empty list
boolean
true
Ad-hoc commands.
object
string
object
string
string
info
warn
error
string
string
string
object
boolean
boolean
boolean
string
string
Call a command by 'node' id, without arguments
URL of an attached media file.
https://media.example.net/thisfile.jpg
string
A piece of arbitrary JSON with a type field attached
object
datatype
data
object
urn:example:my-json#payload
string
Data form
object
Title of the form
TPS Report
string
array
Form field
object
Field value
string
array
string
Type of form field
string
Descriptive label for the field
string
Longer description, i.e. that would go in a tooltip
string
Whether the field must be included in the form
boolean
Internal name of the field
string
string
form
submit
cancel
result
string
Simplified data form carrying only values
object
string
array
string
Statistics
array
object
string
string
string
Description of something gone wrong. See the Stanza Errors section in RFC 6120.
object
General category of error
string
auth
cancel
continue
modify
wait
Specific error condition.
string
Legacy numeric error code. Similar to HTTP status codes.
integer
Description of error intended for human eyes.
string
Tokens from mod_http_oauth2.
Bearer
http
Use JID as username.
Basic
http
true
A subset of the JSON schema, only top level string fields.
Single XMPP stanza in XML format.
The stanza was sent and returned a response.
Single XMPP stanza in XML format.
<message><body>Hello</body></message>
A subset of the JSON schema, only top level string fields.
body=Hello
Plain text response used as message body.
Hello
string
The stanza was sent without problem, and without response,
so an empty reply.
to
path
true
kind
path
true
type
path
true
author	Kim Alvefur <zash@zash.se>
date	Thu, 04 Mar 2021 01:21:11 +0100
parents	89571a20196f
children	cdc530ec76d6