Base URL
All API endpoints are relative to your server’s base URL:Authentication
This API does not currently require authentication. All endpoints are publicly accessible.Response Format
All API responses are returned in JSON format with appropriate HTTP status codes.Success Response
Successful requests return a200 OK status code with the requested data:
Error Response
Errors return appropriate HTTP status codes with error details:Common Status Codes
Request successful, data returned
Invalid request parameters or validation error (ArgumentException)
Requested resource not found
Operation conflict, such as unable to find or create an exchange rate (InvalidOperationException)
Server error occurred during request processing
Error Handling
The API validates all input data and returns detailed error messages. Common validation errors include:- Empty or null values: Required fields cannot be empty
- Invalid length: String fields must meet minimum and maximum length requirements
- Invalid characters: Fields must match allowed character patterns
- Invalid currency codes: Currency codes must exist in the system
Validation Rules
Currency Fields:Code: 3-5 uppercase letters (A-Z)FullName: 3-60 characters (letters, spaces, parentheses)Sign: 1-3 characters (no whitespace or newlines)Rate: Must be a valid float value
- 1-24 characters
- Allowed: letters, spaces, parentheses
Rate Limiting
There are currently no rate limits on API requests.API Endpoints
The API is organized into three main sections:- Currencies - Manage currency definitions
- Exchange Rates - Manage exchange rates between currencies
- Exchange - Convert amounts between currencies