ui-theme-designer-help

# UI theme designer help ## Context The UI theme designer documentation is served by `https://help.sap.com` via a JSON HTTP API: - **Deliverable metadata** — resolves human-readable identifiers to internal IDs and provides the flat readable-URL-to-loio mapping: `GET https://help.sap.com/http.svc/deliverableMetadata?product_url=btp&deliverable_url=ui-theme-designer&version=LATEST` Returns `data.deliverable.id` (`deliverable_id`), `data.deliverable.buildNo`, and `data.filePath` (landing page file path). - **Page content** — fetches the HTML body of a single topic, and optionally the full hierarchical TOC: `GET https://help.sap.com/http.svc/pagecontent?deliverable_id={id}&buildNo={buildNo}&file_path={loio}.html` Returns `data.body` (HTML). With the extra param `deliverableInfo=1` also returns `data.deliverable.fullToc` — a recursive tree of `{t: title, u: filename, c: children[]}` nodes covering all 80+ topics. ## Procedure Use `curl -s` to call all API endpoints, and `jq` to parse the JSON responses. 1. Fetch deliverable metadata to obtain `deliverable_id` and `buildNo`: ```sh curl -s "https://help.sap.com/http.svc/deliverableMetadata?product_url=btp&deliverable_url=ui-theme-designer&version=LATEST" | jq '{id: .data.deliverable.id, buildNo: .data.deliverable.buildNo, filePath: .data.filePath}' ``` 2. Fetch the landing page with `deliverableInfo=1` to get the full TOC tree: ```sh curl -s "https://help.sap.com/http.svc/pagecontent?deliverableInfo=1&deliverable_id={id}&buildNo={buildNo}&file_path={filePath}" | jq '.data.deliverable.fullToc' ``` 3. From the TOC, identify the topic(s) whose title best matches the user's question. If uncertain, pick 2–3 candidates. 4. For each candidate, fetch its page content and strip HTML tags: ```sh curl -s "https://help.sap.com/http.svc/pagecontent?deliverable_id={id}&buildNo={buildNo}&file_path={loio}.html" | jq -r '.data.body' | sed 's/<[^>]*>//g' | tr -s '\n' ``` 5. Answer based on the retrieved content.