Watson Campaign Automation Ideas

Submit new product ideas for Watson Campaign Automation, Watson Real-time Personalization, Watson Content Hub and Universal Behavior Exchange. Before you submit, please review existing ideas; if an idea close to yours already exists, it's better to add comments or vote on the existing idea. We will review your ideas and use them to help prioritize our product development. Best of all, the portal will automatically update you when the status of your idea has been changed.

Connect with your peers and IBM experts on the Watson Marketing and Commerce Community

Submit ideas for other Watson Customer Engagement Products:

•  Other Watson Marketing solutions
Watson Commerce
Watson Supply Chain

Full swagger.json spec for WCA REST API.

In our project an external team of developers is doing work on the mobile APP. This work requires invoking the REST API from the phone. That task could be greatly alleviated if we provided a full swagger.js spec of the REST API as they could use it to automatically generate all boiler plate code they need from it with a tool they have.

I have found the pointer to a swagger based description of our REST API in:

https://api3.ibmmarketingcloud.com/restdoc/?cm_mc_uid=96198786210215173954260&cm_mc_sid_50200000=42063971524763775464&cm_mc_sid_52640000=39665781524763781794

I have noticed the "Raw" buttons in the page there that lead me to get json fragments for each different API call.

The problem is that this does not suffice as their code generator would only work from a file that is complete in some sense.

As for an example of a complete file we have been given this: http://petstore.swagger.io/v2/swagger.json

Notice that this file starts with

{"swagger":"2.0","info":{"description":"This is a sample server Petstore server. You can find out more about Swagger at [http://swagger.io](http://swagger.io) or on [irc.freenode.net, #swagger](http://swagger.io/irc/). For this sample, you can use the api key `special-key` to test the authorization filters.","version":"1.0.0","title":"Swagger Petstore","termsOfService":"http://swagger.io/terms/","contact":{"email":"apiteam@swagger.io...

which seem more "complete" and totally different from the fragments we offer in our docs.

I opened a case to ask if we supported this (Case 00714035) but apparently the version of swagger we use lags what other projects are using elsewhere. After finding out this, I was suggested to submit this in idea form... :-)

I think updating our swagger to support this would be really meaningful from the point of view of developers working against our REST API.

  • Avatar32.5fb70cce7410889e661286fd7f1897de Guest
  • Jun 15 2018
  • Under Consideration
How will this idea be used?

People developing APPs that need to interact via WCA REST API will have a spec file from which generate a lot of boilerplate code from.

What is your industry? Other
What is the idea priority? Medium
DeveloperWorks ID
RTC ID
Link to original RFE
  • Attach files
  • Admin
    Powell Smith commented
    June 20, 2018 13:38

    We're looking at this one and reviewing it with our documentation team.