دليل الربط الشامل لـ API الخدمات وبوت تيليجرام

⚡ اختبار الربط المباشر مع سيرفر الـ API

اختبار آمن ومباشر لإرسال واستقبال البيانات عبر بوابتك api.fakhama.shop:

⚙️ حالة السيرفر والدومين الفرعي

تم رفع ملف التوثيق والواجهة باسم index.html وضبط حماية بيانات السيرفر الخلفي بنجاح.

1. قاموس المصطلحات والمفاهيم (Glossary)

2. مسارات ونقاط اتصال الـ API الخاصة بالدومين

3. خريطة ربط حسابات المستخدمين حسب البريد الإلكتروني

يحتوي السيرفر على قاعدة بيانات تربط كل بريد إلكتروني بحساب التيليجرام الخاص به والمفتاح السري:

4. أكواد البرمجة للربط والتكامل

أ) كود استقبال Webhook برمجياً (Node.js Express):

require('dotenv').config();
const express = require('express');
const cors = require('cors');
const app = express();

app.use(cors({ origin: '*' }));
app.use(express.json());

// الروابط مشفرة ومحفوظة في process.env داخل السيرفر
app.post('/api/v1/telegram/webhook', (req, res) => {
    const update = req.body;
    if (update.message) {
        console.log(`رسالة جديدة من: ${update.message.chat.id}`);
    }
    res.sendStatus(200);
});

app.listen(3000, () => console.log('API Gateway active on port 3000'));

ب) كود ربط حساب بريدي جديد (Python Requests):

import requests

API_URL = "https://api.fakhama.shop/api/v1/user/bind-email"

payload = {
    "telegram_chat_id": 987654321,
    "user_email": "user@fakhama.shop"
}

headers = {
    "Content-Type": "application/json"
}

response = requests.post(API_URL, json=payload, headers=headers)
print("الاستجابة:", response.json())