{"openapi":"3.1.0","info":{"title":"Rectifier Ripple API","version":"1.0.0","description":"Rectifier ripple and smoothing-capacitor maths as an API, computed locally and deterministically. The ripple endpoint computes the peak-to-peak ripple voltage left on a reservoir (smoothing) capacitor after a rectifier, Vr = I_load/(f_ripple·C), where the ripple frequency is the line frequency for a half-wave rectifier and twice it for a full-wave or bridge rectifier — and it solves for whichever of the load current, the capacitance or the ripple you leave out, also giving the RMS ripple. The capacitor endpoint sizes the smoothing capacitor for a target ripple, C = I_load/(f_ripple·Vr), and the energy it stores. The output endpoint gives the DC output of the rectifier from the transformer RMS voltage: the peak Vrms·√2, minus the diode drops in the conduction path (one for half-wave and centre-tapped, two for a bridge), the average DC voltage and, given the ripple, the ripple factor. Everything is computed locally and deterministically, so it is instant and private. Ideal for power-supply and electronics-design tools, linear PSU, charger and audio-amplifier design, and electronics education. Pure local computation — no key, no third-party service, instant. Live, nothing stored. 3 endpoints. This is rectifier ripple and filtering; for Ohm's law, reactance and RC time constants use an Ohm's-law API.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/rectifier-api","description":"oanor gateway"}],"tags":[{"name":"Rectifier"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/capacitor":{"get":{"operationId":"get_v1_capacitor","tags":["Rectifier"],"summary":"Smoothing-capacitor sizing","description":"","parameters":[{"name":"type","in":"query","required":false,"description":"half | full | bridge (default full)","schema":{"type":"string"},"example":"full"},{"name":"line_frequency","in":"query","required":false,"description":"Mains frequency (Hz, default 50)","schema":{"type":"string"},"example":"50"},{"name":"load_current","in":"query","required":true,"description":"Load current (A)","schema":{"type":"string"},"example":"1"},{"name":"target_ripple","in":"query","required":true,"description":"Target ripple voltage (V)","schema":{"type":"string"},"example":"1"},{"name":"voltage","in":"query","required":false,"description":"DC voltage for stored energy","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"formula":"C = I/(f_ripple·Vr).","rectifier":"full-wave (centre-tapped)","load_current_a":1,"target_ripple_v":1,"line_frequency_hz":50,"ripple_frequency_hz":100,"required_capacitance_f":0.01,"required_capacitance_uf":10000},"meta":{"timestamp":"2026-06-04T10:18:38.965Z","request_id":"c2ecb1a5-e53c-451b-8a5b-8301f8167d93"},"status":"ok","message":"Smoothing-capacitor sizing","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/output":{"get":{"operationId":"get_v1_output","tags":["Rectifier"],"summary":"DC output & ripple factor","description":"","parameters":[{"name":"type","in":"query","required":false,"description":"half | full | bridge (default full)","schema":{"type":"string"},"example":"bridge"},{"name":"rms_voltage","in":"query","required":true,"description":"Transformer RMS voltage (V)","schema":{"type":"string"},"example":"12"},{"name":"diode_drop","in":"query","required":false,"description":"Diode forward drop (V, default 0.7)","schema":{"type":"string"},"example":"0.7"},{"name":"ripple_voltage","in":"query","required":false,"description":"Ripple voltage (V) for ripple factor","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"formula":"Vpeak = Vrms·√2; Vdc ≈ Vpeak − n_diodes·Vdrop − Vr/2.","rectifier":"bridge (full-wave)","diode_drop_v":0.7,"rms_voltage_v":12,"diodes_in_path":2,"peak_voltage_v":16.970563,"dc_output_voltage_v":15.570563,"peak_output_voltage_v":15.570563},"meta":{"timestamp":"2026-06-04T10:18:39.070Z","request_id":"6a03bafa-b8a8-4794-bf93-443ee1e7d283"},"status":"ok","message":"DC output & ripple factor","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/ripple":{"get":{"operationId":"get_v1_ripple","tags":["Rectifier"],"summary":"Ripple voltage","description":"","parameters":[{"name":"type","in":"query","required":false,"description":"half | full | bridge (default full)","schema":{"type":"string"},"example":"full"},{"name":"line_frequency","in":"query","required":false,"description":"Mains frequency (Hz, default 50)","schema":{"type":"string"},"example":"50"},{"name":"load_current","in":"query","required":false,"description":"Load current (A)","schema":{"type":"string"},"example":"1"},{"name":"capacitance_uf","in":"query","required":false,"description":"Capacitance (µF)","schema":{"type":"string"},"example":"4700"},{"name":"ripple_voltage","in":"query","required":false,"description":"Or ripple voltage (V) to solve another","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"formula":"Vr = I/(f_ripple·C); f_ripple = (1 half-wave, 2 full-wave)·f_line.","rectifier":"full-wave (centre-tapped)","capacitance_f":0.0047,"capacitance_uf":4700,"load_current_a":1,"ripple_voltage_v":2.12765957,"line_frequency_hz":50,"ripple_frequency_hz":100,"ripple_voltage_rms_v":0.61420241},"meta":{"timestamp":"2026-06-04T10:18:39.173Z","request_id":"ddb83fea-7916-4bf3-bfab-dddcea0f44ed"},"status":"ok","message":"Ripple voltage","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Spec","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"api":"rectifier","note":"Rectifier ripple & smoothing-capacitor maths — computed locally and deterministically, no key, no third-party service.","endpoints":["/v1/ripple","/v1/capacitor","/v1/output","/v1/meta"],"rectifier_types":["half","full","bridge"]},"meta":{"timestamp":"2026-06-04T10:18:39.275Z","request_id":"8de31f68-9757-49fd-af14-c3f2a8c1a1a5"},"status":"ok","message":"Meta","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":2000,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":900,"monthly_call_quota":25000,"rps_limit":5,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":2400,"monthly_call_quota":150000,"rps_limit":15,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":7400,"monthly_call_quota":793000,"rps_limit":40,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/rectifier-api"}