doc:openapi Improve documentation on spec's nodeId

[howardyoo]

Signed-off-by: howardyoo howardyoo@gmail.com

Problem

The current spec description lacks complete examples of the format and example of nodeId.

Closes: #2083

Solution

• added more example and details on what nodeId.
• updated description of the nodeId.

Note: All database schema changes require discussion. Please link the issue for context.

Checklist

• You've signed-off your work
• Your changes are accompanied by tests (if relevant)
• Your change contains a small diff and is self-contained
• You've updated any relevant documentation (if relevant)
• You've updated the CHANGELOG.md with details about your change under the "Unreleased" section (if relevant, depending on the change, this may not be necessary)
• You've versioned your .sql database schema migration according to Flyway's naming convention (if relevant)
• You've included a header in any source code files (if relevant)

[codecov]

Codecov Report

Merging #2084 (f70ada4) into main (95d6de5) will not change coverage.
The diff coverage is n/a.

@@            Coverage Diff            @@
##               main    #2084   +/-   ##
=========================================
  Coverage     77.04%   77.04%           
  Complexity     1013     1013           
=========================================
  Files           201      201           
  Lines          4643     4643           
  Branches        389      389           
=========================================
  Hits           3577     3577           
  Misses          628      628           
  Partials        438      438           

📣 We’re building smart automated test selection to slash your CI/CD build times. Learn more

[wslulciuc]

LGTM 👍