API & 開発者エコシステム

自由自在な拡張と統合を実現する nino オープンエンタープライズ基盤

既存の基幹倉庫、独自ECサイト、外部3PL物流などを、完全型定義されたRESTful API、リアルタイムWebhooks、公式SDKでシームレスに統合できます。

自由自在な拡張と統合を実現する
100% 型安全
OpenAPI 3.1 & JSON Schemas
< 20ms
平均 Webhook 送信レイテンシ
Sandbox
即時利用可能な無償開発検証環境
きめ細かな権限
スコープ付き 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署名と指数バックオフ再試行付きでリアルタイム受信。

きめ細かなスコープ付き API トークン

個別の元帳勘定科目や倉庫棚番号単位にまで読み書き権限を制限したロール別APIトークンを発行可能。

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

Sandbox 環境ですぐに開発を開始

テスト用APIキーを数秒で発行し、詳細な技術ドキュメントとサンプルコードを参照できます。