快速开始

几分钟内即可开始使用 RAKUFUN SDK 并完成集成。

快速安装

在 HTML 页面中引入 SDK：

html

<script src="https://sdk.rakufun.com/rakufun-universal.min.js"></script>

基本用法

第一步：处理购买动作

javascript

async function buyWithRakufun() {
  try {
    await rakufun.quickBuy({
      title: "iPhone 15 Pro Max",
      price: "189800",
      url: "https://example.com/iphone-15-pro-max"
    });
  } catch (error) {
    console.error('购买失败:', error);
  }
}

第二步：添加到网站

html

<!DOCTYPE html>
<html>
<head>
    <title>我的电商网站</title>
</head>
<body>
    <div class="product">
        <h1>iPhone 15 Pro Max</h1>
        <p class="price">¥189,800</p>
        <button onclick="buyWithRakufun()">
            🛒 使用 RAKUFUN 购买
        </button>
    </div>

    <script src="https://sdk.rakufun.com/rakufun-universal.min.js"></script>
    <script>
        async function buyWithRakufun() {
            await rakufun.quickBuy({
                title: "iPhone 15 Pro Max 256GB Natural Titanium",
                price: "189800",
                url: window.location.href
            });
        }
    </script>
</body>
</html>

完整示例

使用全部字段的完整示例：

javascript

async function completeExample() {
    try {
        await rakufun.quickBuy({
            // 必填字段
            url: window.location.href,
            title: "Nintendo Switch OLED",
            price: "37980",
            
            // 可选字段
            description: "最新款 7 英寸 OLED 显示屏 Switch",
            images: ["https://example.com/switch-oled.jpg"],
            brand: "Nintendo",
            condition: "New",
            minQuantity: "1",
            maxStock: "30",
            shippingInfo: "0",
            deliveryTime: "1-3 days",
            precautions: "含 1 年原厂保修",
            productParameters: "Display: 7-inch OLED, Storage: 64GB"
        });
    } catch (error) {
        console.error('购买失败:', error);
    }
}

错误处理

SDK 提供完善的错误处理：

javascript

async function buyWithRakufun() {
    try {
        await rakufun.quickBuy({
            title: "Product Title",
            price: "12300",
            url: window.location.href
        });
    } catch (error) {
        // 处理错误
        switch (error.code) {
            case 'VALIDATION_ERROR':
                alert('商品信息不完整，请检查');
                break;
            case 'NETWORK_ERROR':
                alert('网络连接失败，请重试');
                break;
            default:
                alert('购买失败，请稍后重试');
        }
    }
}

字段参考（14 个字段）

javascript

// 基本信息（5 个字段）
url: "https://...",                    // 商品页面 URL（自动获取或手动设置）
title: "Product Title",               // 商品名称
price: "19800",                       // 商品价格（数字字符串）
description: "Product Description",   // 详细描述
images: ["img1.jpg", "img2.jpg"],     // 商品图片数组

// 商品属性（5 个字段）
condition: "New",                     // 商品状态（全新 / 二手 / 展示 等）
brand: "Brand Name",                  // 品牌名称
minQuantity: "1",                     // 最低起购数量
maxStock: "100",                      // 最大库存数量
shippingInfo: "500",                  // 运费信息

// 物流信息（2 个字段）
deliveryTime: "3-5 days",             // 预计配送时间
precautions: "Precaution notes",      // 注意事项/附加说明

// 规格参数（1 个字段）
productParameters: "Specifications",  // 商品参数（规格表等）

// 系统信息（1 个字段）
timestamp: "2024-11-06T..."           // 捕获时间戳（自动生成）

下一步

您已经成功运行 RAKUFUN SDK，可以继续：

查看 API 文档 - 全部方法说明
查看示例 - 真实使用场景
UI 模式与自定义集成 - 切换模式或自定义界面

需要帮助？

支持邮箱：[email protected]

快速开始 ​

快速安装 ​

基本用法 ​

第一步：处理购买动作 ​

第二步：添加到网站 ​

完整示例 ​

错误处理 ​

字段参考（14 个字段） ​

下一步 ​

需要帮助？ ​

快速开始

快速安装

基本用法

第一步：处理购买动作

第二步：添加到网站

完整示例

错误处理

字段参考（14 个字段）

下一步

需要帮助？