mod_rest/res/openapi.yaml

3.0.1
mod_rest API
0.3.2
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
Build as stanza and return it for inspection.
debug
/rest/ping/{to}
query
Ping a local or remote server or other entity
Test reachability of some address
/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
object
message
Which kind of stanza
string
message
string
chat
error
groupchat
headline
normal
object
Which kind of stanza
string
presence
string
available
unavailable
subscribe
subscribed
unsubscribe
unsubscribed
error
object
Which kind of stanza
string
iq
string
get
set
result
error
Test reachability of some XMPP address
object
iq
string
result
true
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
integer
127
-128
Chat state notifications, e.g. "is typing..."
string
http://jabber.org/protocol/chatstates
true
active
inactive
gone
composing
paused
composing
string
Nickname of the sender
nick
http://jabber.org/protocol/nick
string
date-time
Timestamp of when a stanza was delayed, in ISO 8601 / XEP-0082
format.
delay
urn:xmpp:delay
stamp
string
ID of message being replaced (e.g. for corrections)
replace
urn:xmpp:message-correct:0
id
For joining Multi-User-Chats
boolean
true
object
Invite to a group chat
jid
x
jabber:x:conference
string
Address of the group chat
xmpp-jid
true
string
Optional message by the inviter
true
string
Password for the group chat, if required
true
string
true
boolean
Whether the group chat continues a one-to-one chat
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
object
Reference a media file
x
jabber:x:oob
string
URL of the attached media file
https://media.example.net/thisfile.jpg
uri
Optional description
string
A piece of arbitrary JSON with a type field attached
object
payload
urn:xmpp:json-msg:0
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
query
http://jabber.org/protocol/stats
true
object
string
true
string
true
string
true
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
Single XMPP stanza in XML format.
A subset of the JSON schema, only top level string fields.
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	Tue, 25 May 2021 16:46:46 +0200
parents	cce0e1ec8a74
children	913fcb5efc77