API FernieID
для разработчиков

const API_KEY: string = 'fid_твой_ключ'; // хранится на бэкенде, не в клиентском коде
interface LoginResponse {
  success: boolean;
  require2fa?: boolean;
  userId?: number;
  telegramLinked?: boolean;
}
document.getElementById('loginBtn')!.addEventListener('click', async () => {
  const username = (document.getElementById('loginUsername') as HTMLInputElement).value.trim();
  const password = (document.getElementById('loginPassword') as HTMLInputElement).value;
  if (!username || !password) return alert('Заполни логин и пароль');
  const res = await fetch('https://ferniex-id.vercel.app/api/auth/login', {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({ apiKey: API_KEY, username, password })
  });
  const data: LoginResponse = await res.json();
  if (data.require2fa) {
    showCodeInput(data.userId!);
  }
});

import requests
API_KEY = "fid_твой_ключ"
def login(username: str, password: str) -> dict:
    res = requests.post(
        "https://ferniex-id.vercel.app/api/auth/login",
        json={"apiKey": API_KEY, "username": username, "password": password},
    )
    data = res.json()
    # { "success": True, "require2fa": True, "userId": 42, "telegramLinked": True }
    if data.get("require2fa"):
        # дальше передай data["userId"] в verify_2fa()
        pass
    return data

interface VerifyResponse {
  success: boolean;
  userId?: number;
  username?: string;
  role?: string;
}
function showCodeInput(userId: number): void {
  document.getElementById('confirmCodeBtn')!.addEventListener('click', async () => {
    const code = (document.getElementById('twoFaCode') as HTMLInputElement).value.trim();
    if (code.length !== 6) return alert('Введи 6-значный код из Telegram');
    const res = await fetch('https://ferniex-id.vercel.app/api/auth/verify-2fa', {
      method: 'POST',
      headers: { 'Content-Type': 'application/json' },
      body: JSON.stringify({ apiKey: API_KEY, userId, code })
    });
    const data: VerifyResponse = await res.json();
    if (data.success) {
      // сохраняем сессию, открываем личный кабинет и т.д.
    }
  });
}

def verify_2fa(user_id: int, code: str) -> dict:
    res = requests.post(
        "https://ferniex-id.vercel.app/api/auth/verify-2fa",
        json={"apiKey": API_KEY, "userId": user_id, "code": code},
    )
    data = res.json()
    # { "success": True, "userId": 42, "username": "fernie", "role": "user" }
    return data

interface VerifyKeyResponse {
  success: boolean;
  userId?: number;
  name?: string;
  appName?: string;
  type?: string;
}
const data: VerifyKeyResponse = await fetch('https://ferniex-id.vercel.app/api/apikeys/verify', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({ key: 'fid_твой_ключ' })
}).then(r => r.json());

import requests
data = requests.post(
    "https://ferniex-id.vercel.app/api/apikeys/verify",
    json={"key": "fid_твой_ключ"},
).json()
# { "success": True, "userId": ..., "name": ..., "appName": ..., "type": ... }

interface BalanceResponse {
  success: boolean;
  username?: string;
  dc?: number;
  seeds?: number;
}
const data: BalanceResponse = await fetch('https://ferniex-id.vercel.app/api/balance/get', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    apiKey: 'fid_твой_ключ',
    username: 'fernie',
    fields: ['dc', 'seeds']
  })
}).then(r => r.json());

data = requests.post(
    "https://ferniex-id.vercel.app/api/balance/get",
    json={
        "apiKey": "fid_твой_ключ",
        "username": "fernie",
        "fields": ["dc", "seeds"],
    },
).json()
# { "success": True, "username": "fernie", "dc": 4200, "seeds": 15300 }

interface EditBalanceResponse {
  success: boolean;
  dc?: number;
  seeds?: number;
}
const data: EditBalanceResponse = await fetch('https://ferniex-id.vercel.app/api/edit/balance', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    apiKey: 'fid_твой_бот_ключ',
    username: 'fernie',
    currency: 'dc',
    amount: 500,
    action: 'add'
  })
}).then(r => r.json());

data = requests.post(
    "https://ferniex-id.vercel.app/api/edit/balance",
    json={
        "apiKey": "fid_твой_бот_ключ",
        "username": "fernie",
        "currency": "dc",
        "amount": 500,
        "action": "add",
    },
).json()

interface ChatResponse {
  choices: { message: { role: string; content: string } }[];
  usage: { total_tokens: number };
}
const data: ChatResponse = await fetch('https://ferniex-id.vercel.app/api/chat', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    apiKey: 'fid_твой_ключ',
    model: 'aurin-lite',
    messages: [{ role: 'user', content: 'Привет! Что нового в мире технологий?' }]
  })
}).then(r => r.json());

data = requests.post(
    "https://ferniex-id.vercel.app/api/chat",
    json={
        "apiKey": "fid_твой_ключ",
        "model": "aurin-lite",
        "messages": [{"role": "user", "content": "Привет! Что нового в мире технологий?"}],
    },
).json()
# { "choices": [{ "message": { "role", "content" } }], "usage": { "total_tokens" } }

interface UsageResponse {
  success: boolean;
  used: number;
  limit: number;
  has_plus: boolean;
  remaining: number;
}
const data: UsageResponse = await fetch(`https://ferniex-id.vercel.app/api/chat/usage/${userId}`)
  .then(r => r.json());

data = requests.get(
    f"https://ferniex-id.vercel.app/api/chat/usage/{user_id}"
).json()
# { "success": True, "used": 12400, "limit": 200000, "has_plus": False, "remaining": 187600 }

interface ChatResponse {
  choices: { message: { role: string; content: string } }[];
  usage: { total_tokens: number };
}
const data: ChatResponse = await fetch('https://ferniex-id.vercel.app/api/chat', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    apiKey: 'fid_твой_ключ',
    model: 'aurin-custom',
    messages: [
      { role: 'system', content: 'Тебя зовут Марта. Ты дружелюбный консультант книжного магазина, отвечаешь коротко и с лёгким юмором.' },
      { role: 'user', content: 'Посоветуй что почитать вечером' }
    ]
  })
}).then(r => r.json());

data = requests.post(
    "https://ferniex-id.vercel.app/api/chat",
    json={
        "apiKey": "fid_твой_ключ",
        "model": "aurin-custom",
        "messages": [
            {"role": "system", "content": "Тебя зовут Марта. Ты дружелюбный консультант книжного магазина, отвечаешь коротко и с лёгким юмором."},
            {"role": "user", "content": "Посоветуй что почитать вечером"},
        ],
    },
).json()
# { "choices": [{ "message": { "role": "assistant", "content": "..." } }], "usage": {...} }

interface SearchResult { title: string; url: string; snippet: string; }
interface SearchResponse { success: boolean; results: SearchResult[]; query: string; }
const data: SearchResponse = await fetch('https://ferniex-id.vercel.app/api/search?q=погода+в+москве')
  .then(r => r.json());

data = requests.get(
    "https://ferniex-id.vercel.app/api/search",
    params={"q": "погода в москве"},
).json()
# { "success": True, "results": [{ "title", "url", "snippet" }], "query" }

async function sendTelegramMessage(telegramId: string, text: string): Promise<void> {
  await fetch('https://ferniex-id.vercel.app/api/telegram/send-message', {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({ telegram_id: telegramId, text })
  });
}
sendTelegramMessage('7406372338', '✅ <b>Твоя заявка одобрена!</b>');

requests.post(
    "https://ferniex-id.vercel.app/api/telegram/send-message",
    json={
        "telegram_id": "7406372338",
        "text": "✅ <b>Твоя заявка одобрена!</b>",
    },
)