Content Watcher Service API (1.0)

Download OpenAPI specification:Download

Content Watcher Service API

v1/scanner

Reset blockchain scan to a specific block number or offset from the current position

Request Body schema: application/json
required

blockNumber

blockNumber
number [ 0 .. 4294967296 ]

The block number to reset the scanner to

rewindOffset
number [ 0 .. 4294967296 ]

Number of blocks to rewind the scanner to (from blockNumber if supplied; else from latest block)

immediate
boolean

Whether to schedule the new scan immediately or wait for the next scheduled interval

Responses

Request samples

Content type
application/json
{
  • "blockNumber": 0,
  • "rewindOffset": 100,
  • "immediate": true
}

Get the current watch options for the blockchain content event scanner

Responses

Response samples

Content type
application/json
{
  • "schemaIds": [
    ],
  • "dsnpIds": [
    ]
}

Set watch options to filter the blockchain content scanner by schemas or MSA Ids

Request Body schema: application/json
required

watchOptions: Filter contents by schemaIds and/or msaIds

schemaIds
Array of numbers [ 0 .. 65536 ]

Specific schema ids to watch for

dsnpIds
Array of strings

Specific dsnpIds (msa_id) to watch for

Responses

Request samples

Content type
application/json
{
  • "schemaIds": [
    ],
  • "dsnpIds": [
    ]
}

Pause the blockchain scanner

Responses

Resume the blockchain content event scanner

query Parameters
immediate
boolean

Immediate: whether to resume scan immediately (true), or wait until next scheduled scan (false)

Responses

v1/search

v1/webhooks

Register a webhook to be called when new content is encountered on the chain

Request Body schema: application/json
required

Register a webhook to be called when a new content is encountered

url
required
string

Webhook URL

announcementTypes
required
Array of strings (AnnouncementTypeName)
Items Enum: "tombstone" "broadcast" "reply" "reaction" "profile" "update"

Responses

Request samples

Content type
application/json
{}

Clear all previously registered webhooks

Responses

Get the list of currently registered webhooks

Responses

Response samples

Content type
application/json
[]

health

Check the health status of the service

Responses

Check the live status of the service

Responses

Check the ready status of the service

Responses