API 与开发者开放生态
基于开放底座随心构建业务扩展: nino 开放企业级开发平台
借助完全类型化的 RESTful API、实时事件 Webhooks 以及官方客户端 SDK,轻松集成旧版仓储、定制电商与第三方物流系统。

100% 强类型
OpenAPI 3.1 与 JSON Schemas
< 20ms
Webhook 平均分发时延
沙箱集群
免费即时可用的开发者沙箱
细粒度控制
精细作用域 OAuth 2.0 & API 密钥
规范、直观且语义清晰的 REST 接口
POST /api/v1/finance/invoices
string;
sdksTitle: string;
sdks: Array<{ name: string; icon: string; status: string }>;
ctaBannerTitle: string;
ctaBannerSubtitle: string;
ctaBannerButton: string;
}
export const developerApiContent: Record<string, DeveloperApiContent> = {
'en-US': {
badge: 'API & Developer Ecosystem',
title: 'Build Anything on Top of',
titleHighlight: 'The nino Open Enterprise Platform',
subtitle:
'Integrate existing legacy warehouses, custom e-commerce stores, and third-party logistics via fully typed RESTful APIs, real-time Webhooks, and official client SDKs.',
stats: [
{ value: '100% Typed', label: 'OpenAPI 3.1 & JSON Schemas' },
{ value: '< 20ms', label: 'Average Webhook Dispatch Latency' },
{ value: 'Sandbox', label: 'Instant Free Developer Testing Cluster' },
{ value: 'Granular', label: 'Scoped OAuth 2.0 & API Keys' },
],
featuresTitle: 'Developer-First Platform Features',
features: [
{
icon: 'mdi:webhook',
title: 'Event-Driven Webhooks',
desc: 'Subscribe to order creations, inventory lot movements, and invoice approvals with cryptographic HMAC signatures and automatic exponential backoff retries.',
},
{
icon: 'mdi:key-outline',
title: 'Fine-Grained Scoped API Tokens',
desc: 'Issue role-based developer API tokens with read/write restrictions restricted down to individual ledger accounts or warehouse bins.',
},
{
icon: 'mdi:code-json',
title: 'OpenAPI Specification & Swagger',
desc: 'Import our interactive OpenAPI specs into Postman, Insomnia, or code-generation pipelines for instantaneous typed client bindings.',
},
{
icon: 'mdi:speedometer',
title: 'Generous Rate Limits & Bursting',
desc: 'Built for enterprise throughput with default 10,000 requests/minute ceilings and token bucket burst allowances for batch sync operations.',
},
],
sampleRequestTitle: 'Clean & Predictable REST Interfaces',
codeSnippet: `// Create an invoice with automated GL posting
curl -X POST https://api.nino.to/api/v1/finance/invoices \\
-H "Authorization: Bearer ipw_live_sec_99a812bf00" \\
-H "x-tenant-slug: acme-corp" \\
-H "Content-Type: application/json" \\
-d '{
"customerId": "cust_88291a",
"currency": "USD",
"items": [
{ "productId": "prod_sku_001", "quantity": 10, "unitPrice": 450.00 }
],
"autoPostLedger": true
}'`,
sdksTitle: 'Official Language SDKs',
sdks: [
{ name: 'TypeScript / Node.js', icon: 'simple-icons:typescript', status: 'GA • v2.4.0' },
{ name: 'Python', icon: 'simple-icons:python', status: 'GA • v2.2.1' },
{ name: 'Go', icon: 'simple-icons:go', status: 'GA • v1.8.0' },
{ name: '.NET / C#', icon: 'simple-icons:dotnet', status: 'Beta • v1.0.0' },
],
ctaBannerTitle: 'Start building in our developer sandbox',
ctaBannerSubtitle: 'Generate your free test API keys in seconds and review our interactive API documentation.',
ctaBannerButton: 'Explore Interactive API Docs',
},
'vi-VN': {
badge: 'Nền Tảng Tích Hợp & Lập Trình Viên',
title: 'Mở Rộng Không Giới Hạn Trên Nền',
titleHighlight: 'Hệ Sinh Thái API nino Mở',
subtitle:
'Kết nối linh hoạt hệ thống kho bãi cũ, website thương mại điện tử riêng và đơn vị giao vận 3PL thông qua hệ thống RESTful API chuẩn mực, Webhooks thời gian thực và bộ SDK chính hãng.',
stats: [
{ value: 'Chuẩn Hóa', label: 'OpenAPI 3.1 & JSON Schemas' },
{ value: '< 20ms', label: 'Tốc độ phát Webhook sự kiện' },
{ value: 'Sandbox', label: 'Môi trường test lập trình miễn phí' },
{ value: 'Chặt Chẽ', label: 'Phân quyền API Token chi tiết' },
],
featuresTitle: 'Tính Năng Dành Cho Nhà Phát Triển',
features: [
{
icon: 'mdi:webhook',
title: 'Webhooks Sự Kiện Thời Gian Thực',
desc: 'Đăng ký lắng nghe sự kiện tạo đơn hàng, biến động tồn kho và duyệt hóa đơn với chữ ký mã hóa HMAC và cơ chế gửi lại tự động.',
},
{
icon: 'mdi:key-outline',
title: 'Phân Quyền Khóa API (Scoped Tokens)',
desc: 'Tạo các khóa API chỉ có quyền đọc hoặc ghi giới hạn cho từng phân hệ kế toán hay từng kho hàng cụ thể.',
},
{
icon: 'mdi:code-json',
title: 'Chuẩn OpenAPI & Swagger Đầy Đủ',
desc: 'Tải nhanh file đặc tả OpenAPI vào Postman, Insomnia hoặc các bộ sinh mã (code generator) để tạo client types tự động.',
},
{
icon: 'mdi:speedometer',
title: 'Hạn Mức Gọi API Lớn & Ổn Định',
desc: 'Hỗ trợ lên tới 10,000 requests/phút cho các tác vụ đồng bộ dữ liệu khối lớn (batch sync) của doanh nghiệp.',
},
],
sampleRequestTitle: 'Giao Thức REST Rõ Ràng & Chuẩn Mực',
codeSnippet: `// Tạo hóa đơn và tự động hạch toán sổ cái
curl -X POST https://api.nino.to/api/v1/finance/invoices \\
-H "Authorization: Bearer ipw_live_sec_99a812bf00" \\
-H "x-tenant-slug: acme-corp" \\
-H "Content-Type: application/json" \\
-d '{
"customerId": "cust_88291a",
"currency": "VND",
"items": [
{ "productId": "prod_sku_001", "quantity": 10, "unitPrice": 12500000 }
],
"autoPostLedger": true
}'`,
sdksTitle: 'Bộ Thư Viện SDK Chính Thức',
sdks: [
{ name: 'TypeScript / Node.js', icon: 'simple-icons:typescript', status: 'Chính thức • v2.4.0' },
{ name: 'Python', icon: 'simple-icons:python', status: 'Chính thức • v2.2.1' },
{ name: 'Go', icon: 'simple-icons:go', status: 'Chính thức • v1.8.0' },
{ name: '.NET / C#', icon: 'simple-icons:dotnet', status: 'Bản thử nghiệm • v1.0.0' },
],
ctaBannerTitle: 'Bắt đầu tích hợp trên môi trường Sandbox',
ctaBannerSubtitle: 'Tạo mã khóa API thử nghiệm trong tích tắc và đọc tài liệu hướng dẫn kỹ thuật chi tiết.',
ctaBannerButton: 'Xem Tài Liệu API & Sandbox',
},
};
开发者优先的平台级特性
事件驱动型 Webhook
订阅订单创建、批次移库、发票审批等业务事件,自带 HMAC 加密验签与自动指数退避重试。
细粒度权限作用域令牌
支持为单个财务科目或特定货位分配只读/读写权限,最小化授权风险。
OpenAPI 3.1 规范与 Swagger 支持
可直接导入 Postman、Insomnia 或代码生成流水线,秒级生成强类型客户端。
高吞吐调用配额与突发缓冲
企业级默认每分钟 10,000 次请求配额,结合令牌桶突发算法从容应对批量同步峰值。
官方多语言 SDK 库
TypeScript / Node.js
官方正式版 • v2.4.0
Python
官方正式版 • v2.2.1
Go
官方正式版 • v1.8.0
.NET / C#
预览版 • v1.0.0
