526 lines
23 KiB
HTML
526 lines
23 KiB
HTML
<!DOCTYPE html>
|
||
<html lang="zh-CN">
|
||
<head>
|
||
<meta charset="UTF-8">
|
||
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
||
<title>开发者文档 - 活牛采购智能数字化系统</title>
|
||
<meta name="description" content="活牛采购智能数字化系统开发者文档，提供API接口说明、SDK使用指南、集成示例和技术规范。">
|
||
<meta name="keywords" content="开发者文档,API接口,SDK,集成指南,技术文档,活牛采购系统">
|
||
|
||
<!-- Bootstrap 5 CSS -->
|
||
<link href="https://cdn.bootcdn.net/ajax/libs/bootstrap/5.3.0/css/bootstrap.min.css" rel="stylesheet">
|
||
<!-- Bootstrap Icons -->
|
||
<link href="https://cdn.bootcdn.net/ajax/libs/bootstrap-icons/1.11.0/font/bootstrap-icons.min.css" rel="stylesheet">
|
||
<!-- Font Awesome -->
|
||
<link href="https://cdn.bootcdn.net/ajax/libs/font-awesome/6.7.2/css/all.min.css" rel="stylesheet">
|
||
<!-- AOS Animation -->
|
||
<link href="https://cdn.bootcdn.net/ajax/libs/aos/2.3.4/aos.css" rel="stylesheet">
|
||
<!-- 自定义样式 -->
|
||
<link href="css/custom.css" rel="stylesheet">
|
||
</head>
|
||
<body>
|
||
<!-- 导航栏 -->
|
||
<nav class="navbar navbar-expand-lg navbar-dark bg-dark fixed-top shadow-sm">
|
||
<div class="container">
|
||
<a class="navbar-brand d-flex align-items-center" href="index.html">
|
||
<div class="logo-container me-2">
|
||
<i class="fas fa-cow text-primary fs-2"></i>
|
||
</div>
|
||
<div class="brand-text">
|
||
<div class="brand-name fw-bold">NiuMall</div>
|
||
<div class="brand-subtitle">活牛采购智能系统</div>
|
||
</div>
|
||
</a>
|
||
|
||
<button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbarNav">
|
||
<span class="navbar-toggler-icon"></span>
|
||
</button>
|
||
|
||
<div class="collapse navbar-collapse" id="navbarNav">
|
||
<ul class="navbar-nav ms-auto">
|
||
<li class="nav-item">
|
||
<a class="nav-link" href="index.html">首页</a>
|
||
</li>
|
||
<li class="nav-item">
|
||
<a class="nav-link" href="product.html">产品介绍</a>
|
||
</li>
|
||
<li class="nav-item">
|
||
<a class="nav-link" href="solutions.html">解决方案</a>
|
||
</li>
|
||
<li class="nav-item">
|
||
<a class="nav-link" href="cases.html">客户案例</a>
|
||
</li>
|
||
<li class="nav-item">
|
||
<a class="nav-link" href="about.html">关于我们</a>
|
||
</li>
|
||
<li class="nav-item">
|
||
<a class="nav-link" href="news.html">新闻动态</a>
|
||
</li>
|
||
<li class="nav-item">
|
||
<a class="nav-link active" href="docs.html">开发者文档</a>
|
||
</li>
|
||
<li class="nav-item">
|
||
<a class="nav-link" href="partners.html">合作伙伴</a>
|
||
</li>
|
||
<li class="nav-item">
|
||
<a class="nav-link" href="support.html">在线客服</a>
|
||
</li>
|
||
<li class="nav-item">
|
||
<a class="nav-link" href="contact.html">联系我们</a>
|
||
</li>
|
||
</ul>
|
||
|
||
<div class="ms-3">
|
||
<a href="contact.html" class="btn btn-primary">免费试用</a>
|
||
</div>
|
||
</div>
|
||
</div>
|
||
</nav>
|
||
|
||
<!-- 面包屑导航 -->
|
||
<nav aria-label="breadcrumb" class="pt-5 mt-5">
|
||
<div class="container">
|
||
<ol class="breadcrumb">
|
||
<li class="breadcrumb-item"><a href="index.html">首页</a></li>
|
||
<li class="breadcrumb-item active" aria-current="page">开发者文档</li>
|
||
</ol>
|
||
</div>
|
||
</nav>
|
||
|
||
<!-- 开发者文档英雄区域 -->
|
||
<section class="py-5 bg-light">
|
||
<div class="container">
|
||
<div class="row align-items-center">
|
||
<div class="col-lg-6">
|
||
<h1 class="display-5 fw-bold mb-4">开发者文档</h1>
|
||
<p class="lead">全面的技术文档和API参考，帮助开发者快速集成和使用活牛采购智能数字化系统。</p>
|
||
<div class="mt-4">
|
||
<a href="#api-reference" class="btn btn-primary btn-lg me-3">
|
||
<i class="fas fa-code me-2"></i>API参考
|
||
</a>
|
||
<a href="#quick-start" class="btn btn-outline-primary btn-lg">
|
||
<i class="fas fa-rocket me-2"></i>快速开始
|
||
</a>
|
||
</div>
|
||
</div>
|
||
<div class="col-lg-6">
|
||
<img src="images/docs-banner.jpg" alt="开发者文档" class="img-fluid rounded shadow img-hover-zoom" loading="lazy">
|
||
</div>
|
||
</div>
|
||
</div>
|
||
</section>
|
||
|
||
<!-- 文档分类 -->
|
||
<section class="py-5">
|
||
<div class="container">
|
||
<div class="text-center mb-5">
|
||
<h2 class="display-6 mb-3">文档分类</h2>
|
||
<p class="text-muted">选择您需要的技术文档类型</p>
|
||
</div>
|
||
|
||
<div class="row g-4">
|
||
<div class="col-md-4">
|
||
<div class="card border-0 h-100 text-center p-4">
|
||
<div class="feature-icon bg-primary bg-opacity-10 text-primary mb-4 mx-auto">
|
||
<i class="fas fa-code"></i>
|
||
</div>
|
||
<h5>API参考</h5>
|
||
<p class="text-muted">完整的API接口说明和参数说明</p>
|
||
<a href="#api-reference" class="btn btn-outline-primary mt-3">查看API</a>
|
||
</div>
|
||
</div>
|
||
|
||
<div class="col-md-4">
|
||
<div class="card border-0 h-100 text-center p-4">
|
||
<div class="feature-icon bg-success bg-opacity-10 text-success mb-4 mx-auto">
|
||
<i class="fas fa-book"></i>
|
||
</div>
|
||
<h5>SDK文档</h5>
|
||
<p class="text-muted">各种编程语言的SDK使用指南</p>
|
||
<a href="#sdk-docs" class="btn btn-outline-success mt-3">查看SDK</a>
|
||
</div>
|
||
</div>
|
||
|
||
<div class="col-md-4">
|
||
<div class="card border-0 h-100 text-center p-4">
|
||
<div class="feature-icon bg-info bg-opacity-10 text-info mb-4 mx-auto">
|
||
<i class="fas fa-cogs"></i>
|
||
</div>
|
||
<h5>集成指南</h5>
|
||
<p class="text-muted">系统集成和二次开发指南</p>
|
||
<a href="#integration-guide" class="btn btn-outline-info mt-3">查看指南</a>
|
||
</div>
|
||
</div>
|
||
</div>
|
||
</div>
|
||
</section>
|
||
|
||
<!-- 快速开始 -->
|
||
<section id="quick-start" class="py-5 bg-light">
|
||
<div class="container">
|
||
<div class="text-center mb-5">
|
||
<h2 class="display-6 mb-3">快速开始</h2>
|
||
<p class="text-muted">5分钟快速接入API</p>
|
||
</div>
|
||
|
||
<div class="row">
|
||
<div class="col-lg-8 mx-auto">
|
||
<div class="card border-0">
|
||
<div class="card-body">
|
||
<h4 class="mb-4">1. 获取API密钥</h4>
|
||
<p>首先需要在管理后台申请API访问密钥：</p>
|
||
<pre class="bg-dark text-light p-3 rounded"><code>// 登录管理后台
|
||
// 进入"系统设置" → "API管理"
|
||
// 点击"创建API密钥"
|
||
// 保存生成的API Key和Secret</code></pre>
|
||
|
||
<h4 class="mb-4 mt-5">2. 安装SDK</h4>
|
||
<p>选择适合您开发语言的SDK进行安装：</p>
|
||
|
||
<h6 class="mt-4">Node.js</h6>
|
||
<pre class="bg-dark text-light p-3 rounded"><code>npm install @niumall/sdk</code></pre>
|
||
|
||
<h6 class="mt-4">Python</h6>
|
||
<pre class="bg-dark text-light p-3 rounded"><code>pip install niumall-sdk</code></pre>
|
||
|
||
<h6 class="mt-4">Java</h6>
|
||
<pre class="bg-dark text-light p-3 rounded"><code><dependency>
|
||
<groupId>com.niumall</groupId>
|
||
<artifactId>sdk</artifactId>
|
||
<version>1.0.0</version>
|
||
</dependency></code></pre>
|
||
|
||
<h4 class="mb-4 mt-5">3. 调用API示例</h4>
|
||
<p>使用SDK创建采购订单：</p>
|
||
|
||
<h6 class="mt-4">Node.js示例</h6>
|
||
<pre class="bg-dark text-light p-3 rounded"><code>const { NiuMallClient } = require('@niumall/sdk');
|
||
|
||
const client = new NiuMallClient({
|
||
apiKey: 'your-api-key',
|
||
apiSecret: 'your-api-secret',
|
||
baseUrl: 'https://wapi.nanniwan.com/v1'
|
||
});
|
||
|
||
// 创建采购订单
|
||
const order = await client.orders.create({
|
||
supplierId: 'supplier-123',
|
||
productType: 'beef_cattle',
|
||
quantity: 50,
|
||
unitPrice: 15000,
|
||
deliveryDate: '2024-03-15'
|
||
});
|
||
|
||
console.log('订单创建成功:', order);</code></pre>
|
||
|
||
<h6 class="mt-4">Python示例</h6>
|
||
<pre class="bg-dark text-light p-3 rounded"><code>from niumall import NiuMallClient
|
||
|
||
client = NiuMallClient(
|
||
api_key='your-api-key',
|
||
api_secret='your-api-secret',
|
||
base_url='https://wapi.nanniwan.com/v1'
|
||
)
|
||
|
||
# 创建采购订单
|
||
order = client.orders.create({
|
||
'supplier_id': 'supplier-123',
|
||
'product_type': 'beef_cattle',
|
||
'quantity': 50,
|
||
'unit_price': 15000,
|
||
'delivery_date': '2024-03-15'
|
||
})
|
||
|
||
print('订单创建成功:', order)</code></pre>
|
||
</div>
|
||
</div>
|
||
</div>
|
||
</div>
|
||
</div>
|
||
</section>
|
||
|
||
<!-- API参考 -->
|
||
<section id="api-reference" class="py-5">
|
||
<div class="container">
|
||
<div class="text-center mb-5">
|
||
<h2 class="display-6 mb-3">API参考</h2>
|
||
<p class="text-muted">完整的API接口说明</p>
|
||
</div>
|
||
|
||
<div class="row">
|
||
<div class="col-lg-10 mx-auto">
|
||
<div class="card border-0">
|
||
<div class="card-body">
|
||
<h4 class="mb-4">认证方式</h4>
|
||
<p>所有API请求都需要在请求头中包含认证信息：</p>
|
||
<pre class="bg-dark text-light p-3 rounded"><code>Authorization: Bearer {access_token}
|
||
或者
|
||
X-API-Key: your-api-key
|
||
X-API-Secret: your-api-secret</code></pre>
|
||
|
||
<h4 class="mb-4 mt-5">订单管理API</h4>
|
||
|
||
<div class="api-endpoint">
|
||
<h5 class="text-primary">POST /v1/orders</h5>
|
||
<p class="text-muted">创建采购订单</p>
|
||
<h6>请求参数</h6>
|
||
<pre class="bg-dark text-light p-3 rounded"><code>{
|
||
"supplierId": "string", // 供应商ID
|
||
"productType": "string", // 产品类型
|
||
"quantity": "number", // 采购数量
|
||
"unitPrice": "number", // 单价（元）
|
||
"deliveryDate": "string", // 交货日期
|
||
"remarks": "string" // 备注信息
|
||
}</code></pre>
|
||
<h6>响应示例</h6>
|
||
<pre class="bg-dark text-light p-3 rounded"><code>{
|
||
"code": 200,
|
||
"message": "success",
|
||
"data": {
|
||
"orderId": "order-123456",
|
||
"status": "pending",
|
||
"createdAt": "2024-01-15T10:30:00Z"
|
||
}
|
||
}</code></pre>
|
||
</div>
|
||
|
||
<div class="api-endpoint mt-4">
|
||
<h5 class="text-primary">GET /v1/orders/{orderId}</h5>
|
||
<p class="text-muted">获取订单详情</p>
|
||
<h6>响应示例</h6>
|
||
<pre class="bg-dark text-light p-3 rounded"><code>{
|
||
"code": 200,
|
||
"message": "success",
|
||
"data": {
|
||
"orderId": "order-123456",
|
||
"supplierId": "supplier-123",
|
||
"productType": "beef_cattle",
|
||
"quantity": 50,
|
||
"unitPrice": 15000,
|
||
"totalAmount": 750000,
|
||
"status": "confirmed",
|
||
"deliveryDate": "2024-03-15",
|
||
"createdAt": "2024-01-15T10:30:00Z",
|
||
"updatedAt": "2024-01-15T11:00:00Z"
|
||
}
|
||
}</code></pre>
|
||
</div>
|
||
|
||
<h4 class="mb-4 mt-5">供应商管理API</h4>
|
||
|
||
<div class="api-endpoint">
|
||
<h5 class="text-primary">GET /v1/suppliers</h5>
|
||
<p class="text-muted">获取供应商列表</p>
|
||
<h6>查询参数</h6>
|
||
<pre class="bg-dark text-light p-3 rounded"><code>?page=1&limit=20&type=beef_cattle</code></pre>
|
||
<h6>响应示例</h6>
|
||
<pre class="bg-dark text-light p-3 rounded"><code>{
|
||
"code": 200,
|
||
"message": "success",
|
||
"data": {
|
||
"items": [
|
||
{
|
||
"supplierId": "supplier-123",
|
||
"name": "某某养殖场",
|
||
"type": "beef_cattle",
|
||
"contact": "张经理",
|
||
"phone": "13800138000",
|
||
"address": "某省某市某区"
|
||
}
|
||
],
|
||
"total": 100,
|
||
"page": 1,
|
||
"limit": 20
|
||
}
|
||
}</code></pre>
|
||
</div>
|
||
</div>
|
||
</div>
|
||
</div>
|
||
</div>
|
||
</div>
|
||
</section>
|
||
|
||
<!-- SDK文档 -->
|
||
<section id="sdk-docs" class="py-5 bg-light">
|
||
<div class="container">
|
||
<div class="text-center mb-5">
|
||
<h2 class="display-6 mb-3">SDK文档</h2>
|
||
<p class="text-muted">多种编程语言的SDK使用说明</p>
|
||
</div>
|
||
|
||
<div class="row g-4">
|
||
<div class="col-md-6">
|
||
<div class="card border-0 h-100">
|
||
<div class="card-body">
|
||
<h5 class="card-title">Node.js SDK</h5>
|
||
<p class="card-text">
|
||
适用于JavaScript/TypeScript开发的SDK，支持异步操作和Promise。
|
||
</p>
|
||
<h6 class="mt-3">安装</h6>
|
||
<pre class="bg-dark text-light p-2 rounded"><code>npm install @niumall/sdk</code></pre>
|
||
<h6 class="mt-3">基本用法</h6>
|
||
<pre class="bg-dark text-light p-2 rounded"><code>const { NiuMallClient } = require('@niumall/sdk');
|
||
const client = new NiuMallClient({ apiKey, apiSecret });</code></pre>
|
||
</div>
|
||
</div>
|
||
</div>
|
||
|
||
<div class="col-md-6">
|
||
<div class="card border-0 h-100">
|
||
<div class="card-body">
|
||
<h5 class="card-title">Python SDK</h5>
|
||
<p class="card-text">
|
||
适用于Python开发的SDK，支持同步和异步请求。
|
||
</p>
|
||
<h6 class="mt-3">安装</h6>
|
||
<pre class="bg-dark text-light p-2 rounded"><code>pip install niumall-sdk</code></pre>
|
||
<h6 class="mt-3">基本用法</h6>
|
||
<pre class="bg-dark text-light p-2 rounded"><code>from niumall import NiuMallClient
|
||
client = NiuMallClient(api_key, api_secret)</code></pre>
|
||
</div>
|
||
</div>
|
||
</div>
|
||
|
||
<div class="col-md-6">
|
||
<div class="card border-0 h-100">
|
||
<div class="card-body">
|
||
<h5 class="card-title">Java SDK</h5>
|
||
<p class="card-text">
|
||
适用于Java开发的SDK，支持Spring Boot集成。
|
||
</p>
|
||
<h6 class="mt-3">安装</h6>
|
||
<pre class="bg-dark text-light p-2 rounded"><code><dependency>
|
||
<groupId>com.niumall</groupId>
|
||
<artifactId>sdk</artifactId>
|
||
<version>1.0.0</version>
|
||
</dependency></code></pre>
|
||
<h6 class="mt-3">基本用法</h6>
|
||
<pre class="bg-dark text-light p-2 rounded"><code>NiuMallClient client = new NiuMallClient(apiKey, apiSecret);</code></pre>
|
||
</div>
|
||
</div>
|
||
</div>
|
||
|
||
<div class="col-md-6">
|
||
<div class="card border-0 h-100">
|
||
<div class="card-body">
|
||
<h5 class="card-title">PHP SDK</h5>
|
||
<p class="card-text">
|
||
适用于PHP开发的SDK，支持Composer管理。
|
||
</p>
|
||
<h6 class="mt-3">安装</h6>
|
||
<pre class="bg-dark text-light p-2 rounded"><code>composer require niumall/sdk</code></pre>
|
||
<h6 class="mt-3">基本用法</h6>
|
||
<pre class="bg-dark text-light p-2 rounded"><code>$client = new NiuMallClient($apiKey, $apiSecret);</code></pre>
|
||
</div>
|
||
</div>
|
||
</div>
|
||
</div>
|
||
</div>
|
||
</section>
|
||
|
||
<!-- 技术支持 -->
|
||
<section class="py-5">
|
||
<div class="container">
|
||
<div class="text-center mb-5">
|
||
<h2 class="display-6 mb-3">技术支持</h2>
|
||
<p class="text-muted">遇到技术问题？我们的开发团队随时为您提供帮助</p>
|
||
</div>
|
||
|
||
<div class="row g-4">
|
||
<div class="col-md-6">
|
||
<div class="card border-0 h-100 text-center p-4">
|
||
<div class="feature-icon bg-primary bg-opacity-10 text-primary mb-4 mx-auto">
|
||
<i class="fas fa-code"></i>
|
||
</div>
|
||
<h5>技术论坛</h5>
|
||
<p class="text-muted">与其他开发者交流技术问题</p>
|
||
<a href="#" class="btn btn-primary mt-3">访问论坛</a>
|
||
</div>
|
||
</div>
|
||
|
||
<div class="col-md-6">
|
||
<div class="card border-0 h-100 text-center p-4">
|
||
<div class="feature-icon bg-success bg-opacity-10 text-success mb-4 mx-auto">
|
||
<i class="fas fa-envelope"></i>
|
||
</div>
|
||
<h5>邮件支持</h5>
|
||
<p class="text-muted">发送邮件获取专业技术支持</p>
|
||
<a href="mailto:niumall@aiotagro.com" class="btn btn-success mt-3">发送邮件</a>
|
||
</div>
|
||
</div>
|
||
</div>
|
||
</div>
|
||
</section>
|
||
|
||
<!-- 页脚 -->
|
||
<footer class="footer">
|
||
<div class="container">
|
||
<div class="row">
|
||
<div class="col-lg-4 mb-4 mb-lg-0">
|
||
<h5 class="footer-title">活牛采购智能数字化系统</h5>
|
||
<p>专业的活牛采购全流程数字化管理解决方案，提升采购效率，降低经营风险。</p>
|
||
<div class="d-flex">
|
||
<a href="#" class="social-icon"><i class="fab fa-weixin"></i></a>
|
||
<a href="#" class="social-icon"><i class="fab fa-weibo"></i></a>
|
||
<a href="#" class="social-icon"><i class="fab fa-linkedin-in"></i></a>
|
||
</div>
|
||
</div>
|
||
|
||
<div class="col-lg-2 col-md-4 mb-4 mb-md-0">
|
||
<h5 class="footer-title">产品</h5>
|
||
<ul class="list-unstyled">
|
||
<li class="mb-2"><a href="product.html">功能介绍</a></li>
|
||
<li class="mb-2"><a href="solutions.html">解决方案</a></li>
|
||
<li class="mb-2"><a href="cases.html">客户案例</a></li>
|
||
<li class="mb-2"><a href="news.html">更新日志</a></li>
|
||
</ul>
|
||
</div>
|
||
|
||
<div class="col-lg-2 col-md-4 mb-4 mb-md-0">
|
||
<h5 class="footer-title">支持</h5>
|
||
<ul class="list-unstyled">
|
||
<li class="mb-2"><a href="help.html">帮助中心</a></li>
|
||
<li class="mb-2"><a href="support.html">在线客服</a></li>
|
||
<li class="mb-2"><a href="docs.html">开发者文档</a></li>
|
||
<li class="mb-2"><a href="partners.html">合作伙伴</a></li>
|
||
</ul>
|
||
</div>
|
||
|
||
<div class="col-lg-4 col-md-4">
|
||
<h5 class="footer-title">联系我们</h5>
|
||
<ul class="list-unstyled">
|
||
<li class="mb-2"><i class="fas fa-map-marker-alt me-2"></i> 武汉市东湖高新区光谷软件园F2栋</li>
|
||
<li class="mb-2"><i class="fas fa-phone me-2"></i> 19971988959</li>
|
||
<li class="mb-2"><i class="fas fa-envelope me-2"></i> niumall@aiotagro.com</li>
|
||
</ul>
|
||
</div>
|
||
</div>
|
||
|
||
<div class="copyright text-center">
|
||
<p>© 2023 活牛采购智能数字化系统. 保留所有权利。</p>
|
||
</div>
|
||
</div>
|
||
</footer>
|
||
|
||
<!-- 返回顶部按钮 -->
|
||
<button class="back-to-top" aria-label="返回顶部">
|
||
<i class="fas fa-arrow-up"></i>
|
||
</button>
|
||
|
||
<!-- Bootstrap JS -->
|
||
<script src="https://cdn.bootcdn.net/ajax/libs/twitter-bootstrap/5.3.0/js/bootstrap.bundle.min.js"></script>
|
||
<!-- AOS Animation -->
|
||
<script src="https://cdn.bootcdn.net/ajax/libs/aos/2.3.4/aos.js"></script>
|
||
<!-- 自定义脚本 -->
|
||
<script src="js/main.js"></script>
|
||
|
||
<script>
|
||
// 初始化AOS动画
|
||
AOS.init({
|
||
duration: 800,
|
||
once: true
|
||
});
|
||
</script>
|
||
</body>
|
||
</html> |