API Reference
API Reference
Section titled “API Reference”This page provides comprehensive API documentation for integrating with Urwave.
Authentication
Section titled “Authentication”All API requests require authentication using an API key.
Getting Your API Key
Section titled “Getting Your API Key”- Log in to your Urwave account
- Navigate to Settings > API
- Generate a new API key
- Store it securely
Using Your API Key
Section titled “Using Your API Key”Include your API key in the request header:
Authorization: Bearer YOUR_API_KEYEndpoints
Section titled “Endpoints”GET /api/users
Section titled “GET /api/users”Retrieve a list of users.
Parameters:
limit(integer): Number of results to returnoffset(integer): Pagination offset
Response:
{ "users": [ { "id": "123", "name": "John Doe", "email": "john@example.com" } ], "total": 100}POST /api/users
Section titled “POST /api/users”Create a new user.
Request Body:
{ "name": "Jane Doe", "email": "jane@example.com", "role": "user"}Projects
Section titled “Projects”GET /api/projects
Section titled “GET /api/projects”Retrieve all projects.
POST /api/projects
Section titled “POST /api/projects”Create a new project.
Rate Limits
Section titled “Rate Limits”API requests are limited to:
- 1000 requests per hour for authenticated users
- 100 requests per hour for unauthenticated requests
Webhooks
Section titled “Webhooks”Configure webhooks to receive real-time notifications:
- Navigate to Settings > Webhooks
- Add your webhook URL
- Select events to subscribe to
- Save configuration
Error Codes
Section titled “Error Codes”Common HTTP status codes:
200- Success400- Bad Request401- Unauthorized403- Forbidden404- Not Found429- Too Many Requests500- Internal Server Error
Official SDKs are available for:
- JavaScript/TypeScript
- Python
- Ruby
- PHP
- Go
Visit our GitHub for SDK documentation and examples.