Energy Machines · REST · OpenAPI 3.1.0

REST-rajapinnan kuvaus

Vain luku, JSON, HTTPS GET. Tiliä tai API-avainta ei tarvita. Jokainen osoite palauttaa samat tiedot kuin samanniminen MCP-työkalu.

https://heatpumps.energymachines.com/api/public/v1 · OpenAPI 3.1 -kuvaus

GET`/families`

List public families containing published products. Use their stable slugs in the family filter.

MCP tool: list_product_families

Parametrit

Ei muita parametreja kuin locale ja measurement_system.

Nimi	Sijainti	Tyyppi	Pakollinen
`locale` Locale code from the catalogue overview resource (Locale table). Omit for the default locale; missing translations use the site's fallback.	query	`string`	Ei
`measurement_system` MeasurementSystem code from the catalogue overview resource, e.g. metric or imperial when configured. Omit for the first configured system. Numeric filter inputs always use kW and degrees C.	query	`string`	Ei

Esimerkkipyyntö

curl 'https://heatpumps.energymachines.com/api/public/v1/families'

Vastaukset

Tila
`200`	Same JSON value as the MCP structuredContent.result.
`304`	Representation matches If-None-Match.
`400`	Invalid parameters (Zod summary in issues).
`404`	Published entity not found.
`405`	Method not allowed.
`429`	Rate limit exceeded; Retry-After gives seconds.
`500`	Catalogue temporarily unavailable.

GET`/products`

Search published products. Numeric filters use canonical kW and degrees C. Follow next_offset; confirm design-point performance with the manufacturer.

MCP tool: search_products

Parametrit

Nimi	Sijainti	Tyyppi	Pakollinen
`offset` Zero-based offset; follow next_offset until null to retrieve all results.	query	`integer (≥ 0; default 0)`	Ei
`limit` Page size, subject to the server's configurable MCP_MAX_PAGE_SIZE.	query	`integer (default 25)`	Ei
`family` Exact family slug from list_product_families.	query	`string`	Ei
`application` Exact application token from catalogue overview filter_options.	query	`string`	Ei
`use_case` Exact use_case token from catalogue overview filter_options.	query	`string`	Ei
`refrigerant` Exact refrigerant token, e.g. R290; case insensitive.	query	`string`	Ei
`compressor_type` Exact compressor_type token from catalogue overview.	query	`string`	Ei
`min_heating_capacity_kw` Minimum nominal heating capacity in canonical kW; nominal figures are not design-point guarantees.	query	`number (≥ 0)`	Ei
`max_heating_capacity_kw` Maximum nominal heating capacity in canonical kW.	query	`number (≥ 0)`	Ei
`min_supply_temp_c` Required minimum maximum condenser outlet/supply temperature, degrees C. Selects products whose upper limit is at least this value.	query	`number`	Ei
`min_source_temp_c` Lowest available source/inlet temperature at your site, degrees C. Selects products whose lowest permitted inlet is <= this value. This does not guarantee simultaneous maximum supply temperature.	query	`number`	Ei
`query` Case-insensitive free text across published names, descriptions, slugs, family names and attribute values; all words must match.	query	`string`	Ei
`locale` Locale code from the catalogue overview resource (Locale table). Omit for the default locale; missing translations use the site's fallback.	query	`string`	Ei
`measurement_system` MeasurementSystem code from the catalogue overview resource, e.g. metric or imperial when configured. Omit for the first configured system. Numeric filter inputs always use kW and degrees C.	query	`string`	Ei

Esimerkkipyyntö

curl 'https://heatpumps.energymachines.com/api/public/v1/products?limit=2'

Vastaukset

Tila
`200`	Same JSON value as the MCP structuredContent.result.
`304`	Representation matches If-None-Match.
`400`	Invalid parameters (Zod summary in issues).
`404`	Published entity not found.
`405`	Method not allowed.
`429`	Rate limit exceeded; Retry-After gives seconds.
`500`	Catalogue temporarily unavailable.

GET`/products/{slug}`

Read a published product, flexible specifications, public media and documents. Missing values are unknown, never zero.

MCP tool: get_product

Parametrit

Nimi	Sijainti	Tyyppi	Pakollinen
`slug` Stable product slug returned by search_products; not a display name.	path	`string`	Kyllä
`locale` Locale code from the catalogue overview resource (Locale table). Omit for the default locale; missing translations use the site's fallback.	query	`string`	Ei
`measurement_system` MeasurementSystem code from the catalogue overview resource, e.g. metric or imperial when configured. Omit for the first configured system. Numeric filter inputs always use kW and degrees C.	query	`string`	Ei

Esimerkkipyyntö

curl 'https://heatpumps.energymachines.com/api/public/v1/products/{slug}'

Vastaukset

Tila
`200`	Same JSON value as the MCP structuredContent.result.
`304`	Representation matches If-None-Match.
`400`	Invalid parameters (Zod summary in issues).
`404`	Published entity not found.
`405`	Method not allowed.
`429`	Rate limit exceeded; Retry-After gives seconds.
`500`	Catalogue temporarily unavailable.

GET`/products/compare`

Compare the union of specification keys across published products; missing values are null.

MCP tool: compare_products

Parametrit

Nimi	Sijainti	Tyyppi	Pakollinen
`slugs`	query	`string[]`	Kyllä
`locale` Locale code from the catalogue overview resource (Locale table). Omit for the default locale; missing translations use the site's fallback.	query	`string`	Ei
`measurement_system` MeasurementSystem code from the catalogue overview resource, e.g. metric or imperial when configured. Omit for the first configured system. Numeric filter inputs always use kW and degrees C.	query	`string`	Ei

Esimerkkipyyntö

curl 'https://heatpumps.energymachines.com/api/public/v1/products/compare?slugs={slug},{slug}'

Vastaukset

Tila
`200`	Same JSON value as the MCP structuredContent.result.
`304`	Representation matches If-None-Match.
`400`	Invalid parameters (Zod summary in issues).
`404`	Published entity not found.
`405`	Method not allowed.
`429`	Rate limit exceeded; Retry-After gives seconds.
`500`	Catalogue temporarily unavailable.

GET`/documents`

List public documents linked to published products; never the asset library or internal paths.

MCP tool: list_documents

Parametrit

Nimi	Sijainti	Tyyppi	Pakollinen
`offset` Zero-based offset; follow next_offset until null to retrieve all results.	query	`integer (≥ 0; default 0)`	Ei
`limit` Page size, subject to the server's configurable MCP_MAX_PAGE_SIZE.	query	`integer (default 25)`	Ei
`product_slug` Stable product slug returned by search_products; not a display name.	query	`string`	Ei
`doc_type`	query	`string`	Ei
`locale` Locale code from the catalogue overview resource (Locale table). Omit for the default locale; missing translations use the site's fallback.	query	`string`	Ei
`measurement_system` MeasurementSystem code from the catalogue overview resource, e.g. metric or imperial when configured. Omit for the first configured system. Numeric filter inputs always use kW and degrees C.	query	`string`	Ei

Esimerkkipyyntö

curl 'https://heatpumps.energymachines.com/api/public/v1/documents?limit=2'

Vastaukset

Tila
`200`	Same JSON value as the MCP structuredContent.result.
`304`	Representation matches If-None-Match.
`400`	Invalid parameters (Zod summary in issues).
`404`	Published entity not found.
`405`	Method not allowed.
`429`	Rate limit exceeded; Retry-After gives seconds.
`500`	Catalogue temporarily unavailable.

GET`/documents/{document_id}`

Resolve a document still linked to a published product. Does not download its contents.

MCP tool: get_document_url

Parametrit

Nimi	Sijainti	Tyyppi	Pakollinen
`document_id`	path	`string`	Kyllä
`locale` Locale code from the catalogue overview resource (Locale table). Omit for the default locale; missing translations use the site's fallback.	query	`string`	Ei
`measurement_system` MeasurementSystem code from the catalogue overview resource, e.g. metric or imperial when configured. Omit for the first configured system. Numeric filter inputs always use kW and degrees C.	query	`string`	Ei

Esimerkkipyyntö

curl 'https://heatpumps.energymachines.com/api/public/v1/documents/{document_id}'

Vastaukset

Tila
`200`	Same JSON value as the MCP structuredContent.result.
`304`	Representation matches If-None-Match.
`400`	Invalid parameters (Zod summary in issues).
`404`	Published entity not found.
`405`	Method not allowed.
`429`	Rate limit exceeded; Retry-After gives seconds.
`500`	Catalogue temporarily unavailable.

GET`/cases`

List published installation case studies with canonical URLs and public product reference text.

MCP tool: list_cases

Parametrit

Nimi	Sijainti	Tyyppi	Pakollinen
`offset` Zero-based offset; follow next_offset until null to retrieve all results.	query	`integer (≥ 0; default 0)`	Ei
`limit` Page size, subject to the server's configurable MCP_MAX_PAGE_SIZE.	query	`integer (default 25)`	Ei
`query`	query	`string`	Ei
`locale` Locale code from the catalogue overview resource (Locale table). Omit for the default locale; missing translations use the site's fallback.	query	`string`	Ei
`measurement_system` MeasurementSystem code from the catalogue overview resource, e.g. metric or imperial when configured. Omit for the first configured system. Numeric filter inputs always use kW and degrees C.	query	`string`	Ei

Esimerkkipyyntö

curl 'https://heatpumps.energymachines.com/api/public/v1/cases?limit=2'

Vastaukset

Tila
`200`	Same JSON value as the MCP structuredContent.result.
`304`	Representation matches If-None-Match.
`400`	Invalid parameters (Zod summary in issues).
`404`	Published entity not found.
`405`	Method not allowed.
`429`	Rate limit exceeded; Retry-After gives seconds.
`500`	Catalogue temporarily unavailable.

GET`/cases/{slug}`

Read a published installation case, public media and converted flexible specifications.

MCP tool: get_case

Parametrit

Nimi	Sijainti	Tyyppi	Pakollinen
`slug`	path	`string`	Kyllä
`locale` Locale code from the catalogue overview resource (Locale table). Omit for the default locale; missing translations use the site's fallback.	query	`string`	Ei
`measurement_system` MeasurementSystem code from the catalogue overview resource, e.g. metric or imperial when configured. Omit for the first configured system. Numeric filter inputs always use kW and degrees C.	query	`string`	Ei

Esimerkkipyyntö

curl 'https://heatpumps.energymachines.com/api/public/v1/cases/{slug}'

Vastaukset

Tila
`200`	Same JSON value as the MCP structuredContent.result.
`304`	Representation matches If-None-Match.
`400`	Invalid parameters (Zod summary in issues).
`404`	Published entity not found.
`405`	Method not allowed.
`429`	Rate limit exceeded; Retry-After gives seconds.
`500`	Catalogue temporarily unavailable.

GET`/company`

Read only known public company, technology, history and contact sections.

MCP tool: get_company_info

Parametrit

Ei muita parametreja kuin locale ja measurement_system.

Nimi	Sijainti	Tyyppi	Pakollinen
`locale` Locale code from the catalogue overview resource (Locale table). Omit for the default locale; missing translations use the site's fallback.	query	`string`	Ei
`measurement_system` MeasurementSystem code from the catalogue overview resource, e.g. metric or imperial when configured. Omit for the first configured system. Numeric filter inputs always use kW and degrees C.	query	`string`	Ei

Esimerkkipyyntö

curl 'https://heatpumps.energymachines.com/api/public/v1/company'

Vastaukset

Tila
`200`	Same JSON value as the MCP structuredContent.result.
`304`	Representation matches If-None-Match.
`400`	Invalid parameters (Zod summary in issues).
`404`	Published entity not found.
`405`	Method not allowed.
`429`	Rate limit exceeded; Retry-After gives seconds.
`500`	Catalogue temporarily unavailable.

GET`/inquiry`

Explain human-reviewed inquiry preparation. No drafts, email sending or submissions are performed.

MCP tool: how_to_inquire

Parametrit

Nimi	Sijainti	Tyyppi	Pakollinen
`product_slug` Stable product slug returned by search_products; not a display name.	query	`string`	Ei
`locale` Locale code from the catalogue overview resource (Locale table). Omit for the default locale; missing translations use the site's fallback.	query	`string`	Ei
`measurement_system` MeasurementSystem code from the catalogue overview resource, e.g. metric or imperial when configured. Omit for the first configured system. Numeric filter inputs always use kW and degrees C.	query	`string`	Ei

Esimerkkipyyntö

curl 'https://heatpumps.energymachines.com/api/public/v1/inquiry'

Vastaukset

Tila
`200`	Same JSON value as the MCP structuredContent.result.
`304`	Representation matches If-None-Match.
`400`	Invalid parameters (Zod summary in issues).
`404`	Published entity not found.
`405`	Method not allowed.
`429`	Rate limit exceeded; Retry-After gives seconds.
`500`	Catalogue temporarily unavailable.

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.

GET/families

Parametrit

Esimerkkipyyntö

Vastaukset

GET/products

Parametrit

Esimerkkipyyntö

Vastaukset

GET/products/{slug}

Parametrit

Esimerkkipyyntö

Vastaukset

GET/products/compare

Parametrit

Esimerkkipyyntö

Vastaukset

GET/documents

Parametrit

Esimerkkipyyntö

Vastaukset

GET/documents/{document_id}

Parametrit

Esimerkkipyyntö

Vastaukset

GET/cases

Parametrit

Esimerkkipyyntö

Vastaukset

GET/cases/{slug}

Parametrit

Esimerkkipyyntö

Vastaukset

GET/company

Parametrit

Esimerkkipyyntö

Vastaukset

GET/inquiry

Parametrit

Esimerkkipyyntö

Vastaukset

Käyttöehdot

GET`/families`

GET`/products`

GET`/products/{slug}`

GET`/products/compare`

GET`/documents`

GET`/documents/{document_id}`

GET`/cases`

GET`/cases/{slug}`

GET`/company`

GET`/inquiry`