Silosset API
Integrate asset management functionality directly into your applications with our comprehensive API.
API Overview
Powerful, flexible, and easy to integrate
The Silosset API provides programmatic access to the full functionality of our asset management platform. Use it to retrieve asset information, update records, manage audits, and integrate asset data with your existing systems.
Our RESTful API accepts and returns JSON, making it easy to integrate with any programming language or framework. All endpoints are versioned to ensure backwards compatibility as we continue to enhance the API.
The API follows standard HTTP conventions, with appropriate response codes, error handling, and rate limiting to ensure stability and reliability.
API Features
- RESTful endpoints for all core Silosset functionality
- JSON request and response format
- API key authentication with organization-level access control
- Detailed error responses with actionable information
- Comprehensive Swagger documentation
Interactive Documentation
Explore our comprehensive API documentation with interactive endpoints, request examples, and response schemas.
Authentication
Secure access to the API
API Keys
The Silosset API uses API keys for authentication. Each API key is associated with a specific organization and has access to that organization's data only. To use the API, you must include your API key in the X-API-Key header with every request.
How to Request an API Key
- Log in to your Silosset account as an administrator
- Navigate to "Settings" > "API Access"
- Click "Generate New API Key"
- Provide a description for the key (e.g., "Integration with ERP System")
- Copy and securely store your API key - it will only be shown once
Important: Keep your API key secure and never share it publicly. If you believe your key has been compromised, revoke it immediately and generate a new one.
Authentication Examples
curl -X 'GET' \ 'https://api.silosset.com/api/v1/organisations/org_id/assets/asset_id' \ -H 'accept: application/json' \ -H 'X-API-Key: your_api_key'
import requests
url = "https://api.silosset.com/api/v1/organisations/org_id/assets/asset_id"
headers = {
"accept": "application/json",
"X-API-Key": "your_api_key"
}
response = requests.get(url, headers=headers)
print(response.json())fetch('https://api.silosset.com/api/v1/organisations/org_id/assets/asset_id', {
method: 'GET',
headers: {
'accept': 'application/json',
'X-API-Key': 'your_api_key'
}
})
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error('Error:', error));Rate Limiting & Security
Ensuring API stability and data protection
Rate Limiting
To ensure fair usage and system stability, the Silosset API implements rate limiting. Each API key is allowed a maximum of of specified requests per time period. Please refer to your subscription plan for specific limits.
Rate limit information is included in the response headers. If you exceed the rate limit, you'll receive a 429 Too Many Requests response.
Security Measures
- HTTPS Encryption
All API requests must use HTTPS to ensure data is encrypted in transit.
- Organization Isolation
API keys can only access data within their associated organization.
- API Key Management
Keys can be revoked at any time, and administrators can view usage logs.
- Audit Logging
All API actions are logged for security and compliance purposes.