🚀 SEODUMY Platform

Hướng dẫn sử dụng API

🎯 4 Endpoints Active

← Quay về trang chủ

🔐 Xác thực API

Quan trọng: Tất cả API đều yêu cầu API Key để xác thực.

Cách sử dụng: Thêm parameter key=YOUR_API_KEY vào URL hoặc gửi trong POST body.

Ví dụ:
GET https://seodumy.vn/api/balance?key=xxxxxx

🔑 Lấy API Key: Đăng nhập vào hệ thống → Vào phần Thông tin Account → API Key được tạo tự động trong profile của bạn.

📚 Tổng Quan API

🔗 Base URL: https://seodumy.vn

📋 Tổng số API: 4 endpoints

📌 Danh sách API hiện có:

  • GET /api/balance - Kiểm tra số dư vnđ
  • GET /api/platforms - Danh sách services
  • POST /api/orders - Tạo đơn hàng mới
  • GET /api/my-orders - Danh sách đơn hàng của user

🔐 Xác thực: Tất cả API đều yêu cầu API Key

📄 Format Response: JSON với UTF-8 encoding

🎯 Workflow cơ bản:

  1. Đăng nhập và lấy API Key từ phần Thông tin Account
  2. Gọi /api/platforms để lấy danh sách services
  3. Kiểm tra số dư với /api/balance
  4. Tạo đơn hàng với /api/orders
  5. Theo dõi đơn hàng với /api/my-orders
GET /api/balance ✅ ACTIVE
Lấy số dư vnđ của user hiện tại

📋 Parameters

Tham số Kiểu Bắt buộc Mô tả
key string Required API Key của user (32 ký tự)

📤 Request Example

GET https://seodumy.vn/api/balance?key=xxxxxx

📤 Response

{
  "status": "success",
  "message": "Số dư hiện tại của bạn là",
  "data": 2842180,
  "fetched_at": "18/10/2025 11:43:59"
}
GET /api/platforms ✅ ACTIVE
Lấy danh sách tất cả services và packages

📋 Parameters

Tham số Kiểu Bắt buộc Mô tả
key string Required API Key của user (32 ký tự)

📤 Request Example

GET https://seodumy.vn/api/platforms?key=xxxxxx

📤 Response

{
  "status": "success",
  "message": "Lấy danh sách services thành công",
  "data": [
    {
      "action_id": "4-40-15",
      "platform_name": "Facebook",
      "service_name": "Tăng Reaction Bài Viết",
      "package_name": "[FB-REACTION] Tăng Reaction Love",
      "package_price": 15,
      "min_max_quantity": "20-9999",
      "additional_fields": [
        {
          "title": "Loại Tương Tác",
          "value": "like,love,care,wow,haha,sad,angry",
          "price_service": "1,1.5,2,1.5,1.5,1.5,1.5"
        }
      ]
    }
  ],
  "total_records": 156,
  "fetched_at": "18/10/2025 11:43:59"
}
POST /api/orders ✅ ACTIVE
Tạo đơn hàng mới cho service (trừ tiền từ vnđ)

📋 Parameters

Tham số Kiểu Bắt buộc Mô tả
key string Required API Key của user (32 ký tự)
action_id string Required Mã định danh service (VD: "4-40-15")
url string Required URL cần thực hiện service (phải là URL hợp lệ)
value integer Required Số lượng (phải trong khoảng min-max của service)
additional_option string Optional Option bổ sung (VD: "love", "like" - bắt buộc nếu service có additional_fields)
note string Optional Ghi chú cho đơn hàng

📤 Request Example 1: Service với Additional Option

{
  "key": "xxxxxx",
  "action_id": "4-40-25",
  "url": "https://yourdomain",
  "value": 100,
  "note": "note ghi chú",
  "additional_option": "haha"
}

📤 Request Example 2: Service không có Additional Option

{
  "key": "xxxxxx",
  "action_id": "4-117-20",
  "url": "https://fb.com/ex",
  "value": 500,
  "note": "Tăng like cho bài viết"
}

📤 Response Success

{
  "status": "success",
  "message": "Tạo order thành công",
  "order_data": {
    "order_id": 12345,
    "action_id": "4-40-15",
    "total_price": 2250
  },
  "timestamp": "18/10/2025 11:43:59"
}

📤 Response Error (Thiếu additional_option)

{
  "status": "error",
  "message": "Service này yêu cầu chọn additional_option",
  "error_code": 422,
  "required_field": "additional_option",
  "available_options": ["like", "love", "care", "wow", "haha", "sad", "angry"],
  "example": {
    "additional_option": "like"
  },
  "timestamp": "18/10/2025 11:43:59"
}

📤 Response Error (Không đủ tiền)

{
  "status": "error",
  "message": "Số dư không đủ để thực hiện giao dịch",
  "error_code": 417,
  "current_balance": 25000,
  "required_amount": 50000,
  "timestamp": "18/10/2025 11:43:59"
}
GET /api/my-orders ✅ ACTIVE
Lấy danh sách đơn hàng của user hiện tại (có phân trang)

📋 Parameters

Tham số Kiểu Bắt buộc Mô tả
key string Required API Key của user (32 ký tự)
page integer Optional Số trang (mặc định: 1)
limit integer Optional Số records/trang (mặc định: 20, tối đa: 100)
status integer Optional Lọc theo type/status (1=Đã thanh toán)

📤 Request Example 1: Lấy tất cả đơn hàng (trang đầu)

GET https://seodumy.vn/api/my-orders?key=xxxxxx

📤 Request Example 2: Lấy đơn hàng với phân trang và lọc

GET https://seodumy.vn/api/my-orders?key=xxxxxx&page=2&limit=5&status=1

📤 Response Success

{
  "status": "success",
  "message": "Lấy danh sách đơn hàng thành công",
  "data": [
    {
      "order_id": 12345,
      "action_id": "4-40-15",
      "package_name": "[FB-REACTION] Tăng Reaction Love",
      "url": "https://facebook.com/example/post/123456",
      "amount": 2250,
      "type": 1,
      "additional_option": "love",
      "note": "Đơn hàng test",
      "created_date": "2025-10-18",
      "created_at": "2025-10-18 11:43:59"
    }
  ],
  "pagination": {
    "current_page": 1,
    "per_page": 20,
    "total_records": 45,
    "total_pages": 3,
    "has_next_page": true,
    "has_prev_page": false
  },
  "timestamp": "18/10/2025 11:43:59"
}

📤 Response Empty

{
  "status": "success",
  "message": "Không có đơn hàng nào",
  "data": [],
  "pagination": {
    "current_page": 1,
    "per_page": 20,
    "total_records": 0,
    "total_pages": 0
  },
  "timestamp": "18/10/2025 11:43:59"
}

📧 Liên hệ hỗ trợ: admin seodumy.vn

📝 Cập nhật: 19/10/2025 - API Documentation