Custom Off-chain API on TON

Overview

For off-chain tasks integration, partners need to implement two APIs following our standard format. You can customize the parameters based on your needs while maintaining the specified response format.

You can provide us with any link for users to complete the related task.

2 Verify Task API

Return the isVerified status of the user's current task based on the user's ton address.The API should handle both bounceable (EQ...) and non-bounceable (UQ...) ton address formats.

Method: GET

URL: baseUrl + /verify

Parameters

You can pass in either one of the following 2 parameters(depends on whether this application is onchain):

Parameters
Type
Is required
Description
E.g

tonAddress

string

required

User’s ton address

EQBaR9uc0lL6meZi8ssCAqIg4B97EMXaj9-beRqiJe_GPAop

telegram_id

integer

required

User's telegram id

7049598999

e.g:

  1. baseUrl/verify?type=task1&tonAddress=EQBaR9uc0lL6meZi8ssCAqIg4B97EMXaj9-beRqiJe_GPAopbaseUrl/verify?type=task2&telegram_id=7049598999

Responses

Success:

{"code":200,"status":"success","message":"msg","isVerified": true}

​Error:

{"code":400,"status":"error","message":"error msg","isVerified": false}

Implementation Notes

  • Partners can define custom parameters or paths to handle different tasks

  • Internal verification logic is implemented by partners

  • Must follow the specified response format

  • Response format details to be documented (please provide the expected response format)

Last updated