Fork me on GitHub

www.usa.gov updates

Publish APIs.json for Developer.Trade.Gov

Posted on

Now that I have two separate APIs for Developer.Trade.Gov defined using Swagger, I can go ahead and generate the APIs.json for the Developer.Trade.gov domain, listing all of the APIs, as well as their supporting elements. When I finish with the other APIs, when they either enable CORS or I get the time to make a proxy, I'll the rest of the APIs to the APIs.json for the Developer.Trade.Gov domain. My goal with this is to show how easy it is to generate machine readable specifications for government APIs, but also the benefits of interactive documentation, and discovery using APIs.json....read more.



New Trade.Gov Developer Portal

Posted on

I was alerted to the new Developer.Trade.Gov portal today, and asked to review the implementation. Overall it is a pretty simple implementation, meeting the minimum viable developer area My biggest complaint is no machine readable specifications for the APIs, as well as an APIs.json file for the agency. The API is pretty simple, and this doesn't take much work--so off I go....read more.



Market Research API Swagger Specification

Posted on

I tackled the first Market Research Library API first, as it was top of the list. The URL is pretty straightforward with a simple list of parameters, and response data model. It took me about 10 minutes to create the Swagger spec for the Market Research Library API, and generate the HTML page using Swagger UI that is driven from the spec....read more.



ITA Offices and Centers API Swagger Specification

Posted on

Next I tackled the ITA Offices and Centers API, as it was next on the list. Like its predecessor, the URL is pretty straightforward with a simple list of parameters, and response data model. (good to see) It took me about 10 minutes to create the Swagger spec for the ITA Offices and Centers API, and generate the HTML page using Swagger UI that is driven from the spec....read more.



CORS Puts A Stop To The Fun

Posted on

Photo Credit I was cruising along doing the Swagger specs, and Swagger Interactive Docs for both the Market Research Library API and the ITA Offices & Centers API and then I hit run on the docs, and denied--due to CORS not being enabled. I think that CORS education will be one of the most important educational elements we'll have to provide to federal agencies. Without CORS enabled, APIs will have a problem reaching the next level....read more.