Dinilu Promotional & Printed Products API

openapi: 3.1.0
info:
  title: Dinilu Promotional & Printed Products API
  version: '2026-11-05'
  description: 'GENERATED FROM DOCUMENTATION by API Evangelist on 2026-11-05: 4 operation(s) read from 2 public documentation page(s) (each operation
    names its page in x-source). This is not the provider''s published contract; Dinilu Promotional & Printed Products has published no machine-readable
    contract that the pipeline could find. Engine: local.'
  x-evidence-tiers:
    code-example: 0
    documentation: 4
    pages-with-code: 0
    pages-read: 2
  x-generated-from: documentation
  x-provenance: generated
  x-authored-by: API Evangelist
  x-generated: '2026-11-05'
  x-generator: generate-contract-from-docs.py
  x-engine: local
  x-sources:
  - https://dinilu.us/llms-full.txt
  - https://dinilu.us/about-us/developers
paths:
  /api/product/{mpn}:
    get:
      operationId: get_api_product_mpn
      tags:
      - Api
      summary: Get product options
      description: Returns product option details including attributes and a ready‑to‑use quote URL.
      x-source: https://dinilu.us/llms-full.txt
      parameters:
      - name: mpn
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiProductMpnResponse'
      x-evidence:
        kind: documentation
  /api/products:
    get:
      operationId: get_api_products
      tags:
      - Api
      summary: List products (optional if you have a product URL)
      description: Returns an array of products with mpn, title, page URL, api_url, and image.
      x-source: https://dinilu.us/llms-full.txt
      parameters:
      - name: category
        in: query
        required: false
        schema:
          type: string
        description: Category tid to filter products
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiProductsResponse'
      x-evidence:
        kind: documentation
  /api/quote:
    get:
      operationId: get_api_quote
      tags:
      - Api
      summary: Request a quote (GET form)
      description: Returns price, shipping, and other quote details for the specified product configuration.
      x-source: https://dinilu.us/llms-full.txt
      parameters:
      - name: mpn
        in: query
        required: true
        schema:
          type: string
        description: Product MPN
      - name: qty
        in: query
        required: false
        schema:
          type: string
        description: Quantity in pieces
      - name: country
        in: query
        required: false
        schema:
          type: string
        description: Country name or ISO code
      - name: attributes
        in: query
        required: false
        schema:
          type: string
        description: Attribute selections as id:option pairs joined by '|'
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiQuoteResponse'
      x-evidence:
        kind: documentation
    post:
      operationId: post_api_quote
      tags:
      - Api
      summary: Request a quote (POST form)
      description: Returns the same quote details as the GET form, accepting parameters in a JSON body.
      x-source: https://dinilu.us/llms-full.txt
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostApiQuoteRequest'
      responses:
        '201':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostApiQuoteResponse'
      x-evidence:
        kind: documentation
components:
  schemas:
    GetApiProductMpnResponse:
      type: object
      properties:
        mpn:
          type: string
          description: The product MPN
        min_qty:
          type: integer
          description: Minimum order quantity in pieces
        qty_step:
          type: integer
          description: Order quantity must be a multiple of this number
        attributes:
          type: array
          description: Configurable options, each with id, name, required, and options (each option has id and name)
        quote_url:
          type: string
          description: Runnable Step 3 URL for this product
        quote_hint:
          type: string
          description: One‑line reminder of the attribute syntax
        images:
          type: array
          description: Product photos, each with url and translated alt
    GetApiProductsResponse:
      type: object
      properties:
        mpn:
          type: string
          description: Manufacturer part number
        title:
          type: string
          description: Product title
        page URL:
          type: string
          description: Link to product page
        api_url:
          type: string
          description: API endpoint for the product
        image:
          type: string
          description: URL of product image
    GetApiQuoteResponse:
      type: object
      properties:
        mpn:
          type: string
          description: The product MPN
        url:
          type: string
          description: Product page URL
        price_per_unit:
          type: number
          description: Unit price in USD ex. VAT
        price_total:
          type: number
          description: Total product price in USD ex. VAT
        calculated_on:
          type: string
          description: Date this price was calculated (YYYY‑MM‑DD)
        binding:
          type: boolean
          description: Always false; price is indicative
        cart_url:
          type: string
          description: Link that opens the cart pre‑filled with this configuration
        request_quote:
          type: string
          description: Ways to request a formal quotation
        production_days:
          type: integer
          description: Estimated production time in calendar days
        price_tiers:
          type: array
          description: Same product priced at three quantities, each with shipping options
        attributes:
          type: object
          description: Resolved attribute selections used for the quote, by name
        attributes_shorthand:
          type: string
          description: Selections as id:option pairs, e.g. "19:251|58:490"
    PostApiQuoteRequest:
      type: object
      properties:
        mpn:
          type: string
          description: Product MPN
        qty:
          type: integer
          description: Quantity in pieces ("quantity" also accepted)
        attributes:
          type: object
          description: Map of "attribute id" to "option id"
        country:
          type: string
          description: Country name or ISO 3166‑1 code
        zone:
          type: string
          description: Zone ID
      required:
      - mpn
    PostApiQuoteResponse:
      type: object
      properties:
        mpn:
          type: string
          description: The product MPN
        url:
          type: string
          description: Product page URL
        price_per_unit:
          type: number
          description: Unit price in USD ex. VAT
        price_total:
          type: number
          description: Total product price in USD ex. VAT
        calculated_on:
          type: string
          description: Date this price was calculated (YYYY‑MM‑DD)
        binding:
          type: boolean
          description: Always false; price is indicative
        cart_url:
          type: string
          description: Link that opens the cart pre‑filled with this configuration
        request_quote:
          type: string
          description: Ways to request a formal quotation
        production_days:
          type: integer
          description: Estimated production time in calendar days
        price_tiers:
          type: array
          description: Same product priced at three quantities, each with shipping options
        attributes:
          type: object
          description: Resolved attribute selections used for the quote, by name
        attributes_shorthand:
          type: string
          description: Selections as id:option pairs, e.g. "19:251|58:490"
tags:
- name: Api