apiTON
HomeExplorerBlog
HomeExplorerBlog
Contact
  1. v2.Watch
  • api:TON Documentation
  • v2.Nft
    • Username
      POST
    • Number
      POST
    • Domain
      POST
    • Gift
      POST
    • Item
      POST
    • Items
      POST
  • v2.Rate
    • Fiat rate
      POST
    • Crypto rate
      POST
    • Exchanges rate
      POST
    • Jetton prices
      POST
  • v2.Auth
    • Do
      POST
    • List
      POST
    • Import
      POST
    • Backup
      POST
    • Delete
      POST
    • New
      POST
  • v2.Wallet
    • Send TON
      POST
    • Send Jetton
      POST
    • Send Nft
      POST
  • v2.Address
    • Transactions
    • Details
    • Jettons
    • NFTs
    • Wallets
    • Collections
  • v2.NftContract
    • Mint Nft Collection
    • Mint NFT
  • v2.JettonContract
    • Mint
    • Burn
    • Change owner
    • Close Mint
  • v2.Watch
    • Create watch
      POST
    • List watches
      POST
    • Delete watch
      POST
    • Poll events
      POST
    • Test watch
      POST
  • Schemas
    • Schemas
      • Connect Error
      • google.protobuf.Any
      • ListValue
      • NullValue
      • Struct
      • FieldsEntry
      • google.protobuf.Timestamp
      • google.protobuf.Value
      • BlockID
      • BurnRequest
      • BurnResponse
      • ChangeAdminRequest
      • ChangeAdminResponse
      • CloseMintRequest
      • CloseMintResponse
      • DetailsAddress
      • DetailsRequest
      • DetailsResponse
      • DomainRequest
      • DomainResponse
      • ItemRequest
      • ItemResponse
      • Jetton
      • JettonDetails
      • JettonsRequest
      • JettonsResponse
      • Message
      • MintCollectionRequest
      • MintCollectionResponse
      • MintNftRequest
      • MintNftResponse
      • MintRequest
      • MintResponse
      • NftItem
      • NftsRequest
      • NftsResponse
      • NumberRequest
      • NumberResponse
      • RateCryptoRequest
      • RateCryptoResponse
      • ResultEntry
      • RateExchangesRequest
      • RateExchangesResponse
      • ResultEntry
      • RateFiatRequest
      • RateFiatResponse
      • ResultEntry
      • SendJettonRequest
      • SendJettonResponse
      • SendNftRequest
      • SendNftResponse
      • SendRequest
      • SendResponse
      • TeleAuction
      • TeleAuctionConfig
      • TeleAuctionLastBid
      • TeleSale
      • Transaction
      • TransactionsRequest
      • TransactionsResponse
      • UsernameRequest
      • UsernameResponse
      • Version
      • WalletAuth
      • WalletAuth4
      • WalletDetails
      • WalletNewRequest
      • WalletNewResponse
      • WalletsRequest
      • WalletsResponse
      • AddressCollection
      • AddressCollectionsRequest
      • AddressCollectionsResponse
      • AuthBackupRequest
      • AuthDeleteRequest
      • AuthDeleteResponse
      • AuthDoRequest
      • AuthImportRequest
      • AuthJwtResponse
      • AuthListRequest
      • AuthListResponse
      • AuthNewRequest
      • BlockID
      • BurnRequest
      • BurnResponse
      • ChangeAdminRequest
      • ChangeAdminResponse
      • CloseMintRequest
      • CloseMintResponse
      • DetailsAddress
      • DetailsRequest
      • DetailsResponse
      • DomainRequest
      • DomainResponse
      • GiftAttribute
      • GiftRequest
      • GiftResponse
      • ItemRequest
      • ItemResponse
      • Jetton
      • JettonDetails
      • JettonsRequest
      • JettonsResponse
      • Message
      • MintCollectionRequest
      • MintCollectionResponse
      • MintNftRequest
      • MintNftResponse
      • MintRequest
      • MintResponse
      • NftDomainSite
      • NftItem
      • NftItemsRequest
      • NftsRequest
      • NftsResponse
      • NumberRequest
      • NumberResponse
      • RateCryptoRequest
      • RateCryptoResponse
      • RateExchangesRequest
      • RateExchangesResponse
      • RateFiatRequest
      • RateFiatResponse
      • RateJettonPricesRequest
      • RateJettonPricesResponse
      • SendJettonRequest
      • SendJettonResponse
      • SendNftRequest
      • SendNftResponse
      • SendRequest
      • SendResponse
      • TeleAuction
      • TeleAuctionConfig
      • TeleAuctionLastBid
      • TeleSale
      • Transaction
      • TransactionsRequest
      • TransactionsResponse
      • UsernameRequest
      • UsernameResponse
      • Version
      • WalletAuth
      • WalletDetails
      • WalletInfo
      • WalletsRequest
      • WalletsResponse
    • WatchCreateRequest
    • WatchCreateResponse
    • WatchDeleteRequest
    • WatchDeleteResponse
    • WatchEvent
    • WatchLimits
    • WatchListRequest
    • WatchListResponse
    • WatchPollRequest
    • WatchPollResponse
    • WatchSubscription
    • WatchTestRequest
    • WatchTestResponse
    • WatchTx
    • WatchWebhook
  1. v2.Watch

Test watch

POST
/v2.Watch/Test
curl -X POST https://app.apiton.org/v2.Watch/Test \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer 123456789:aB3dE…' -d '{"id":"41"}'
# {"event":{"id":"124","watch_id":"41","type":"test",…,"delivery":"delivered"},
#  "delivered":true,"status":200,"watch":{…}}
Stores an event of type test and, when the watch has a webhook, sends it at once and answers
what your endpoint said (status, error). A delivered test makes a failing or paused
webhook active again
; a failed one changes nothing but last_error. It is outside the hourly
cap. One test per 10 seconds for a watch (resource_exhausted). Without a webhook the event is
simply in Poll, which is how to try Poll out.

Request

Body Params application/jsonRequired

Example
{
    "id": "string"
}

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://app.apiton.org/v2.Watch/Test' \
--header 'Content-Type: application/json' \
--data '{
    "id": "string"
}'

Responses

🟢200OK
application/json
Bodyapplication/json

Example
{
    "event": {
        "id": "string",
        "watch_id": "string",
        "address": "string",
        "kind": "string",
        "name": "string",
        "type": "string",
        "at": "2019-08-24T14:15:22.123Z",
        "status": "string",
        "owner": "string",
        "previous_owner": "string",
        "price": "string",
        "currency": "string",
        "bid": "string",
        "bidder": "string",
        "previous_bidder": "string",
        "auction_end": "2019-08-24T14:15:22.123Z",
        "tx": {
            "hash": "string",
            "lt": "string",
            "time": "2019-08-24T14:15:22.123Z",
            "success": true,
            "fee": "string",
            "direction": "string",
            "amount": "string",
            "symbol": "string",
            "from": "string",
            "to": "string",
            "operation": "string",
            "op_code": 0,
            "nft_op": "string",
            "out_messages": 0
        },
        "truncated": true,
        "delivery": "string"
    },
    "delivered": true,
    "status": 0,
    "error": "string",
    "watch": {
        "id": "string",
        "address": "string",
        "kind": "string",
        "name": "string",
        "status": "string",
        "min_amount": "string",
        "paused": true,
        "poll_interval_seconds": 0,
        "created_at": "2019-08-24T14:15:22.123Z",
        "last_polled_at": "2019-08-24T14:15:22.123Z",
        "webhook": {
            "url": "string",
            "state": "string",
            "last_error": "string",
            "pending": 0,
            "last_attempt_at": "2019-08-24T14:15:22.123Z",
            "last_success_at": "2019-08-24T14:15:22.123Z",
            "failing_since": "2019-08-24T14:15:22.123Z",
            "next_attempt_at": "2019-08-24T14:15:22.123Z"
        }
    }
}
🔴500Server Error
Previous
Poll events
Next
connect.error
Built with