Open APIs

 View Only
  • 1.  Reference implementations and Open Digital Lab

    TM Forum Member
    Posted Jul 23, 2019 03:59
    Hello,

    PDF documents contain samples for some JSON payloads of the APIs. However, I was seeking for more concrete and complete examples and I was therefore aiming for a test/sandbox system, compliant with most TMF APIs, with a pre-populated database (e.g. MongoDB) of SID compliant objects. Typically, such a test system could then be accessed via Postman or any HTTP client. I wonder if the Open Digital Lab is the place I am looking for? I requested access to it (following the request form on the TMF web site) and got a valid user/login to the IBM cloud platform in return, but then I got stuck on where or how to access to TMF related projects or content. The web request form states that an email should be sent automatically (apart from the automatic IBM cloud registration) but I seems that I never received it.
    I then attempted to look at the various reference implementations on Github. Basically, they just contain some basic swagger generated project skeletons, but I could not find any real working samples against which I could test a client application. Even, the instructions there are very sparse and it's hard to get started with these reference implementation projects, even with some node.js dev experience.
    So my question is: is there a TMF-API compliant test system somewhere that we could use or build? I am mainly looking for real JSON objects following the standardized schemas  and even some end-to-end use cases (e.g. sequences of HTTP requests) to study how the various APIs work and relate together in a realistic scenario. My primary use case of interest is service orchestration, but the need is surely the same for any other TMF API.
    Thanks for any help.
     


    ------------------------------
    Alexandre Meynaud
    Hewlett Packard Enterprise
    ------------------------------


  • 2.  RE: Reference implementations and Open Digital Lab

    TM Forum Member
    Posted Jul 23, 2019 13:56
    Hi Alexandre
    Regarding examples in the specs, as designers of the Open APIs, we put best effort into creating realistic examples, given the limitations of time and resources. But there is always what to improve, and we would welcome specific suggestions.
    Regarding the testing and sandbox, I advise you to reach out to @Henrique Rodrigues and @Pierre Gauthier - they might be able to assist more here.
    Hope it helps

    ------------------------------
    Jonathan Goldberg
    Amdocs Management Limited
    ------------------------------



  • 3.  RE: Reference implementations and Open Digital Lab

    TM Forum Member
    Posted Jul 24, 2019 12:35
    The Open Digital Lab Users Group meets every other Tuesday from 3-4PM GMT. See the ODA Calendar for details.

    ------------------------------
    Vance Shipley
    SigScale Global Inc.
    ------------------------------



  • 4.  RE: Reference implementations and Open Digital Lab

    TM Forum Member
    Posted Jul 25, 2019 06:11
    Thank you Vance,
    I am looking forward to attend the next Open Digital Lab users group online meeting. However, the link to the calendar seems broken. Can someone tell me how to register?
    Many thanks

    ------------------------------
    Alexandre Meynaud
    Hewlett Packard Enterprise
    ------------------------------



  • 5.  RE: Reference implementations and Open Digital Lab

    TM Forum Member
    Posted Jul 29, 2019 06:02
    Hi Alexandre
    I believe that in order to access the calendar and attend meetings, you need to formally join the project. Assuming that you are already signed up as a TMF member, you should go to the list of projects at https://www.tmforum.org/collaboration/current-projects/, find the ODA project in the list (near the bottom), and click the button Join the Project. This will cause a notification to be sent to the responsible HPE contact for TMF to approve your joining.
    After you have joined, you will hopefully have access to the ODA materials in development, including the team calendar.
    Hope it helps

    ------------------------------
    Jonathan Goldberg
    Amdocs Management Limited
    ------------------------------