Open APIs

 View Only
  • 1.  Modify swagger tmf646

    Posted Jul 13, 2020 11:18
    Hello the community !

    I'm designing an api based on the tmf 646 appoitment.
    I have some questions :
    - Can i modify the swagger to add specific example ?
    - Can i modify the swagger specification to openapi 3.0.3 ?
    - Is it really necessary to expose all operations even if a need only 1 or 2 ?

    Thank you in advance for your input,

    ------------------------------
    Fouad Ualaassri
    VOO SA
    ------------------------------


  • 2.  RE: Modify swagger tmf646

    TM Forum Member
    Posted Jul 14, 2020 00:59
    Hi Fouad
    1 - We have examples in the user guide (the API spec), I don't see a reason why you shouldn't add to the dedicated example session in the swagger.
    2 - We are still working on how to support OAS 3, I imagine that once we do this we will be publishing swaggers in both v2 and v3 format for a while. I don't know when this will happen.
    3 - It's a business decision for your implementation as to which operations to support, but if you want to conform with the Open API you will need to implement all mandatory operations as defined in the conformance profile.
    Hope it helps

    ------------------------------
    Jonathan Goldberg
    Amdocs Management Limited
    Any opinions and statements made by me on this forum are purely personal, and do not necessarily reflect the position of the TM Forum or my employer.
    ------------------------------