waku-rest-api/api-spec/openapi.yaml

73 lines
2.5 KiB
YAML

openapi: 3.0.3
info:
title: Waku V2 node REST API
version: 1.0.0
description:
contact:
name: VAC Team
url: https://forum.vac.dev/
servers:
- url: http://127.0.0.1:8645
description: Accessing your wakunode via API is possible normally via localhost on defaul port 8545.
tags:
- name: admin
description: Control of the connected peers.
- name: debug
description: Information about a Waku v2 node.
- name: health
description: Health check of a Waku v2 node.
- name: lightpush
description: Interface to request a message relay. See [19/WAKU2-LIGHTPUSH](https://rfc.vac.dev/spec/19/) RFC
- name: relay
description: Control of the relaying of messages. See [11/WAKU2-RELAY](https://rfc.vac.dev/spec/11/) RFC
- name: store
description: Retrieve the message history. #TODO See [13/WAKU2-STORE]() RFC
- name: legacy_store
description: Retrieve the message history. See [13/WAKU2-STORE](https://rfc.vac.dev/spec/13/) RFC
- name: filter
description: Control of the content filtering. See [12/WAKU2-FILTER](https://rfc.vac.dev/spec/12/) RFC
- name: filter_legacy
description: Obsolate Filter interface kept for compatibility reason. Will be removed in future.
paths:
/admin/v1/peers:
$ref: "./adminapi.yaml"
/admin/v1/filter/subscriptions:
$ref: "./adminapi_filter.yaml"
/debug/v1/info:
$ref: "./debugapi_info.yaml"
/debug/v1/version:
$ref: "./debugapi_version.yaml"
/health:
$ref: "./healthapi.yaml"
/lightpush/v1/message:
$ref: "./lightpushapi.yaml"
/relay/v1/messages/{pubsubTopic}:
$ref: "./relayapi_messages.yaml"
/relay/v1/subscriptions:
$ref: "./relayapi_subscriptions.yaml"
/relay/v1/auto/messages/{contentTopic}:
$ref: "./relayapi_auto_content_topic.yaml"
/relay/v1/auto/messages:
$ref: "./relayapi_auto_messages.yaml"
/relay/v1/auto/subscriptions:
$ref: "./relayapi_auto_subscriptions.yaml"
/store/v1/messages:
$ref: "./legacystoreapi.yaml"
/store/v3/messages:
$ref: "./storeapi.yaml"
/filter/v1/subscriptions:
$ref: "./filterapi_v1_subscriptions.yaml"
/filter/v1/messages/{contentTopic}:
$ref: "./filterapi_v1_messages.yaml"
/filter/v2/subscriptions/{requestId}:
$ref: "./filterapi_v2_subscription_ping.yaml"
/filter/v2/subscriptions:
$ref: "./filterapi_v2_subscriptions.yaml"
/filter/v2/subscriptions/all:
$ref: "./filterapi_v2_subscriptions_all.yaml"
/filter/v2/messages/{contentTopic}:
$ref: "./filterapi_v2_messages.yaml"
components:
schemas:
$ref: "./schemas/apitypes.yaml"