Energy Machines · REST / MCP
Kehittäjille
Rakenna suunnittelun hakutyökaluja tämän sivuston julkaistun malliston avulla. REST ja MCP palauttavat samat tiedot. Tiliä tai API-avainta ei tarvita.
Mallisto perustuu yhteydenottoihin: ei hintoja, tilaamista tai kirjoitustoimintoja. Avustaja voi valmistella yhteydenoton ihmisen tarkistettavaksi. Lähetä se itse tuotesivun lomakkeella tai ota yhteyttä suunnittelutiimiin.
Julkinen REST-rajapinta
https://heatpumps.energymachines.com/api/public/v1
| GET | MCP tool |
|---|---|
/families | list_product_families |
/products | search_products |
/products/{slug} | get_product |
/products/compare | compare_products |
/documents | list_documents |
/documents/{document_id} | get_document_url |
/cases | list_cases |
/cases/{slug} | get_case |
/company | get_company_info |
/inquiry | how_to_inquire |
Esimerkkipyynnöt
curl 'https://heatpumps.energymachines.com/api/public/v1/products?locale=fi&measurement_system=metric&limit=2'
curl 'https://heatpumps.energymachines.com/api/public/v1/families'
curl 'https://heatpumps.energymachines.com/api/public/v1/cases?limit=2'MCP avustajille
https://heatpumps.energymachines.com/mcp · Streamable HTTP · POST · JSON · stateless
claude mcp add --transport http energy-machines https://heatpumps.energymachines.com/mcp
{
"mcpServers": {
"energyMachines": {
"url": "https://heatpumps.energymachines.com/mcp"
}
}
}Kielet, yksiköt ja suodattimet
Kaikki toiminnot hyväksyvät mallistoon määritetyt locale- ja measurement_system-koodit. Ilman niitä käytetään sivuston oletuksia. Puuttuva käännös korvataan julkisen sivun varakäännöksellä; vastauksen locale kertoo käytetyn kielen. Numeeriset hakurajat annetaan aina kilowatteina ja Celsius-asteina. Listojen offset ja limit (oletus 25) ohjaavat sivutusta; jatka next_offset-arvosta kunnes se on null. Vertailun slugs on pilkuilla erotettu lista. OpenAPI kuvaa kaikki parametrit ja vastaukset.
Pyyntörajat ja välimuisti
REST ja MCP jakavat prosessikohtaisen kiintiön: oletuksena 120 pyyntöä asiakkaalta ja yhteensä 3 000 pyyntöä 60 sekunnissa. Ylläpitäjä voi muuttaa rajoja. HTTP 429 sisältää Retry-After-odotusajan sekunteina. REST tukee ETag / If-None-Match -otsakkeita sekä julkista 60 sekunnin välimuistia (jaettu välimuisti: 300 sekuntia). MCP käyttää no-store-käytäntöä. REST sallii selaimen GET-pyynnöt kaikista alkuperistä; MCP sallii sivuston ja hyväksytyt avustajat. Vain toiminnon nimi ja tuloksen tila lasketaan anonyymeihin päiväkoosteisiin, ei argumentteja tai IP-osoitteita.
Käyttöehdot
Käytä julkisia tietoja suunnittelun esiselvitykseen ja viittaa tuotteiden ja dokumenttien kanonisiin osoitteisiin. Noudata välimuistia ja Retry-After-aikaa. Tiedot ja saatavuus voivat muuttua. Vahvista teho, lähde- ja menolämpötilat, nesteet ja samanaikaiset käyttöolosuhteet Energy Machinesilta ennen suunnittelua tai hankintaa. Palvelu ei anna suorituskykytakuuta.