Public API

Public endpoints, request/response shapes, rate limits and errors.

Two public endpoints exist today. Everything else is internal to signed-in sessions.

POST /api/public/try-ai

Free demo endpoint. Rate limited to 10 requests per hour per IP.

curl -X POST https://nive-ai.co.in/api/public/try-ai \
  -H "Content-Type: application/json" \
  -d '{"prompt":"Explain OAuth in 3 bullets."}'

// 200 OK
{ "text": "..." }

// 429 Too Many Requests
{ "error": "You've hit the free demo limit..." }

POST /api/public/razorpay/webhook

Razorpay only. Verifies the X-Razorpay-Signature HMAC-SHA256 header against the configured webhook secret and activates plans on payment.captured. Replayed event IDs are rejected. Not intended for public calls.

Errors

Status	Meaning	Action
400	Malformed body or failed validation	Fix the request
401	Signature verification failed	Check the shared secret
429	Rate limited	Back off and retry later
500	Upstream model or gateway failure	Retry with backoff

A full authenticated API is on the roadmap. If you need programmatic access today, tell us the use case at support@nive-ai.co.in.