API Introduction

Official documentation for the persiandevs.ir API.

Authentication

Authentication is required for messing with bot api's and maybe more endpoints in the future. This is done with an Authorization HTTP Header.

Header	Content
Authorization	KXlKVSBJukpuH5ymv2so

You can generate an API key from your Bot Dashboard at any time.

Install the library

The best way to interact with our API is to use one of our official libraries:

Node

# Install via NPM
npm install --save persiandevs

Make your first request

To make your first request, send an authenticated request to the stats endpoint. This will update your bot servercount, which is nice.

Change Your Bot Server Count On The Site.

POST https://persiandevs.ir/api/auth/stats/:id

Request Body

Name	Type	Description
server_count*	number	the bot sevrer count

200: OK No Errors! GL Coding!

{
    success: "true", 
    users: []
}

401: Unauthorized Incorrect Auth Key Provided

429: Too Many Requests You Are Ratelimited

404: Not Found Bot Was Not Found!

400: Bad Request Create A Auth Key For Your Bot First

example:

Node

const persiandevs = require('persiandevs');

persiandevs.postStats("Your_Bot_ID", "Your_Auth_Key", "ServerCount")