Open APIs

 View Only

TMF630 API Design Guidelines Part 2 refers to extension patterns by adding relationships

  • 1.  TMF630 API Design Guidelines Part 2 refers to extension patterns by adding relationships

    Posted Mar 08, 2023 04:15

    Hi All

    The design guidelines refer to extending resources by "adding relationships" but there is no example of this extension pattern within the document.  Can anyone provide me with an example of how this may be achieved?  I am presuming that this pattern has derived from SID where already sub-classed resources may be extended by association...

    Also I noticed Section 2.5 "Resource Field Naming" of the Design Guidelines Part 1 has been removed.  It previously suggested camelCase of lowercase.  I was also wondering if there was any restriction of providing extension resources with field names containing a prefix, e.g. CSP/DSP short name, is recommended or not?

    Thanks

    Dan.

    2.                 Extension patterns<o:p></o:p>

    An extension is considered conformant or valid if it does not invalidate the core characteristics of an API and does not contradict the API Design Guidelines.<o:p></o:p>

    Various extensions mechanisms are supported:<o:p></o:p>

    o   Extending the basic schema of an entity like Product to create a subclass in that case all the mandatory attributes and relationships of the base schema should be present in the extension.<o:p></o:p>

    o   Adding characteristics to define run time extension<o:p></o:p>

    o   Adding relationships<o:p></o:p>



    ------------------------------
    Dan d'Albuquerque
    TO BE VERIFIED
    ------------------------------