HARMONY API

The HARMONY API allows users to retrieve information about musical compositions and supports various endpoints for querying compositions based on different criteria.

Endpoints:

1. Random Composition:

   • Endpoint: /random
   • Description: Retrieve information about a random musical composition from the database.

2. Get Compositions by Composer:

   • Endpoint: /composer/{composer}
   • Description: Retrieve compositions by a specific composer.

3. Get Compositions by Instrumentation:

   • Endpoint: /instrumentation/{instrumentation}
   • Description: Retrieve compositions based on a specific instrumentation.

4. Get Compositions by Style:

   • Endpoint: /style/{style}
   • Description: Retrieve compositions based on a specific musical style.

5. Get Compositions by Key:

   • Endpoint: /key/{key}
   • Description: Retrieve compositions based on a specific musical key.

6. Get Compositions by Work Title:

   • Endpoint: /title/{title}
   • Description: Retrieve compositions based on a specific work title.

7. Search Compositions:

8. • Endpoint: /search
   • Description: Perform a flexible search for compositions using multiple criteria, such as composer, instrumentation, style, key, and work title.

Usage:

• All endpoints support case-insensitive parameter values.
• The API enforces validation for input parameters, responding with appropriate error messages for invalid requests.

Example Usage:

• To get a random composition: GET /random
• To search for compositions by a specific composer: GET /composer/Beethoven

Error Handling:

• The API provides clear error messages for invalid requests, missing parameters, and internal server errors.

This HARMONY API is designed to offer flexibility in querying musical compositions, providing users with detailed information based on different criteria.