Documentation Index Fetch the complete documentation index at: https://mintlify.com/fredy-rizo/tukit/llms.txt
Use this file to discover all available pages before exploring further.
The Get Product endpoint fetches a single product document from the database by its MongoDB ObjectId. Any authenticated user (not just admins) may call this endpoint to load a complete product record including its file URLs, pricing, category, creator snapshot, and Mongoose timestamps. If the product exists, it is returned in the data field. If the lookup fails — for example because the ID is malformed or the document has been deleted — the server returns HTTP 203 with a descriptive error message. Unexpected infrastructure errors return 500.
POST /api/product/get/:productId/productIdAuthentication Every request must include a valid JWT in the token-access header.
This endpoint does not require admin privileges, but authentication is
still mandatory.
Header Value Required token-access<your JWT token>✅ Yes
Path Parameters The MongoDB ObjectId of the product to retrieve. This value is the _id
returned when the product was created or when products are listed.
Request Body No request body is required or expected for this endpoint.
Response 200 — Product Loaded true on a successful lookup.
The full product document for the requested ID. Show Product schema fields
MongoDB ObjectId of the product.
Display name of the product.
Optional long-form description of the product.
Product category. One of "Uniforme" or "Tipografía".
Base price of the product. Defaults to 0.
Array of stored file path strings for the primary design file.
Array of stored file path strings for the product preview image.
Design file format(s) included with the product, e.g. "AI", "PNG",
"PSD".
Array of stored file path strings for the shirt demonstration GIF/image.
Array of stored file path strings for the shorts demonstration GIF/image.
Payment type. One of "Pago" (paid) or "Gratuito" (free).
Discount label or numeric percentage string. Defaults to
"Sin descuento" when no discount has been applied.
Calculated discounted price stored as a string. Empty string when no
discount is active.
Minimum purchase quantity. Defaults to 1.
ISO 8601 date set at document creation via Date.now.
Snapshot of the admin user who created the product, embedded at creation
time. The creator’s email address.
Array of role objects { name: string, value: string }.
Array of activation status objects { name: string, value: string }.
ISO 8601 timestamp automatically added by Mongoose timestamps: true.
ISO 8601 timestamp of the most recent update, maintained by Mongoose
timestamps: true.
Error Responses Status Condition status203Product not found or MongoDB lookup failed false500Unexpected server error —
203 — Error Loading Product
{ "msj" : "Error al cargar producto" , "status" : false }
Example Replace <YOUR_TOKEN> with a valid JWT and <PRODUCT_ID> with the
MongoDB ObjectId of the product you want to retrieve.
curl -X POST https://your-api-domain.com/api/product/get/665a1f2e8c4b2a001e3d9f01/productId \ -H "token-access: <YOUR_TOKEN>"
{ "msj" : "Cargando producto..." , "status" : true , "data" : { "_id" : "665a1f2e8c4b2a001e3d9f01" , "title" : "Club Deportivo Tigres 2025" , "description" : "Kit completo de uniforme para temporada 2025." , "category" : "Uniforme" , "price" : 12.99 , "archivoUrl" : [ "storage/product/23design.ai" ], "imageUrl" : [ "storage/product/7preview.png" ], "format" : "AI" , "shirtGif" : [ "storage/product/12shirt.gif" ], "shortsGif" : [ "storage/product/45shorts.gif" ], "typeProduct" : "Pago" , "discount" : "Sin descuento" , "discountPrice" : "" , "minCant" : 1 , "date" : "2025-06-01T14:30:00.000Z" , "user" : { "_id" : "664f0a1c3b2e1a001d2c8e00" , "userName" : "adminuser" , "email" : "admin@tukit.com" , "roles" : [{ "name" : "admin" , "value" : "2" }], "activate" : [{ "name" : "active" , "value" : "true" }] }, "createdAt" : "2025-06-01T14:30:00.000Z" , "updatedAt" : "2025-06-02T09:15:00.000Z" } }
