Mycond

Mycond · fan coil selection

HTTP API

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.

POST /api/v1/select

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
  }'
FieldMeaning
seriesseries 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
coolingairInC, airInRh, waterInC, and either waterOutC or waterFlowLh; the duty to cover is sensibleKw (or totalKw)
heatingairInC, waterInC, waterOutC or waterFlowLh, duty capacityKw
pressurePaexternal static pressure for ducted and universal units; ignored for the rest
glycolethylene or propylene with glycolPercent (mass %)
pipes, motor2T/4T, AC/EC
maxSoundDbAsound pressure ceiling, dB(A)
speedswired (default), all, min, med, max
roomvolumeM3 and reverberationS — the room the sound pressure is computed for
branchKparesistance of the rest of the branch, for valve authority
limithow many candidates to return, 1…500 (default 50)

POST /api/v1/units/{sku}

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 }'

GET /api/v1/catalog

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

POST /api/v1/task

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 }
FieldMeaning
positions[]as in report: sku and optionally speed, qty, room, tag, coolKw, heatKw, pressurePa
projectinstead of the above: the project file the program saves, as is
languageuk, en or pl — the language the program opens in

POST /api/v1/report

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", … }
FieldMeaning
positions[]sku and optionally speed, qty, room, tag, coolKw, heatKw, pressurePa, roomVolumeM3
name, customer, object, authorwhat goes on the cover
waterCool, waterHeat{ "inC": 7, "outC": 12 } — the project's water, default 7/12 and 45/40
glycol, glycolPercentas in select
localeuk, en or pl — the language of the document, drawings included
projectinstead of all the above: the project file the program saves, as is
inlinetrue 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.

Keys

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.

Errors

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.

What the numbers mean

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.