API Documentation
Integrate EazyUnit's powerful conversion functionality into your applications with our REST API.
Overview
The EazyUnit API provides programmatic access to our comprehensive unit conversion system. You can integrate our conversion capabilities into your own applications, websites, or services.
Our API follows REST principles, uses JSON for data interchange, and employs standard HTTP response codes.
Base URL
All API requests should be made to this endpoint
https://api.eazyunit.com/v1API Status: Operational
Authentication
API Keys
All API requests require authentication using API keys
Your API key should be included in the header of all requests:
X-API-Key: your_api_key_hereKeep your API key secure and don't expose it in client-side code.
Rate Limits
API request limits based on your subscription plan
Free Plan
100 requests per day
Basic Plan
5,000 requests per day
Pro Plan
50,000 requests per day
Response Format
All API responses are returned in JSON format
Successful responses include:
- HTTP status code 200
- Content-Type: application/json
- Response body with conversion results
API Endpoints
POST
/convertConvert Value
Convert a value from one unit to another within the same category
Request Parameters
{
"value": 10,
"from": "meter",
"to": "foot"
}Response
{
"success": true,
"result": {
"value": 32.8084,
"unit": "foot",
"from": {
"value": 10,
"unit": "meter"
},
"formula": "1 meter = 3.28084 feet"
}
}Code Examples
JavaScript Fetch Example
// Convert 10 meters to feet
const apiKey = 'your_api_key_here';
const endpoint = 'https://api.eazyunit.com/v1/convert';
fetch(endpoint, {
method: 'POST',
headers: {
'Content-Type': 'application/json',
'X-API-Key': apiKey
},
body: JSON.stringify({
value: 10,
from: 'meter',
to: 'foot'
})
})
.then(response => response.json())
.then(data => {
if (data.success) {
console.log(`Result: ${data.result.value} ${data.result.unit}`);
} else {
console.error('Conversion failed:', data.error);
}
})
.catch(error => {
console.error('API request failed:', error);
});API Plans
Free
For developers just getting started
$0/month
- 100 API requests per day
- Basic conversion categories
- Rate limiting at 10 req/min
- Community support
Popular
Basic
For small projects and applications
$19/month
- 5,000 API requests per day
- All conversion categories
- Rate limiting at 60 req/min
- Email support
- Formula endpoint access
Pro
For businesses and high-volume usage
$49/month
- 50,000 API requests per day
- All conversion categories
- Rate limiting at 120 req/min
- Priority support
- Bulk conversion endpoint
- Custom unit definitions