Документация API

Добро пожаловать в официальную документацию PiarFlow API. Наш сервис предназначен для заработка на своей аудитории через ОП (Обязательную Подписку). Мы предоставляем высокопроизводительный интерфейс для интеграции заданий в ваши проекты.

Авторизация

Все запросы должны содержать заголовок Auth с вашим уникальным API ключом. Получить ключ можно в настройках вашего бота в Telegram.

Auth: YOUR_API_KEY

Получение задания

Основной эндпоинт для получения доступных заданий. API автоматически отслеживает выполнение и начисляет вознаграждение владельцу бота. Спонсоры закрепляются за пользователем. При повторном запросе возвращаются только невыполненные.

POST /get_task

Параметры (JSON)

Поле	Тип	Описание
chat_id	integer	Уникальный ID пользователя в Telegram

Примеры кода

Выберите подходящий язык программирования для быстрой интеграции:

cURL

Python

JavaScript

Node.js

# Простой запрос через curl
curl -X POST https://PiarFlow.ru/get_task      -H "Auth: YOUR_API_KEY"      -H "Content-Type: application/json"      -d '{"chat_id": 12345678}'

import requests

# URL вашего API
url = "https://PiarFlow.ru/get_task"

# Заголовки (Auth - ваш ключ из бота)
headers = {
    "Auth": "YOUR_API_KEY",
    "Content-Type": "application/json"
}

# Данные запроса (ID пользователя)
data = {"chat_id": 12345678}

try:
    response = requests.post(url, json=data, headers=headers)
    response.raise_for_status()
    print(response.json())
except Exception as e:
    print(f"Ошибка: {e}")

// Пример на чистом JS (Fetch API)
async function fetchTask() {
  const response = await fetch('https://PiarFlow.ru/get_task', {
    method: 'POST',
    headers: {
      'Auth': 'YOUR_API_KEY',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({ chat_id: 12345678 })
  });
  
  const data = await response.json();
  console.log(data);
}

fetchTask();

// Пример на Node.js с использованием axios
const axios = require('axios');

const getTask = async () => {
  try {
    const res = await axios.post('https://PiarFlow.ru/get_task', 
      { chat_id: 12345678 },
      { headers: { 'Auth': 'YOUR_API_KEY' } }
    );
    console.log(res.data);
  } catch (err) {
    console.error(err.message);
  }
};

getTask();

package main

import (
	"bytes"
	"encoding/json"
	"fmt"
	"io/ioutil"
	"net/http"
)

func main() {
	url := "https://PiarFlow.ru/get_task"
	payload := map[string]interface{}{"chat_id": 12345678}
	jsonData, _ := json.Marshal(payload)

	req, _ := http.NewRequest("POST", url, bytes.NewBuffer(jsonData))
	req.Header.Set("Auth", "YOUR_API_KEY")
	req.Header.Set("Content-Type", "application/json")

	client := &http.Client{}
	resp, err := client.Do(req)
	if err != nil {
		fmt.Println(err)
		return
	}
	defer resp.Body.Close()

	body, _ := ioutil.ReadAll(resp.Body)
	fmt.Println(string(body))
}

Пример успешного ответа

{
  "tasks": ["https://RobuxRef.bybsa.gay/visit?user_id=12345678"],
  "completed": false,
  "skip": false
}

Коды ошибок

Код	Описание
`401`	Неверный или отсутствующий API ключ
`422`	Ошибка валидации (неверный формат chat_id)
`500`	Внутренняя ошибка сервера