Valutoria API Reference Developer Portal
Unleash the power of AI-driven business automation with our enterprise-grade API ecosystem. Built for developers who demand performance, reliability, and infinite scalability.
Real-time data flow
Valutoria API Reference Developer Portal
Unleash the power of AI-driven business automation with our enterprise-grade API ecosystem. Built for developers who demand performance, reliability, and infinite scalability.
Real-time data flow
Getting Started
From zero to hero in minutes. Our API is designed for developers who demand speed, reliability, and enterprise-grade performance without the complexity.
Quick Installation
# Install Valutoria SDK
npm install @valutoria/api-client
# Or using pip for Python
pip install valutoria-api
# Or using composer for PHP
composer require valutoria/api-clientFirst API Call
import ValutoriaAPI from '@valutoria/api-client';
const api = new ValutoriaAPI({
apiKey: 'your-api-key',
environment: 'production'
});
// Your first API call
const response = await api.hosting.getInstances();
console.log('Active instances:', response.data);Instant Deployment
Launch your hosting instances in seconds, not hours. Our optimized infrastructure ensures immediate availability.
- Zero configuration required
- Automatic resource optimization
- Real-time monitoring included
Enterprise Security
Your data is protected by quantum-grade encryption and industry-leading security protocols.
- End-to-end encryption
- Automated security patches
- Compliance-ready infrastructure
Pro Tip
Start with our sandbox environment to test your integrations. Once you're ready, switch to production with a single configuration change. No downtime, no hassle.
const api = new ValutoriaAPI({ environment: 'sandbox' }); // Test first
Getting Started
From zero to hero in minutes. Our API is designed for developers who demand speed, reliability, and enterprise-grade performance without the complexity.
Quick Installation
# Install Valutoria SDK
npm install @valutoria/api-client
# Or using pip for Python
pip install valutoria-api
# Or using composer for PHP
composer require valutoria/api-clientFirst API Call
import ValutoriaAPI from '@valutoria/api-client';
const api = new ValutoriaAPI({
apiKey: 'your-api-key',
environment: 'production'
});
// Your first API call
const response = await api.hosting.getInstances();
console.log('Active instances:', response.data);Instant Deployment
Launch your hosting instances in seconds, not hours. Our optimized infrastructure ensures immediate availability.
- Zero configuration required
- Automatic resource optimization
- Real-time monitoring included
Enterprise Security
Your data is protected by quantum-grade encryption and industry-leading security protocols.
- End-to-end encryption
- Automated security patches
- Compliance-ready infrastructure
Pro Tip
Start with our sandbox environment to test your integrations. Once you're ready, switch to production with a single configuration change. No downtime, no hassle.
const api = new ValutoriaAPI({ environment: 'sandbox' }); // Test first
Authentication
Enterprise-grade security with quantum encryption. Your data is protected by the same technology that will secure tomorrow's digital world.
Generate API Key
Create your API key in the Valutoria dashboard. Each key is unique and tied to your account with granular permissions.
Configure Headers
Include your API key in the Authorization header of every request. We support Bearer token authentication.
Start Building
You're ready to make authenticated requests. All endpoints require valid authentication.
Authentication Header
Authorization: Bearer your-api-key-here
Content-Type: application/json
X-Valutoria-Version: 2024-01Example Request
curl -X GET \
https://api.valutoria.com/v1/hosting/instances \
-H 'Authorization: Bearer your-api-key' \
-H 'Content-Type: application/json'Quantum Encryption
Your API keys are protected by next-generation encryption algorithms designed to withstand quantum computing attacks.
Granular Permissions
Control exactly what each API key can access. Create read-only keys for analytics or full-access keys for automation.
Real-time Monitoring
Monitor API key usage in real-time. Get alerts for suspicious activity and automatically revoke compromised keys.
Security Best Practices
- Never expose API keys in client-side code
- Use environment variables for key storage
- Rotate keys regularly (monthly recommended)
- Monitor usage patterns for anomalies
- Use separate keys for different environments
- Enable IP whitelisting when possible
Authentication
Enterprise-grade security with quantum encryption. Your data is protected by the same technology that will secure tomorrow's digital world.
Generate API Key
Create your API key in the Valutoria dashboard. Each key is unique and tied to your account with granular permissions.
Configure Headers
Include your API key in the Authorization header of every request. We support Bearer token authentication.
Start Building
You're ready to make authenticated requests. All endpoints require valid authentication.
Authentication Header
Authorization: Bearer your-api-key-here
Content-Type: application/json
X-Valutoria-Version: 2024-01Example Request
curl -X GET \
https://api.valutoria.com/v1/hosting/instances \
-H 'Authorization: Bearer your-api-key' \
-H 'Content-Type: application/json'Quantum Encryption
Your API keys are protected by next-generation encryption algorithms designed to withstand quantum computing attacks.
Granular Permissions
Control exactly what each API key can access. Create read-only keys for analytics or full-access keys for automation.
Real-time Monitoring
Monitor API key usage in real-time. Get alerts for suspicious activity and automatically revoke compromised keys.
Security Best Practices
- Never expose API keys in client-side code
- Use environment variables for key storage
- Rotate keys regularly (monthly recommended)
- Monitor usage patterns for anomalies
- Use separate keys for different environments
- Enable IP whitelisting when possible
API Endpoints
Complete control over your digital infrastructure. From hosting management to AI automation, every endpoint is optimized for performance and reliability.
Hosting Management
Manage your hosting instances with enterprise-grade performance and zero-downtime scaling.
List All Instances
Retrieve all your active hosting instances with detailed performance metrics and configuration data.
Response Example
{
"status": "success",
"data": {
"instances": [
{
"id": "inst_abc123",
"name": "production-odoo",
"plan": "value-plus",
"workers": 4,
"status": "running",
"uptime": "99.98%",
"created_at": "2024-01-15T10:30:00Z"
}
],
"total": 1,
"page": 1
}
}Parameters
Create New Instance
Deploy a new hosting instance with custom configuration. Instant provisioning with zero downtime.
Request Body
{
"name": "my-new-instance",
"plan": "value-eco",
"workers": 2,
"odoo_version": "17.0",
"edition": "enterprise",
"modules": ["sale", "crm", "inventory"],
"backup_frequency": "daily"
}Success Response
{
"status": "success",
"data": {
"instance": {
"id": "inst_xyz789",
"name": "my-new-instance",
"status": "provisioning",
"estimated_ready": "2024-05-27T14:35:00Z",
"access_url": "https://xyz789.valupanel.com"
}
}
}Scale Instance
Scale your instance up or down instantly. No downtime, no data loss, just pure performance on demand.
Delete Instance
Permanently delete a hosting instance. This action cannot be undone.
AI Automation
Deploy intelligent workflows that adapt and optimize automatically with next-gen AI.
Create Workflow
Deploy intelligent workflows that adapt and optimize automatically. Built with next-gen AI that learns from your business patterns.
Example Use Cases
Analytics & Insights
Get AI-powered business insights and predictive analytics that help you stay ahead of the competition.
Backup & Security
Quantum-grade encryption and automated backups to keep your data safe and accessible.
Create Backup
Instant, encrypted backups with point-in-time recovery. Your data is protected by quantum-grade encryption.
Security Audit
Real-time security scanning and vulnerability assessment. Stay protected against emerging threats.
Quick Reference
Base URL
https://api.valutoria.com/v1
Authentication
Bearer {your-api-key}
Content Type
application/json
Rate Limit
10,000 requests/hour
API Endpoints
Complete control over your digital infrastructure. From hosting management to AI automation, every endpoint is optimized for performance and reliability.
Hosting Management
Manage your hosting instances with enterprise-grade performance and zero-downtime scaling.
List All Instances
Retrieve all your active hosting instances with detailed performance metrics and configuration data.
Response Example
{
"status": "success",
"data": {
"instances": [
{
"id": "inst_abc123",
"name": "production-odoo",
"plan": "value-plus",
"workers": 4,
"status": "running",
"uptime": "99.98%",
"created_at": "2024-01-15T10:30:00Z"
}
],
"total": 1,
"page": 1
}
}Parameters
Create New Instance
Deploy a new hosting instance with custom configuration. Instant provisioning with zero downtime.
Request Body
{
"name": "my-new-instance",
"plan": "value-eco",
"workers": 2,
"odoo_version": "17.0",
"edition": "enterprise",
"modules": ["sale", "crm", "inventory"],
"backup_frequency": "daily"
}Success Response
{
"status": "success",
"data": {
"instance": {
"id": "inst_xyz789",
"name": "my-new-instance",
"status": "provisioning",
"estimated_ready": "2024-05-27T14:35:00Z",
"access_url": "https://xyz789.valupanel.com"
}
}
}Scale Instance
Scale your instance up or down instantly. No downtime, no data loss, just pure performance on demand.
Delete Instance
Permanently delete a hosting instance. This action cannot be undone.
AI Automation
Deploy intelligent workflows that adapt and optimize automatically with next-gen AI.
Create Workflow
Deploy intelligent workflows that adapt and optimize automatically. Built with next-gen AI that learns from your business patterns.
Example Use Cases
Analytics & Insights
Get AI-powered business insights and predictive analytics that help you stay ahead of the competition.
Backup & Security
Quantum-grade encryption and automated backups to keep your data safe and accessible.
Create Backup
Instant, encrypted backups with point-in-time recovery. Your data is protected by quantum-grade encryption.
Security Audit
Real-time security scanning and vulnerability assessment. Stay protected against emerging threats.
Quick Reference
Base URL
https://api.valutoria.com/v1
Authentication
Bearer {your-api-key}
Content Type
application/json
Rate Limit
10,000 requests/hour
Rate Limits & Usage
Designed for high-performance applications. Our rate limits are generous because we believe in empowering developers, not restricting them.
Starter Plan
requests per hour
Business Plan
requests per hour
Enterprise
unlimited requests
Rate Limit Headers
Every API response includes rate limit information in the headers:
X-RateLimit-Limit: 10000
X-RateLimit-Remaining: 9850
X-RateLimit-Reset: 1640995200
X-RateLimit-Used: 150Rate Limit Reset
Rate limits reset every hour based on a sliding window:
Counter increments
Counter resets to 0
Usage Monitoring
Real-time Tracking
Monitor your API usage in real-time through our dashboard. Get instant alerts when approaching limits.
Smart Alerts
Receive notifications at 75%, 90%, and 95% of your rate limit to prevent service interruptions.
Usage Analytics
Detailed analytics help you understand your usage patterns and optimize your API calls.
Best Practices
Do's
- Implement exponential backoff for retries
- Cache responses when possible
- Use webhooks instead of polling
- Monitor your usage regularly
- Batch requests when supported
Don'ts
- Don't ignore rate limit headers
- Don't make unnecessary API calls
- Don't use aggressive retry strategies
- Don't exceed your plan limits regularly
- Don't share API keys between applications
Rate Limits & Usage
Designed for high-performance applications. Our rate limits are generous because we believe in empowering developers, not restricting them.
Starter Plan
requests per hour
Business Plan
requests per hour
Enterprise
unlimited requests
Rate Limit Headers
Every API response includes rate limit information in the headers:
X-RateLimit-Limit: 10000
X-RateLimit-Remaining: 9850
X-RateLimit-Reset: 1640995200
X-RateLimit-Used: 150Rate Limit Reset
Rate limits reset every hour based on a sliding window:
Counter increments
Counter resets to 0
Usage Monitoring
Real-time Tracking
Monitor your API usage in real-time through our dashboard. Get instant alerts when approaching limits.
Smart Alerts
Receive notifications at 75%, 90%, and 95% of your rate limit to prevent service interruptions.
Usage Analytics
Detailed analytics help you understand your usage patterns and optimize your API calls.
Best Practices
Do's
- Implement exponential backoff for retries
- Cache responses when possible
- Use webhooks instead of polling
- Monitor your usage regularly
- Batch requests when supported
Don'ts
- Don't ignore rate limit headers
- Don't make unnecessary API calls
- Don't use aggressive retry strategies
- Don't exceed your plan limits regularly
- Don't share API keys between applications
SDKs & Libraries
Native libraries for every major programming language. Write less code, ship faster, and focus on what matters most - your business logic.
JavaScript/Node.js
npm package
npm install @valutoria/api-clientPython
PyPI package
pip install valutoria-apiPHP
Composer package
composer require valutoria/api-clientJava
Maven Central
com.valutoria
api-client
2.0.1
C# / .NET
NuGet package
Install-Package Valutoria.ApiClientFeature Comparison
| Feature | JS | Python | PHP | Java | C# | Go |
|---|---|---|---|---|---|---|
| Async Support | ||||||
| Type Safety | ||||||
| Auto Retry | ||||||
| Streaming | ||||||
| Webhooks |
Quick Start Example
import ValutoriaAPI from '@valutoria/api-client';
const client = new ValutoriaAPI({
apiKey: process.env.VALUTORIA_API_KEY,
environment: 'production'
});
// Create a new hosting instance
const instance = await client.hosting.create({
name: 'my-production-app',
plan: 'value-plus',
workers: 4
});
console.log('Instance created:', instance.id);from valutoria import ValutoriaAPI
import os
client = ValutoriaAPI(
api_key=os.getenv('VALUTORIA_API_KEY'),
environment='production'
)
# Create a new hosting instance
instance = client.hosting.create(
name='my-production-app',
plan='value-plus',
workers=4
)
print(f'Instance created: {instance.id}') $_ENV['VALUTORIA_API_KEY'],
'environment' => 'production'
]);
// Create a new hosting instance
$instance = $client->hosting->create([
'name' => 'my-production-app',
'plan' => 'value-plus',
'workers' => 4
]);
echo "Instance created: " . $instance->id;import com.valutoria.ApiClient;
import com.valutoria.models.Instance;
ApiClient client = new ApiClient.Builder()
.apiKey(System.getenv("VALUTORIA_API_KEY"))
.environment("production")
.build();
// Create a new hosting instance
Instance instance = client.hosting().create()
.name("my-production-app")
.plan("value-plus")
.workers(4)
.execute();
System.out.println("Instance created: " + instance.getId());SDKs & Libraries
Native libraries for every major programming language. Write less code, ship faster, and focus on what matters most - your business logic.
JavaScript/Node.js
npm package
npm install @valutoria/api-clientPython
PyPI package
pip install valutoria-apiPHP
Composer package
composer require valutoria/api-clientJava
Maven Central
com.valutoria
api-client
2.0.1
C# / .NET
NuGet package
Install-Package Valutoria.ApiClientFeature Comparison
| Feature | JS | Python | PHP | Java | C# | Go |
|---|---|---|---|---|---|---|
| Async Support | ||||||
| Type Safety | ||||||
| Auto Retry | ||||||
| Streaming | ||||||
| Webhooks |
Quick Start Example
import ValutoriaAPI from '@valutoria/api-client';
const client = new ValutoriaAPI({
apiKey: process.env.VALUTORIA_API_KEY,
environment: 'production'
});
// Create a new hosting instance
const instance = await client.hosting.create({
name: 'my-production-app',
plan: 'value-plus',
workers: 4
});
console.log('Instance created:', instance.id);from valutoria import ValutoriaAPI
import os
client = ValutoriaAPI(
api_key=os.getenv('VALUTORIA_API_KEY'),
environment='production'
)
# Create a new hosting instance
instance = client.hosting.create(
name='my-production-app',
plan='value-plus',
workers=4
)
print(f'Instance created: {instance.id}') $_ENV['VALUTORIA_API_KEY'],
'environment' => 'production'
]);
// Create a new hosting instance
$instance = $client->hosting->create([
'name' => 'my-production-app',
'plan' => 'value-plus',
'workers' => 4
]);
echo "Instance created: " . $instance->id;import com.valutoria.ApiClient;
import com.valutoria.models.Instance;
ApiClient client = new ApiClient.Builder()
.apiKey(System.getenv("VALUTORIA_API_KEY"))
.environment("production")
.build();
// Create a new hosting instance
Instance instance = client.hosting().create()
.name("my-production-app")
.plan("value-plus")
.workers(4)
.execute();
System.out.println("Instance created: " + instance.getId());Error Handling
Comprehensive error responses that help you debug faster and build more resilient applications. Every error tells a story - we make sure it's a helpful one.
HTTP Status Codes
Error Response Format
{
"status": "error",
"error": {
"code": "VALIDATION_ERROR",
"message": "Invalid request parameters",
"details": {
"field": "workers",
"issue": "Value must be between 1 and 8"
},
"request_id": "req_abc123def456",
"timestamp": "2024-05-27T12:00:00Z",
"documentation": "https://docs.valutoria.com/errors#validation"
}
}Error Response Fields
status
Always "error" for error responses
code
Machine-readable error code
message
Human-readable error description
details
Additional context about the error
request_id
Unique identifier for support tickets
Common Error Codes
Authentication Failed
The provided API key is invalid, expired, or malformed.
- Verify your API key is correct
- Check if the key has expired
- Ensure proper Bearer token format
Too Many Requests
You've exceeded your API rate limit. Slow down your requests.
- Implement exponential backoff
- Check rate limit headers
- Consider upgrading your plan
Resource Missing
The requested resource doesn't exist or has been deleted.
- Verify the resource ID is correct
- Check if resource was deleted
- Ensure proper permissions
Invalid Parameters
Request parameters are missing, invalid, or out of range.
- Check parameter types and values
- Ensure required fields are provided
- Review API documentation
Quota Exceeded
You've reached your plan's usage limits or quota.
- Upgrade to a higher plan
- Wait for quota reset
- Optimize your usage patterns
Server Error
An unexpected error occurred on our servers.
- Retry the request after a delay
- Contact support with request_id
- Check our status page
Retry Strategies
Recommended: Exponential Backoff
Implement exponential backoff with jitter for optimal retry behavior.
async function retryWithBackoff(fn, maxRetries = 3) {
for (let attempt = 0; attempt < maxRetries; attempt++) {
try {
return await fn();
} catch (error) {
if (attempt === maxRetries - 1) throw error;
// Exponential backoff: 1s, 2s, 4s, etc.
const delay = Math.pow(2, attempt) * 1000;
const jitter = Math.random() * 500; // Add jitter
await new Promise(resolve =>
setTimeout(resolve, delay + jitter)
);
}
}
}Avoid: Aggressive Retries
Don't retry immediately or too frequently - this can worsen rate limiting.
// BAD: Immediate retry without backoff
async function badRetry(fn, maxRetries = 3) {
for (let attempt = 0; attempt < maxRetries; attempt++) {
try {
return await fn();
} catch (error) {
if (attempt === maxRetries - 1) throw error;
// No delay - will overwhelm the server!
}
}
}Debugging Tips
Use Request IDs
Always include the request_id when contacting support. This helps us locate and diagnose issues faster.
Log Error Details
Log the complete error response, including status code, error code, and details for better debugging.
Monitor Error Rates
Track error rates and patterns in your applications to identify issues before they become critical.
Check Documentation
Each error includes a documentation link with detailed information about the specific error type.
Error Monitoring
Monitor your API error rates and patterns through our dashboard. Set up alerts for unusual error spikes and get insights into your application's health.
- Real-time error tracking
- Error rate alerts and notifications
- Detailed error analytics and patterns
- Integration with popular monitoring tools
Error Analytics Dashboard
Track patterns and optimize performance
Error Handling
Comprehensive error responses that help you debug faster and build more resilient applications. Every error tells a story - we make sure it's a helpful one.
HTTP Status Codes
Error Response Format
{
"status": "error",
"error": {
"code": "VALIDATION_ERROR",
"message": "Invalid request parameters",
"details": {
"field": "workers",
"issue": "Value must be between 1 and 8"
},
"request_id": "req_abc123def456",
"timestamp": "2024-05-27T12:00:00Z",
"documentation": "https://docs.valutoria.com/errors#validation"
}
}Error Response Fields
status
Always "error" for error responses
code
Machine-readable error code
message
Human-readable error description
details
Additional context about the error
request_id
Unique identifier for support tickets
Common Error Codes
Authentication Failed
The provided API key is invalid, expired, or malformed.
- Verify your API key is correct
- Check if the key has expired
- Ensure proper Bearer token format
Too Many Requests
You've exceeded your API rate limit. Slow down your requests.
- Implement exponential backoff
- Check rate limit headers
- Consider upgrading your plan
Resource Missing
The requested resource doesn't exist or has been deleted.
- Verify the resource ID is correct
- Check if resource was deleted
- Ensure proper permissions
Invalid Parameters
Request parameters are missing, invalid, or out of range.
- Check parameter types and values
- Ensure required fields are provided
- Review API documentation
Quota Exceeded
You've reached your plan's usage limits or quota.
- Upgrade to a higher plan
- Wait for quota reset
- Optimize your usage patterns
Server Error
An unexpected error occurred on our servers.
- Retry the request after a delay
- Contact support with request_id
- Check our status page
Retry Strategies
Recommended: Exponential Backoff
Implement exponential backoff with jitter for optimal retry behavior.
async function retryWithBackoff(fn, maxRetries = 3) {
for (let attempt = 0; attempt < maxRetries; attempt++) {
try {
return await fn();
} catch (error) {
if (attempt === maxRetries - 1) throw error;
// Exponential backoff: 1s, 2s, 4s, etc.
const delay = Math.pow(2, attempt) * 1000;
const jitter = Math.random() * 500; // Add jitter
await new Promise(resolve =>
setTimeout(resolve, delay + jitter)
);
}
}
}Avoid: Aggressive Retries
Don't retry immediately or too frequently - this can worsen rate limiting.
// BAD: Immediate retry without backoff
async function badRetry(fn, maxRetries = 3) {
for (let attempt = 0; attempt < maxRetries; attempt++) {
try {
return await fn();
} catch (error) {
if (attempt === maxRetries - 1) throw error;
// No delay - will overwhelm the server!
}
}
}Debugging Tips
Use Request IDs
Always include the request_id when contacting support. This helps us locate and diagnose issues faster.
Log Error Details
Log the complete error response, including status code, error code, and details for better debugging.
Monitor Error Rates
Track error rates and patterns in your applications to identify issues before they become critical.
Check Documentation
Each error includes a documentation link with detailed information about the specific error type.
Error Monitoring
Monitor your API error rates and patterns through our dashboard. Set up alerts for unusual error spikes and get insights into your application's health.
- Real-time error tracking
- Error rate alerts and notifications
- Detailed error analytics and patterns
- Integration with popular monitoring tools
Error Analytics Dashboard
Track patterns and optimize performance
Ready to Build the Future?
Join elite developers who are already transforming businesses with Valutoria API. Your competitive advantage starts with the first API call.
24/7 Support
Immediate phone support with direct access to our technical experts
Direct Line
Priority email support with guaranteed response times
Community
Connect with developers, share solutions, and get community support
Enterprise Support
Need dedicated support, custom integrations, or enterprise-grade SLAs? Our enterprise team provides white-glove service for mission-critical implementations.
Developer Resources
"Valutoria's API transformed our development workflow. The documentation is crystal clear, the SDKs are robust, and their support team responds faster than our internal team!"
Start Building Today
Join thousands of developers who trust Valutoria API for their mission-critical applications.
Ready to Build the Future?
Join elite developers who are already transforming businesses with Valutoria API. Your competitive advantage starts with the first API call.
24/7 Support
Immediate phone support with direct access to our technical experts
Direct Line
Priority email support with guaranteed response times
Community
Connect with developers, share solutions, and get community support
Enterprise Support
Need dedicated support, custom integrations, or enterprise-grade SLAs? Our enterprise team provides white-glove service for mission-critical implementations.
Developer Resources
"Valutoria's API transformed our development workflow. The documentation is crystal clear, the SDKs are robust, and their support team responds faster than our internal team!"
Start Building Today
Join thousands of developers who trust Valutoria API for their mission-critical applications.
API Testing & Playground
Test our API endpoints directly in your browser. No setup required - just configure, execute, and see results instantly. Perfect for prototyping and learning.
Choose Endpoint
Authentication
Parameters
Request Body
Response
{
"status": "success",
"data": {
"instances": [
{
"id": "inst_abc123",
"name": "production-odoo",
"plan": "value-plus",
"workers": 4,
"status": "running",
"uptime": "99.98%",
"created_at": "2024-01-15T10:30:00Z"
}
],
"total": 1,
"page": 1
}
}
Generated Code
const response = await fetch('https://api.valutoria.com/v1/hosting/instances?page=1&limit=10', {
method: 'GET',
headers: {
'Authorization': 'Bearer your-api-key',
'Content-Type': 'application/json'
}
});
const data = await response.json();
console.log(data);
Testing Features
Save Requests
Save your API requests for future testing and share them with your team.
Request History
Access your recent API calls and responses for debugging and reference.
Mock Responses
Test your applications with mock data before implementing real API calls.
Share Tests
Generate shareable links for your API tests to collaborate with team members.
Sandbox Environment
Test Safely with Sandbox Mode
Our sandbox environment provides realistic API responses without affecting your production data. Perfect for development, testing, and integration.
- Identical API behavior to production
- No rate limits for testing
- Realistic mock data generation
- Safe for continuous integration
Currently: Production
API Testing & Playground
Test our API endpoints directly in your browser. No setup required - just configure, execute, and see results instantly. Perfect for prototyping and learning.
Choose Endpoint
Authentication
Parameters
Request Body
Response
{
"status": "success",
"data": {
"instances": [
{
"id": "inst_abc123",
"name": "production-odoo",
"plan": "value-plus",
"workers": 4,
"status": "running",
"uptime": "99.98%",
"created_at": "2024-01-15T10:30:00Z"
}
],
"total": 1,
"page": 1
}
}
Generated Code
const response = await fetch('https://api.valutoria.com/v1/hosting/instances?page=1&limit=10', {
method: 'GET',
headers: {
'Authorization': 'Bearer your-api-key',
'Content-Type': 'application/json'
}
});
const data = await response.json();
console.log(data);
Testing Features
Save Requests
Save your API requests for future testing and share them with your team.
Request History
Access your recent API calls and responses for debugging and reference.
Mock Responses
Test your applications with mock data before implementing real API calls.
Share Tests
Generate shareable links for your API tests to collaborate with team members.
Sandbox Environment
Test Safely with Sandbox Mode
Our sandbox environment provides realistic API responses without affecting your production data. Perfect for development, testing, and integration.
- Identical API behavior to production
- No rate limits for testing
- Realistic mock data generation
- Safe for continuous integration
Currently: Production
Webhooks
Stay informed with real-time notifications. Our webhooks deliver instant updates about your infrastructure, eliminating the need for constant polling and enabling reactive workflows.
How Webhooks Work
Webhooks are HTTP callbacks that Valutoria sends to your application when specific events occur. Instead of repeatedly checking our API for updates, webhooks deliver real-time notifications directly to your servers.
Something happens in your Valutoria account
We send an HTTP POST to your endpoint
Your application processes the event
Benefits
Get notifications instantly when events occur
Eliminate the need for constant polling
Trigger actions based on specific events
More efficient than polling-based solutions
Available Events
Hosting Events
Backup Events
Alert Events
Billing Events
Webhook Payload Structure
Standard Payload Format
{
"id": "evt_1a2b3c4d5e",
"event": "instance.created",
"created": "2024-05-27T12:00:00Z",
"data": {
"id": "inst_abc123",
"name": "production-app",
"plan": "value-plus",
"workers": 4,
"status": "provisioning",
"created_at": "2024-05-27T12:00:00Z"
},
"metadata": {
"user_id": "user_xyz789",
"ip_address": "192.168.1.1",
"user_agent": "Valutoria-Dashboard/1.0"
}
}Payload Fields
id
string
Unique identifier for the webhook event
event
string
Type of event that triggered the webhook
created
timestamp
When the event occurred (ISO 8601 format)
data
object
Event-specific data payload
metadata
object
Additional context about the event
Security & Verification
Signature Verification
We sign all webhook payloads with a secret key. Verify the signature to ensure the webhook came from Valutoria.
const crypto = require('crypto');
function verifyWebhook(payload, signature, secret) {
const expectedSignature = crypto
.createHmac('sha256', secret)
.update(payload, 'utf8')
.digest('hex');
return signature === `sha256=${expectedSignature}`;
}Security Headers
Each webhook request includes security headers for verification:
X-Valutoria-Signature
HMAC-SHA256 signature of the payload
X-Valutoria-Event
Event type for quick filtering
X-Valutoria-Delivery
Unique delivery attempt ID
User-Agent
Always "Valutoria-Webhooks/1.0"
Setting Up Webhooks
Create Endpoint
Set up an HTTPS endpoint on your server to receive webhook notifications. Your endpoint must return a 200 status code to acknowledge receipt.
app.post('/webhooks/valutoria', (req, res) => {
const event = req.body;
// Process the webhook event
console.log('Received event:', event.event);
console.log('Event data:', event.data);
// Respond with 200 to acknowledge receipt
res.status(200).send('OK');
});@app.post("/webhooks/valutoria")
async def handle_webhook(request: Request):
event = await request.json()
# Process the webhook event
print(f"Received event: {event['event']}")
print(f"Event data: {event['data']}")
# Return 200 to acknowledge receipt
return {"status": "ok"}Route::post('/webhooks/valutoria', function (Request $request) {
$event = $request->all();
// Process the webhook event
Log::info('Received event: ' . $event['event']);
Log::info('Event data: ', $event['data']);
// Return 200 to acknowledge receipt
return response('OK', 200);
});Configure Webhook
Register your webhook endpoint with Valutoria using our API or dashboard. Specify which events you want to receive.
curl -X POST https://api.valutoria.com/v1/webhooks \
-H "Authorization: Bearer your-api-key" \
-H "Content-Type: application/json" \
-d '{
"url": "https://your-domain.com/webhooks/valutoria",
"events": [
"instance.created",
"instance.scaled",
"backup.completed"
]
}'Test & Monitor
Use our webhook testing tools to verify your endpoint works correctly. Monitor delivery success rates and debug any issues.
Best Practices
Do's
- Always verify webhook signatures
- Respond with 200 status code quickly
- Process webhooks asynchronously
- Implement idempotency handling
- Log webhook events for debugging
- Use HTTPS endpoints only
- Handle duplicate events gracefully
Don'ts
- Don't perform long-running operations
- Don't return non-200 status codes unnecessarily
- Don't expose sensitive data in logs
- Don't ignore signature verification
- Don't use HTTP endpoints (only HTTPS)
- Don't rely on webhook order
- Don't block the webhook thread
Webhooks
Stay informed with real-time notifications. Our webhooks deliver instant updates about your infrastructure, eliminating the need for constant polling and enabling reactive workflows.
How Webhooks Work
Webhooks are HTTP callbacks that Valutoria sends to your application when specific events occur. Instead of repeatedly checking our API for updates, webhooks deliver real-time notifications directly to your servers.
Something happens in your Valutoria account
We send an HTTP POST to your endpoint
Your application processes the event
Benefits
Get notifications instantly when events occur
Eliminate the need for constant polling
Trigger actions based on specific events
More efficient than polling-based solutions
Available Events
Hosting Events
Backup Events
Alert Events
Billing Events
Webhook Payload Structure
Standard Payload Format
{
"id": "evt_1a2b3c4d5e",
"event": "instance.created",
"created": "2024-05-27T12:00:00Z",
"data": {
"id": "inst_abc123",
"name": "production-app",
"plan": "value-plus",
"workers": 4,
"status": "provisioning",
"created_at": "2024-05-27T12:00:00Z"
},
"metadata": {
"user_id": "user_xyz789",
"ip_address": "192.168.1.1",
"user_agent": "Valutoria-Dashboard/1.0"
}
}Payload Fields
id
string
Unique identifier for the webhook event
event
string
Type of event that triggered the webhook
created
timestamp
When the event occurred (ISO 8601 format)
data
object
Event-specific data payload
metadata
object
Additional context about the event
Security & Verification
Signature Verification
We sign all webhook payloads with a secret key. Verify the signature to ensure the webhook came from Valutoria.
const crypto = require('crypto');
function verifyWebhook(payload, signature, secret) {
const expectedSignature = crypto
.createHmac('sha256', secret)
.update(payload, 'utf8')
.digest('hex');
return signature === `sha256=${expectedSignature}`;
}Security Headers
Each webhook request includes security headers for verification:
X-Valutoria-Signature
HMAC-SHA256 signature of the payload
X-Valutoria-Event
Event type for quick filtering
X-Valutoria-Delivery
Unique delivery attempt ID
User-Agent
Always "Valutoria-Webhooks/1.0"
Setting Up Webhooks
Create Endpoint
Set up an HTTPS endpoint on your server to receive webhook notifications. Your endpoint must return a 200 status code to acknowledge receipt.
app.post('/webhooks/valutoria', (req, res) => {
const event = req.body;
// Process the webhook event
console.log('Received event:', event.event);
console.log('Event data:', event.data);
// Respond with 200 to acknowledge receipt
res.status(200).send('OK');
});@app.post("/webhooks/valutoria")
async def handle_webhook(request: Request):
event = await request.json()
# Process the webhook event
print(f"Received event: {event['event']}")
print(f"Event data: {event['data']}")
# Return 200 to acknowledge receipt
return {"status": "ok"}Route::post('/webhooks/valutoria', function (Request $request) {
$event = $request->all();
// Process the webhook event
Log::info('Received event: ' . $event['event']);
Log::info('Event data: ', $event['data']);
// Return 200 to acknowledge receipt
return response('OK', 200);
});Configure Webhook
Register your webhook endpoint with Valutoria using our API or dashboard. Specify which events you want to receive.
curl -X POST https://api.valutoria.com/v1/webhooks \
-H "Authorization: Bearer your-api-key" \
-H "Content-Type: application/json" \
-d '{
"url": "https://your-domain.com/webhooks/valutoria",
"events": [
"instance.created",
"instance.scaled",
"backup.completed"
]
}'Test & Monitor
Use our webhook testing tools to verify your endpoint works correctly. Monitor delivery success rates and debug any issues.
Best Practices
Do's
- Always verify webhook signatures
- Respond with 200 status code quickly
- Process webhooks asynchronously
- Implement idempotency handling
- Log webhook events for debugging
- Use HTTPS endpoints only
- Handle duplicate events gracefully
Don'ts
- Don't perform long-running operations
- Don't return non-200 status codes unnecessarily
- Don't expose sensitive data in logs
- Don't ignore signature verification
- Don't use HTTP endpoints (only HTTPS)
- Don't rely on webhook order
- Don't block the webhook thread