API Overview

Overview of the Nevuto REST API endpoints and conventions.

The Nevuto API is organized around REST. It accepts JSON-encoded request bodies, returns JSON-encoded responses, and uses standard HTTP response codes.

Base URL

https://api.nevuto.com/v1

Request Format

All POST and PUT requests must include Content-Type: application/json.

curl -X POST https://api.nevuto.com/v1/products \
  -H "Authorization: Bearer nv_live_..." \
  -H "Content-Type: application/json" \
  -d '{"name": "T-Shirt", "price": 2999}'

Response Format

All responses return JSON with a consistent structure:

{
  "data": { ... },
  "meta": {
    "requestId": "req_abc123"
  }
}

HTTP Status Codes

Rate Limits

The API allows 100 requests per minute per API key. Rate limit headers are included in every response:

X-RateLimit-Limit: 100
X-RateLimit-Remaining: 95
X-RateLimit-Reset: 1680000000

Available Resources

• Stores — Create and manage stores
• Products — Manage product catalog
• Orders — Handle customer orders
• Payments — Process payments