Hệ Thống API Phân Dịch Post & UID Facebook

chào bạn, đây là tài liệu hướng dẫn Open API của công cụ. bạn có thể gửi HTTP POST request trực tiếp đến máy chủ của chúng tôi để xây dựng hệ thống tự động hóa của riêng bạn.

không yêu cầu tài khoản. mọi phiên gọi lệnh đều được bảo vệ bởi cơ chế chống lạm dụng giới hạn IP kết hợp cùng Public Token theo phiên.

>> Xác thực API (Token Authentication)

Để chống lại việc lạm dụng máy chủ phân rã ID, mọi request ngoại vi đều cần một Public Token hợp lệ đính kèm trong Header. Bạn có thể khởi tạo một token miễn phí ngay tại đây mà không mất công đăng ký phức tạp. Token sẽ gắn liền với trình duyệt của bạn.

POST /api/extract

◆ Mô tả: Phân tích URL và trích xuất ID Bài Viết Facebook gốc.

LIMIT Tối đa 30 requests / phút / IP.

Header yêu cầu:

X-API-Token: <Public Token của bạn>

Payload (JSON):

{
  "url": "https://www.facebook.com/share/p/..."
}

Phản hồi thành công:

{
  "success": true,
  "post_id": "123456789...",
  "method": "api_resolver"
}

POST /api/find_uid

◆ Mô tả: Dịch URL trang cá nhân/fanpage/group thành mã UID định danh.

LIMIT Tối đa 15 requests / phút / IP.

Header yêu cầu:

X-API-Token: <Public Token của bạn>

Payload (JSON):

{
  "url": "https://www.facebook.com/tanbaycu.kaiser/"
}

Phản hồi thành công:

{
  "success": true,
  "uid": "10006766...",
  "name": "Trần Minh Tân",
  "method": "api_resolver"
}

Chuẩn cấu trúc lỗi (Error Handling)

Trong trường hợp máy chủ không thể xử lý hoặc vượt quá giới hạn rate limit, kết quả trả về sẽ mang cờ success: false kèm thông báo error.

If the engine fails to resolve the ID or your IP hits the rate limit wall, the payload will contain success: false with an error trace.

{
  "success": false,
  "error": "Quá nhiều yêu cầu. Vui lòng thử lại sau 1 phút."
}

Mã mẫu tích hợp (Code Examples)

import requests
import json

url = "https://get-post-id.vercel.app/api/extract"
headers = {
    "X-API-Token": "tbc_pub_your_token_here",
    "Content-Type": "application/json"
}
data = {
    "url": "https://www.facebook.com/share/p/..."
}

response = requests.post(url, json=data, headers=headers)
print(json.dumps(response.json(), indent=4))

const fetch = require('node-fetch');

const targetUrl = 'https://get-post-id.vercel.app/api/extract';
const payload = { url: 'https://www.facebook.com/share/p/...' };

fetch(targetUrl, {
    method: 'POST',
    headers: {
        'Content-Type': 'application/json',
        'X-API-Token': 'tbc_pub_your_token_here'
    },
    body: JSON.stringify(payload)
})
.then(res => res.json())
.then(data => console.log(JSON.stringify(data, null, 2)));

curl -X POST https://get-post-id.vercel.app/api/extract \
  -H "Content-Type: application/json" \
  -H "X-API-Token: tbc_pub_your_token_here" \
  -d '{"url": "https://www.facebook.com/share/p/..."}'

◆ Mẹo: Thử sao chép mã nguồn Python và thực thi ngay tại Trình Biên Dịch Đám Mây. ◆ Tip: Copy the Python Code and execute it directly on Cloud Compiler.

>> Dự án liên quan: Buff Share Facebook

nếu bạn đang tìm kiếm một công cụ để tích hợp với webapp này nhằm xây dựng một dây chuyền tự động hóa, xin giới thiệu buffsharefacebook. dự án này có thể đọc id trực tiếp từ đây để đẩy tương tác và buff lượt chia sẻ một cách hoàn toàn tự động.

◆ tự động nhận diện id chuẩn xác
◆ cơ chế chia sẻ không bị chặn (anti-spam)
◆ kiến trúc nhẹ, dễ dàng deploy nội bộ

mở repo github

mọi vấn đề về việc thiết lập tích hợp giữa 2 dự án, vui lòng tạo issue để trao đổi cụ thể.

>> Xác thực API (Token Authentication)

>> API Authentication Token

Chuẩn cấu trúc lỗi (Error Handling)

Standard Error Handling

Mã mẫu tích hợp (Code Examples)

Integration Examples

>> Dự án liên quan: Buff Share Facebook

>> Related Project: Facebook Share Bot