EVerest API definition for the API entrypoint interface 1.0.0

API for EVerest API clients discovering the EVerest API capabilities.

  • #EVerest
  • #Auth

Servers

  • mqtt://localhost:1883/everest_api/mqttdefault

    default local MQTT

Operations

  • REQUEST discover

    Allow API clients to discover the available capabilities of the API. Reply will not be monolithic but come in as many messages as there are modules.

    Operation IDsend_request_discover

    Available only on servers:

    Accepts the following message:

    Discover APIsend_request_discover
    Message IDsend_request_discover
    object

    Examples

    REPLY INFORMATION

    REPLY CHANNEL INFORMATION

    Reply will be directed to the address specified at this location: $message.header#/replyTo

    REPLY address information

    REPLY will be sent to the address provided in:$message.header#/replyTo
  • RECEIVE

    Operation IDreceive_reply_discover

    Available only on servers:

    Accepts the following message:

    Reply to request to discover the APIreceive_reply_discover

    Reply to request to discover the API.

    Message IDreceive_reply_discover
    object

    Type for API discovery results

    Examples

  • REQUEST query-modules/{api_type}

    Allow API clients to discover specific types of APIs. Reply will not be monolithic but come in as many messages as there a matching modules.

    Operation IDsend_request_query_module

    Available only on servers:

    object
    api_type
    required
    string

    The type of API to query

    Accepts the following message:

    Query API modulessend_request_query_module
    Message IDsend_request_query_module
    object

    Examples

    REPLY INFORMATION

    REPLY CHANNEL INFORMATION

    Reply will be directed to the address specified at this location: $message.header#/replyTo

    REPLY address information

    REPLY will be sent to the address provided in:$message.header#/replyTo
  • RECEIVE

    Operation IDreceive_reply_query_module

    Available only on servers:

    Accepts the following message:

    Reply to request to query modulereceive_reply_query_module

    Reply to request to query module.

    Message IDreceive_reply_query_module
    object

    Type for API discovery results

    Examples

  • SEND ready_beacon

    Operation IDsend_ready_beacon

    Available only on servers:

    Accepts the following message:

    Send ready beaconsend_ready_beacon

    A beacon to indicate the API is ready to be queried

    Message IDsend_ready_beacon
    object

    a beacon to indicate the API is ready to be queried

    Examples

Messages

  • #1Discover APIsend_request_discover
    Message IDsend_request_discover
    object
  • #2Reply to request to discover the APIreceive_reply_discover

    Reply to request to discover the API.

    Message IDreceive_reply_discover
    object

    Type for API discovery results

  • #3Query API modulessend_request_query_module
    Message IDsend_request_query_module
    object
  • #4Reply to request to query modulereceive_reply_query_module

    Reply to request to query module.

    Message IDreceive_reply_query_module
    object

    Type for API discovery results

  • #5Send ready beaconsend_ready_beacon

    A beacon to indicate the API is ready to be queried

    Message IDsend_ready_beacon
    object

    a beacon to indicate the API is ready to be queried

Schemas

  • object

    Type for API discovery results

  • object

    Parameters for a single API

  • object

    Parameters of the communication monitoring between EVerest and client

  • object

    a beacon to indicate the API is ready to be queried