The material determines the characteristics of the manufactured parts. Apart from physical properties, the material may be extended by process specific properties, e.g. design limits or processing rates.
Request Material by ID (GET)
Get material information.
Return Data
{
"mat_id": "6ba40dc05533401caa9f47f014efd1f8",
"owner_username": "arnd",
"restriction": null,
"mat_name": "316L",
"oem_name": "ACME",
"tech": "additive_manufacturing",
"prc_acronym": "fdm",
"raw_mat_cost": 200,
"mat_rho": 7.8,
"properties_am": {
"sup_phi": 0,
"c_wst": 0.5,
"min_ang": 0,
"lyr_h": 0.025,
"bld_spd_fill": 1000000,
"t_lim_min": 0.1,
"t_lim_max": 30,
"gap_lim_min": 0.3,
"size_lim_min": null,
"size_lim_max": null,
"scaling_factors": {
"x": 1.2,
"y": 1.2,
"z": 1.24
}
},
"properties_milling": {
"milling_rate_roughing": 900,
"milling_rate_finishing": 2700
},
"default_machine_name": "Prusa i3"
}
Parameter | Description | Type | Unit | Example |
mat_id | Material UUID | string | – | “535ca86f28d94dc786adf32387b0c658” |
owner_username | Username of machine owner | string, null | – | “arnd” |
restriction | Restriction level | string, null | – | “owner” |
mat_name | Material name | string | – | “PLA” |
oem_name | Brand or manufacturer name | string | – | “Generic” |
tech | Technology | string | – | “additive_manufacturing” |
prc_acronym | Process acronym | string | – | “fdm” |
raw_mat_cost | Raw material cost (powder, filament, resin, solid block…) | float | € | 20.92 |
mat_rho | Material density | float | g/cm³ | 1.24 |
mat_lvl_2_name | Material Type | string, null | – | “Polyester” |
mat_lvl_3_name | Material Group | string, null | – | “Thermoplastic” |
mat_lvl_4_name | Material Category | string, null | – | “Polymer” |
parent_material | Next known parent (Level 2-4) | string, null | – | “Polyester” |
default_machine_name | Name of machine used by default | string | – | “RepRap Prusa i2” |
Properties Additive Manufacturing (properties_am)
Note: All of the following properties may be null and auto-completed from the related process or similar materials.
Parameter | Description | Type | Unit | Example |
sup_phi | Relative density if support structures. | float, null | – | 0.2 |
c_wst | Ratio of built material, that cannot be recycled. | float, null | – | 0.1 |
min_ang | Minimal printable supportless overhang angle (horizontal-to-surface angle). | float, null | deg | 45 |
lyr_h | Layer height. | float, null | mm | 0.25 |
bld_spd_fill | Volumetric built rate. | float, null | cm³/h | 120 |
t_lim_min | Minimal printable wall thickness. | float, null | mm | 0.4 |
t_lim_max | Maximum printable wall thickness. | float, null | mm | 50 |
gap_lim_min | Minimal printable gap size. | float, null | mm | 0.01 |
size_lim_min | Minimal general part size. | float, null | mm | 2.5 |
size_lim_max | Maximum general part size. | float, null | mm | 120 |
scaling_factors | Scaling factors to respect process and sintering shrinkage. | list<float>, null | – | [1.1, 1.1, 1.2] |
Properties Milling (properties_milling)
Parameter | Description | Type | Unit | Example |
milling_rate_roughing | Volumetric roughing rate | float, null | cm³/h | 900 |
milling_rate_finishing | Surface finishing rate | float, null | cm²/h | 2700 |
Note: All of the following properties may be null and auto-completed from the related process or similar materials.
Usage
# GET "https://platform.3dspark.de/api/v1/material/<mat_id>/"
this.axiosInstance
.get("/api/v1/material/535ca86f28d94dc786adf32387b0c658/")
.then((response) => {
console.log(response.data);
})
Create Material (POST)
Create material and related properties.
Form Data
Parameter | Description | Required | Type | Unit | Valid Values | Default |
restriction | Access level of this material. | false | string | – | “owner”, “organization”, null | “owner” |
mat_name | Display name | true | string | – | 1 – 250 characters | – |
oem_name | Brand or manufacturer name | true | string | – | 1 – 250 characters | – |
tech | Technology | true | string | – | “additive_manufacturing”, “milling”, “casting”, “injection_molding” | “additive_manufacturing” |
prc_acronym | Acronym of associated process type | true | string | – | “fdm”, “sla”, “dlp”, “dls”, “sls”, “mjf”, “pjm”, “dod”, “bj”, “slm”, “ebm”, “lmm”, “waam” | – |
raw_mat_cost | Raw material cost | true | float | €/kg | 0 – 100000 | – |
mat_rho | Material density | true | float | g/cm³ | 0.1 – 20 | – |
mac_id | Default machine id | false | string | – | 32 character uuid | Process default machine |
mat_lvl_2_id | Material group ID. If set, levels 3 and 4 are set automatically. | false | string | – | 32 character uuid | null |
mat_lvl_3_id | Material type ID. If set, level 4 is set automatically. | false | string | – | 32 character uuid | null |
mat_lvl_4_id | Material family ID. Defaults to polymer or metal, depending on density. | false | string | – | 32 character uuid | Polymer or metal |
Properties Additive Manufacturing
Parameter | Description | Required | Type | Unit | Valid Values | Default |
sup_phi | Relative density if support structures. | false | float | – | 0 – 1.0 | process default |
c_wst | Ratio of built material, that cannot be recycled. | false | float | – | 0 – 1.0 | process default |
min_ang | Minimal printable supportless overhang angle (horizontal-to-surface angle). | false | float | deg | 0 – 90 | process default |
lyr_h | Layer height. | false | float | mm | 0.001 – 100000 | process default |
bld_spd_fill | Volumetric built rate. | false | float | cm³/h | 0.001 – 100000 | process default |
t_lim_min | Minimal printable wall thickness. | false | float | mm | 0.001 – 100000 | process default |
t_lim_max | Maximum printable wall thickness. | false | float | mm | 0.001 – 100000 | process default |
gap_lim_min | Minimal printable gap size. | false | float | mm | 0.001 – 100000 | process default |
size_lim_min | Minimal printable gap size. | false | float | mm | 0.001 – 100000 | process default |
size_lim_max | Maximum general part size. | false | float | mm | 0.001 – 100000 | process default |
scaling_factors | Scaling factors to respect process and sintering shrinkage. | false | list<float> | – | 1.0 – 100000 | process default |
Properties MiIlling
Parameter | Description | Required | Type | Unit | Valid Values | Default |
milling_rate_roughing | Milling rate for roughing | false | float | cm³/h | 0.1 – 100000 | mat_lvl_4 rate |
milling_rate_finishing | Milling rate for surface finishing | false | float | cm²/h | 0.1 – 100000 | mat_lvl_4 rate |
Return Data
See ‘Request Material by ID (GET)’
Usage
# POST "https://platform.3dspark.de/api/v1/material/<mat_id>/"
let formData = {
"tech": "additive_manufacturing",
"mat_name": "Arnd PLA",
"oem_name": "Polymaker",
"prc_acronym": "fdm",
"raw_mat_cost": 20.50,
"mat_rho": 1.02,
// "restriction": 'owner',
// "mac_id": '8198096ca74d47db90f1ca42c6e186af',
// "mat_lvl_2_id": '4bb5ef156a9f4fa6b1fdae03bbc0bce4', // Stainless steel
// "mat_lvl_3_id": '2e22afb155a343d5972edaf83c73237e', // Steel
// "mat_lvl_4_id": '287691973c9c42efaaab13fb8a64b283', // Metal
// "properties_am": {
// "sup_phi": 0,
// "c_wst": 0.5,
// "min_ang": 0,
// "lyr_h": 0.025,
// "bld_spd_fill": 100,
// "t_lim_min": 0.1,
// "t_lim_max": 30,
// "gap_lim_min": 0.3,
// "size_lim_min": 10,
// "size_lim_max": 200,
// "scaling_factors": [1.2, 1.2, 1.24]
// },
// "properties_milling": {
// "milling_rate_roughing": 10,
// "milling_rate_finishing": 20,
// }
}
this.axiosInstance
.post("/api/v1/material/6ba40dc05533401caa9f47f014efd1f7/", formData)
.then((response) => {
console.log(response.data);
})
Edit Material (PUT)
Edit material and related properties.
Form Data
At least one valid parameter. See ‘Create Material (POST)’
Return Data
See ‘Request Material by ID (GET)’
Usage
# PUT "https://platform.3dspark.de/api/v1/material/<mat_id>/"
let formData = {
"tech": "additive_manufacturing",
"mat_name": "Arnd PLA",
"oem_name": "Polymakerer",
"prc_acronym": "fdm",
"raw_mat_cost": 66.66,
"mat_rho": 1.03,
"restriction": 'owner',
"mac_id": '8585687bac9a4b8c8cb79b8af307095e',
"mat_lvl_2_id": '4bb5ef156a9f4fa6b1fdae03bbc0bce4', // Stainless steel
"mat_lvl_3_id": '6e602c19007a494996ede8b9549470e3', // Steel
"mat_lvl_4_id": '287691973c9c42efaaab13fb8a64b283', // Metal
"properties_am": {
"sup_phi": 0,
"c_wst": 0.5,
"min_ang": 0,
"lyr_h": 0.025,
"bld_spd_fill": 100,
"t_lim_min": 0.1,
"t_lim_max": 30,
"gap_lim_min": 0.3,
"size_lim_min": 10,
"size_lim_max": 200,
"scaling_factors": [1.3, 1.2, 1.24]
},
"properties_milling": {
"milling_rate_roughing": 10,
"milling_rate_finishing": 20,
}
}
this.axiosInstance
.put("/api/v1/material/535ca86f28d94dc786adf32387b0c658/", formData)
.then((response) => {
console.log(response.data);
})
Delete Material (DELETE)
Delete material and related properties.
Return Data
Success notification.
Usage
// DELETE "https://platform.3dspark.de/api/v1/material/<mat_id>/"
this.axiosInstance
.delete("/api/v1/material/535ca86f28d94dc786adf32387b0c658/")
.then((response) => {
console.log(response.data);
})