Community Guide
Product Guide
Product Guide
  • Getting Started
    • đź‘‹Welcome to Intract
      • Why Intract?
    • đź‘·Set up your Community Hub
    • 🏡Community Hub Overview
  • Community Hub Guides
    • 🎯Quests
      • What are Quests?
      • Launching your Quests
        • Setting up Tasks
          • Understanding Task Features
          • How to implement On-Chain Tasks
          • How to Implement Proof of Humanity Tasks
        • Setting up Rewards
          • Submitting Tokens for Automatic Distribution
          • Adding Custom Token as Reward
          • Volume Based XPs
      • Managing Your Quests
        • Campaign Analytics
          • Loyalty Quest Analytics
        • Approving PoW Tasks
    • 🏆Leaderboard
    • đź’•Loyalty Program
      • Setting up Tasks
    • đź“…Events
      • Creating Events
    • 🎊Reward Store
      • Reward Store - Analytics
    • ⚙️Community Settings
    • 🤖Integrations
      • Discord
      • Telegram
    • 🤳KOLs Marketplace
  • Tools Guides
    • đź“–Your Contracts
      • NFT Rewards Contracts
      • Imported Tokens
      • Imported Contracts
    • ⛓️Integrate APIs
      • 🧑‍💻For Devs
    • đź”§API Tokens
    • 🧙‍♂️Dave: No Code Task Verification
      • Understanding and Creating Actions
      • Understanding and Creating Queries
  • Resources
    • đź’ĽCase Studies
    • 🦚Best Practices
    • 🎨Brand Kit
    • 📞Contact Us
Powered by GitBook
On this page
  • Create your OWN API based template
  • Getting started with API:
  1. Tools Guides
  2. Integrate APIs

For Devs

Create your OWN API based template

Intract's team offers enterprises the ability to create, test, and use their own customised API templates.


Getting started with API:

This section is intended for technical individuals.

Summary:

To create a custom API verification task, Intract requires an API developed according by our standards. When a quester interacts with this task, Intract will call the API with the required parameters and check if the task is verified.

This API will first be verified by Intract’s development team to check if all the standards are met

Keys Supported:

When we connect with your projects API for verification we will send some keys in payload body. We support the following keys for verification:

  1. Address

    User’s wallet address. 🚨 We support EVM compatible addresses and NON EVM addresses (Solana, Keplr, Ton and Starknet).

  2. Twitter ID

    User account ID of user’s Twitter account.

  3. TwitterHandle User's Twitter account handle.

  4. Discord ID User account ID of user’s Discord account.

  5. Discord

    Discord user name of user’s discord account.

  6. Telegram

    User ID of user’s telegram account.

  7. Email

    User’s email address.

You can also add constants not already mentioned above

API Signature

  • The API can be a POST or GET request.

  • URL format:

    https://<domain>/<serverpath>

    âś…NOTE: We only support https requests.

  • Payload

    The API should support payload with this format.

    {
    	"address": "user's evm address in lowercase",
    	"twitter": "twitter account ID",
    	"discord": "Discord username",
    	"telegram": "Telegram user ID",
    	"email":    "email address"
    }

    âś…NOTE: We will only include keys in the payload that are defined in the task template. For example, if the task template only mentions "address" as input, then only the "address" key will be present in the payload.

    When the task is recurring in nature two additional keys will be sent along with the above mentioned details. The following keys will be sent: startTimestamp and endTimestamp which are the start and end brackets of when the task is being verified.

    Example payload in this case:

    {
    	"address": "user's evm address in lowercase",
    	"startTimestamp":"2024-03-20T00:00:00.000Z",
    	"endTimestamp":"2024-03-20T23:59:59.000Z"
    }
  • Headers

    We will send security headers if mentioned.

Response Structure

We require the API response structure in a defined format. Failure to return data in this format will result in automatic rejection of the API approval.

Format:

{
    "error": {
        "code": 0,
        "message": "error message"
     },
     "data": { // required, whether success or error
         "result": <true | false> // bool, the user has done the task.
     }
}

Status Code:

The API should always return status code 200.

Performance Requirements

Intract’s campaigns receive a lot of scale. We require that APIs fulfils all performance requirements

These are some of the performance requirements needed for us to verify your API for usage.

  • Uptime: The API should meet 99.5% uptime SLA.

  • Throughput: The API should be able to handle a minimum of 50 req/sec.

  • Response Time: The API should have an average response time on less than 3 seconds. The max response time allowed is 5 seconds. We timeout the verification calls after 5 seconds.

  • Error Rate: The average error rate in an hour should be less than 0.5 percent.

    If in runtime the error rate increases more than the mentioned limit we disable the verification task all together.

âś… All these performance requirements will be tested by load testing before approval.

PreviousIntegrate APIsNextAPI Tokens

Last updated 6 months ago

Note: Once the API is created please visit to integrate.

⛓️
🧑‍💻
here