Custom Task Verification API

Tips

This feature is currently available to selected users only.

Overview

Advertisers provide an API to verify if users have successfully converted to their product.

Task3 will use the user's Telegram ID to call the advertiser's API for verification. The API returns a string indicating the verification result.

Request Method

GET

Request Parameters

Parameter	Type	Required	Description
telegram_id	string	Yes	User's Telegram ID

Response

Returns a verification result string:

"true": Verification successful
"false": Verification failed

Examples

Successful Verification

curl --location 'https://app.task3.org/api/v1/common/verify/example/success' \
--header 'Content-Type: application/json' \
--data '{"telegram_id": "123456789"}'

Response:

"true"

Failed Verification

curl --location 'https://app.task3.org/api/v1/common/verify/example/fail' \
--header 'Content-Type: application/json' \
--data '{"telegram_id": "987654321"}'

Response:

"false"

API Development Guide

To verify if users have logged into your app:

Record user login information with their Telegram ID
Implement this API to return login status