API Documentation

API Keys

Use your API keys to authenticate requests to the Ryin API.

🔑 Production Key

sk_live_abc123def456ghi789jkl012...

Created: January 10, 2026 • Last used: Today

🔑 Development Key

sk_test_xyz789uvw456rst123opq...

Created: January 15, 2026 • Last used: 2 hours ago

Getting Started

The Ryin API is a REST API that allows you to manage your servers programmatically.

curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://api.ryin.dev/v1/servers
        

Servers

GET /v1/servers

List all your servers

POST /v1/servers

Create a new server

GET /v1/servers/{id}

Get server details

PUT /v1/servers/{id}

Update server configuration

DELETE /v1/servers/{id}

Delete a server

Response Example

{
  "id": "srv_abc123",
  "name": "Minecraft Server #1",
  "status": "online",
  "plan": "vps",
  "location": "us-east",
  "memory": 4096,
  "storage": 50000,
  "bandwidth": "unlimited",
  "created_at": "2026-01-10T10:30:00Z",
  "uptime": 99.97
}
        

Billing

GET /v1/billing/invoices

List your invoices

GET /v1/billing/usage

Get current month usage

Rate Limiting

API requests are rate limited to 1000 requests per hour. Response headers include rate limit info:

X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 999
X-RateLimit-Reset: 1642945200
        

Status Codes

✓ 200 OK - Request succeeded

✓ 201 Created - Resource created

✗ 400 Bad Request - Invalid parameters

✗ 401 Unauthorized - Invalid API key

✗ 429 Too Many Requests - Rate limit exceeded