واجهة API للمطورين

import requests
import time

TOKEN = "your_token_here"
BASE_URL = "http://api.fastpva.com/pvapublic"

def get_balance():
    resp = requests.get(f"{BASE_URL}/v4/balance", params={"token": TOKEN})
    return resp.json()

def buy_number(pid: int, channel_id: int, locale: str):
    # pid: pid returned by /v4/projects, for example 102103
    # channelId: channelId returned by /v4/project/channels, for example 2
    # locale: country code, for example SN / AO
    # token: Dashboard API Key
    resp = requests.get(
        f"{BASE_URL}/v4/getNumber",
        params={"pid": pid, "channelId": channel_id, "locale": locale, "token": TOKEN}
    )
    return resp.json()

def wait_for_sms(order_ids: list[str], timeout: int = 120):
    # Request uses one string joined by _, response keys stay as individual order IDs.
    orders_id = "_".join(order_ids)
    received = {}
    for _ in range(timeout // 5):
        resp = requests.get(
            f"{BASE_URL}/sms/codes",
            params={"orderId": orders_id, "token": TOKEN}
        ).json()
        data = resp.get("data", {})
        orders = data.get("orders", {})
        for order_id in order_ids:
            order = orders.get(order_id)
            if order and (order.get("code") or order.get("content")):
                received[order_id] = order.get("code") or order.get("content")
        if len(received) == len(order_ids):
            return received
        time.sleep(5)
    return received