Mycond · fan coil selection
The same engine the selection program runs in your browser, called over HTTP. Give it your water, air and room — get capacities, water flow and pressure drop, condensate, sound and valve data for every article that fits.
Open and free, no key. Requests are rate-limited per IP: 30 points a minute — a narrow query costs 1 point, a query across more than three series costs 4. Responses are JSON; field names are exactly the ones the program itself uses.
Runs the catalogue against your conditions and returns the models that cover the load, best first. series is required — pass one id, a list, or "all" for the whole catalogue (that one is the slow, expensive call).
curl -X POST https://select.mycond.eu/api/v1/select \
-H "content-type: application/json" \
-d '{
"series": "mcfc",
"cooling": { "airInC": 26, "airInRh": 50, "waterInC": 7, "waterOutC": 12, "sensibleKw": 2.0 },
"heating": { "airInC": 20, "waterInC": 45, "waterOutC": 40, "capacityKw": 1.2 },
"pressurePa": 30,
"limit": 5
}'
| Field | Meaning |
|---|---|
series | series id, list of ids, or "all" — mcfc, hpl, dfcl, mcfds, secf, tl, mcfk-a2, silent, mcff, fhw, mhw-q, silver-glass, silver-glass-low, silver-glass-wall |
cooling | airInC, airInRh, waterInC, and either waterOutC or waterFlowLh; the duty to cover is sensibleKw (or totalKw) |
heating | airInC, waterInC, waterOutC or waterFlowLh, duty capacityKw |
pressurePa | external static pressure for ducted and universal units; ignored for the rest |
glycol | ethylene or propylene with glycolPercent (mass %) |
pipes, motor | 2T/4T, AC/EC |
maxSoundDbA | sound pressure ceiling, dB(A) |
speeds | wired (default), all, min, med, max |
room | volumeM3 and reverberationS — the room the sound pressure is computed for |
branchKpa | resistance of the rest of the branch, for valve authority |
limit | how many candidates to return, 1…500 (default 50) |
One article at those same conditions: every speed (every voltage step on EC), the psychrometric point, the fan curve, the octave spectrum, dimensions and the valve data. The body is the same as for select; duty fields are not needed.
curl -X POST https://select.mycond.eu/api/v1/units/MCFC-068-AT2 \
-H "content-type: application/json" \
-d '{ "cooling": { "waterInC": 7, "waterOutC": 12 }, "pressurePa": 30 }'
What exists at all: articles, series, pipes, motor, rows, dimensions and the catalogue speeds. No calculation, cacheable for an hour.
curl https://select.mycond.eu/api/v1/catalog
Hands the work back to a human: saves the project and returns a link that opens the program already filled in — conditions, chosen articles, rooms and tags — plus the project file (.mycond) to keep. Useful when a script or an assistant did the arithmetic and a person now wants to look at it, change a speed, print the report. The link lives 30 days, and the same project always yields the same link.
curl -X POST https://select.mycond.eu/api/v1/task -H "content-type: application/json" -d '{
"language": "uk",
"name": "Office floor 3",
"positions": [
{ "sku": "MCFC-051-AT2", "speed": "MED", "coolKw": 2.2, "heatKw": 2,
"room": "Office 201", "tag": "FC-1" }
]
}'
# -> { "url": "...pidbir/app/uk?task=127fca20ee39", "file": "....mycond", "expires_days": 30 }
| Field | Meaning |
|---|---|
positions[] | as in report: sku and optionally speed, qty, room, tag, coolKw, heatKw, pressurePa |
project | instead of the above: the project file the program saves, as is |
language | uk, en or pl — the language the program opens in |
Builds the technical report and returns a link to it — the same document the program makes: cover, project schedule, a sheet per position with drawings and charts, the all-speeds table and the calculation method. Open the link in a browser and print to PDF, or add ?download=1 to save the file. The link lives 24 hours.
curl -X POST https://select.mycond.eu/api/v1/report -H "content-type: application/json" -d '{
"locale": "en",
"name": "Office floor 3",
"waterHeat": { "inC": 45, "outC": 40 },
"positions": [
{ "sku": "MCFC-102-DT2", "speed": "MED 6.5 V", "coolKw": 3, "heatKw": 2,
"room": "Office 201", "tag": "FC-1", "qty": 2, "pressurePa": 30 }
]
}'
# → { "url": "…/api/v1/report/6112bee51dc7", "download": "…?download=1", "title": "Office floor 3", … }
| Field | Meaning |
|---|---|
positions[] | sku and optionally speed, qty, room, tag, coolKw, heatKw, pressurePa, roomVolumeM3 |
name, customer, object, author | what goes on the cover |
waterCool, waterHeat | { "inC": 7, "outC": 12 } — the project's water, default 7/12 and 45/40 |
glycol, glycolPercent | as in select |
locale | uk, en or pl — the language of the document, drawings included |
project | instead of all the above: the project file the program saves, as is |
inline | true returns the HTML in the response instead of a link |
The report is one self-contained HTML file (about 130 kB) with the stylesheet inside; photos and drawing backgrounds load from this site, so it needs the network to look complete. Rendering takes under a second.
None needed: everything above is open. A Mycond dealer can still issue a key in the
dealer cabinet and send it as
Authorization: Bearer mck_... or X-Api-Key. A key does two things: it raises the limit to
120 points a minute on a budget of its own instead of the one shared by your address, and it collects
what you calculate into “My selections” in the cabinet — every link and report waits there for 30 days.
What a key does not open is prices and orders. Those are commercial terms rather than physics, so they stay behind the cabinet sign-in. Everyone, with a key or without, gets the same engineering numbers.
Always { "error": { "code", "message" } }. 400 for a bad field (the message names it), 404 for an unknown article, 429 when the rate limit is hit (see retry-after), 504 if a calculation runs over 20 seconds.
Capacity is recalculated for your conditions, not taken from the catalogue table: manufacturers print 7/12 and 45/40, and a real site rarely matches. Cooling comes with both totalKw and sensibleKw — selection goes by the sensible one, because that is what covers the room's heat gain. Sound pressure depends on the room, so pass room if you care about dB(A) rather than sound power.
Same engine, same data file and same field names as the program at select.mycond.eu/pidbir — a result from the API and a result on screen cannot disagree.