API Documentation

Base URL: https://your-domain.com

Authentication

Dashboard → API Keys se apne user ke liye API key aur secret generate karein. Dono credentials aur request ke required headers ko headers mein hi bhejein; URL query mein credentials mat bhejein. Custom Endpoints section ka slug user ko uske saved accounts se map karta hai.

X-API-KEY: bw_xxxxxxxxxxxxxxxx
X-API-SECRET: xxxxxxxxxxxxxxxxxxxxxxxx
User-Agent: Kavach/1.0.0
X-REQUEST-TYPE: redefine-like

Send Likes

Custom Endpoint ka slug use karein: GET /api/{your-slug}?uid={UID}&region={IND|NX|AG}

region optional hai; default IND hai. Supported regions: IND, NX, AG. India accounts ke liye IND; India ke alawa Asian countries ke accounts/UIDs ke liye AG use karein.

Example:

curl -X GET "http://localhost:7004/api/bhuwan?uid=123456789&region=IND" \
  -H "X-API-KEY: <your_user_api_key>" \
  -H "X-API-SECRET: <your_user_api_secret>" \
  -H "User-Agent: Kavach/1.0.0" \
  -H "X-REQUEST-TYPE: redefine-like"

API key reset/regenerate karne par purani key revoke hoti hai; revoked keys dashboard par nahi dikhengi, par database mein retained rahengi.

Response:

{
  "status": 1,
  "message": "like successful",
  "player": { "UID": 123456789, "PlayerNickname": "Bhuwan", "region": "IND", "Likes": 5023 },
  "likes": { "before": 4998, "after": 5023, "added": 25 },
  "sent": { "total": 30, "success": 25, "time_sec": 2.14 }
}

Check Credits

GET /api/credits

Custom Endpoints

Dashboard → Custom Endpoints mein slug banayein. Valid format http://localhost:7004/api/{your-slug}?uid={UID}&region={IND|NX|AG} hai. Example: http://localhost:7004/api/bhuwan?uid=123456789&region=IND. Authentication upar diye gaye user API key aur secret headers se hoti hai.

Error Codes

401 — Unauthorized access (invalid/missing API credentials or required headers)
409 — Custom API key already exists
402 — Subscription expired / inactive
400 — Invalid UID/region/request
429 — Rate limit exceeded
500 — Server error

Plans & Pricing

Latest prices ke liye dashboard → Plans & Billing tab dekhein.