API 및 개발자 에코시스템

원하는 비즈니스를 자유롭게 구축하는 nino 오픈 엔터프라이즈 플랫폼

완전한 타입 안정성을 갖춘 RESTful API, 실시간 Webhook, 공식 SDK를 통해 기존 WMS, 커스텀 전자상거래, 3PL 물류망을 원활하게 연동합니다.

원하는 비즈니스를 자유롭게 구축하는
100% 타입 안전
OpenAPI 3.1 & JSON Schemas
< 20ms
평균 Webhook 전송 지연
샌드박스
즉시 사용 가능한 무료 테스트 환경
세밀한 권한
범위 제한 OAuth 2.0 & API 키

명확하고 예측 가능한 RESTful 인터페이스

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 토큰

개별 회계 계정이나 특정 창고 보관함 단위까지 읽기/쓰기 권한을 정밀하게 제어.

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

개발자 샌드박스에서 즉시 연동을 시작하세요

테스트용 API 키를 몇 초 만에 생성하고 종합적인 기술 안내서를 확인하세요.