Technical Integration Guide

Nucleus Product Information API

High-performance access to product metadata, structured descriptions, and secure Azure-hosted documentation assets. Version 2 introduces the ProductionDetails entity for optimized delivery of product descriptions and instruction manuals.

Base URL https://nucleus.smdtechnologies.com
Developer
Badimu Kazadi
Company
Prima Metrics
Version
2.1 — 23 April 2026
Stakeholders
Ari Guinsberg, Zane Van Der Schyff, Ryan Piaray
Security & Authentication Required

All requests require two credentials passed as request headers — a Bearer token for API access and a SAS key for Azure Blob Storage asset retrieval.

⚠ Keep credentials private. Never expose your Bearer token or SAS key in client-side code, public repositories, or logs. The SAS key grants direct read access to Azure Blob Storage until its expiry date.
Required Headers
HeaderTypeValue / Format
Authorization Bearer Token Bearer DMGz***************************
x-sas-token (or per implementation) SAS Key URL-encoded SAS token string. Used to construct authenticated links to Azure Blob Storage manuals. Expires 2027-04-23.
SAS Token Details
sp=rl &st=2026-04-23T11:46:24Z &se=2027-04-23T20:01:24Z &spr=https &sv=2025-11-05 &sr=c &sig=vdAC8ET74DhZM4yDAafxcdEy7fTLQkMbaJ471jCLHXo%3D
Data Models

Version 2 introduces the ProductionDetails entity, which wraps product description text and a secure link to its associated instruction manual.

ProductionDetails Response DTO
PropertyTypeDescription
productDetails string Full product description text. Defaults to an empty string if not available.
instructionManualLink string Fully constructed Azure Blob Storage URL including the SAS token, ready for direct access. Defaults to an empty string if no manual exists.
// C# definition public class ProductionDetails { public string ProductDetails { get; set; } = string.Empty; public string InstructionManualLink { get; set; } = string.Empty; }
Endpoints

The Nucleus API exposes a single product information endpoint. Product records are resolved with priority given to numeric IDs, falling back to SKU codes.

GET /api/get-product-information Fetch product info by ID or SKU ▾
Overview
Request
Response

Returns a ProductionDetails object containing the product description and a fully authenticated link to the product's instruction manual hosted on Azure Blob Storage. The backend resolves product records by numeric ID first, falling back to SKU if no ID is supplied.

Query Parameters
ParameterTypeRequiredDescription
id integer optional* Numeric product ID. Takes priority over sku when both are supplied.
sku string optional* Product SKU code. Used as fallback when id is not provided.

* At least one of id or sku must be provided.

Required Headers
HeaderValue
Authorization Bearer DMGzmLqfuHa4hdgPntxNEX93pYc8sB
Response Codes
200Returns a ProductionDetails object with productDetails and instructionManualLink.
400Neither id nor sku was provided, or the parameters are invalid.
404No product record found for the supplied ID or SKU.
By Numeric ID
curl -X GET "https://nucleus.smdtechnologies.com/api/get-product-information?id=1042" \ -H "Authorization: Bearer DMGzmLqfuHa4hdgPntxNEX93pYc8sB"
By SKU
curl -X GET "https://nucleus.smdtechnologies.com/api/get-product-information?sku=ENDER-2PRO" \ -H "Authorization: Bearer DMGzmLqfuHa4hdgPntxNEX93pYc8sB"
Success Response (200)
{ "productDetails": "High-precision desktop 3D printer with auto-levelling and silent stepper drivers...", "instructionManualLink": "https://primametrics.blob.core.windows.net/manuals/ENDER-2PRO.pdf?sp=rl&st=2026-04-23T11:46:24Z&se=2027-04-23T20:01:24Z&spr=https&sv=2025-11-05&sr=c&sig=vdAC8ET74DhZM4yDAafxcdEy7fTLQkMbaJ471jCLHXo%3D" }
No Manual Available (200)
{ "productDetails": "Product description text here...", "instructionManualLink": "" }
SAS URI Construction

Instruction manuals are hosted on Azure Blob Storage. The API returns a fully constructed URI — but this section explains how the link is assembled, which is useful if you need to verify or reconstruct it.

1
Start with the blob base path
The raw file URL without any auth parameters.
https://primametrics.blob.core.windows.net/manuals/sample.pdf
2
Append the SAS token as a query string
Concatenate a ? then the full SAS token string.
https://primametrics.blob.core.windows.net/manuals/sample.pdf?sp=rl&st=2026-04-23T11:46:24Z&se=2027-04-23T20:01:24Z&spr=https&sv=2025-11-05&sr=c&sig=...
3
Use the full URI directly
The resulting URL can be used directly in a browser, <a> tag, or HTTP client — no additional headers needed for blob access.
⚠ SAS Token Expiry
The current SAS token expires on 2027-04-23. After this date, all instructionManualLink values returned by the API will return 403 errors. A new SAS token must be generated and configured before expiry.