Argentatura

Una massa o un'area nulle, negative o non numeriche falliscono con invalid_input e non vengono addebitate.

Da dove nasce lo spessore dell'argentatura da massa, area e densità

Invii una massa strettamente positiva nel campo mass, con gli alias silver_mass, m e weight accettati. Invii un'area argentata strettamente positiva nel campo area, con gli alias plated_area, surface_area e a accettati. Invii una densità strettamente positiva nel campo density, con gli alias rho, silver_density e density_g_cm3 accettati. Il mass_unit facoltativo vale grammi per impostazione predefinita e accetta anche milligrammi, chilogrammi e once avoirdupois. Il area_unit facoltativo vale centimetri quadrati per impostazione predefinita e accetta anche millimetri quadrati, metri quadrati e pollici quadrati. Ingressi identici producono sempre lo stesso JSON: una divisione più ponti di unità esatti, senza rete, seme casuale né orologio a muro.

Contratto di ingresso, campi di spessore convertiti ed errori

Esempio: 10.49 grammi d'argento su 100 centimetri quadrati a 10.49 grammi per centimetro cubo sono un centimetro cubo di metallo e un rivestimento di 100 micrometri, circa 3.937 millesimi. Una mezza massa su un quarto di quell'area alla stessa densità raddoppia lo spessore a 200 micrometri. Una densità nulla o negativa fallisce allo stesso modo, perché il volume è la massa sulla densità. Questo estremo non cerca una lega per nome, non stima corrente né tempo e non corregge porosità né accumulo sugli spigoli: riporta lo spessore medio dell'argento che Lei ha davvero pesato, distribuito sull'area che Lei ha davvero misurato. Invii con POST un corpo JSON con tre numeri finiti positivi obbligatori: mass, l'argento depositato; area, la superficie argentata; e density, la densità dell'argento in grammi per centimetro cubo. Ciascuno di quei campi può arrivare come numero JSON o come stringa numerica. Il mass_unit facoltativo è uno di g, mg, kg o oz e vale g per impostazione predefinita. Il area_unit facoltativo è uno di cm2, mm2, m2 o in2 e vale cm2 per impostazione predefinita. In caso di successo la risposta restituisce mass, area, density, mass_unit e area_unit dopo un arrotondamento stabile a dodici decimali, più i valori di lavoro normalizzati mass_g, area_cm2 e density_g_cm3, e il volume implicito del deposito volume_cm3. Il risultato principale è thickness, il rivestimento uniforme in micrometri, con thickness_unit sempre il token um. I campi paralleli thickness_um, thickness_mm, thickness_cm, thickness_mil e thickness_in riportano lo stesso spessore fisico così un bollettino europeo in micrometri e una specifica statunitense in mil possono condividere una sola chiamata. formula è sempre la stringa thickness equals mass divided by area times density, e method è sempre mass_over_area_density affinché i client ramifichino su un token stabile. Campi obbligatori assenti, valori non finiti e qualsiasi massa o area che non sia un numero strettamente positivo falliscono con invalid_input e non vengono addebitati.

Dove un calcolatore di argentatura merita il suo posto

Usi l'API prepagata quando un preventivatore, un terminale di linea di bagno, un'applicazione di ricevimento o una scheda di catalogo necessitano di un contratto stabile addebitato a $0.002 per elemento riuscito; i fallimenti di convalida non consumano mai il saldo. Non invii una massa nulla, un'area nulla né un'unità fuori dalle enumerazioni pubblicate: quelle richieste falliscono con invalid_input invece di inventare un rivestimento.