RT @DeliberateComp1: "How cognitive biases and ranking can foster an ineffective architecture and design" Don't miss out on… https://t.co/Njau4ATXn0
This talk was presented at API The Docs Virtual 2020 event series on 10 June. We are glad to present the video recording, slide deck and talk summary below. Enjoy!
Visit our talk recaps ToC page for an overview of all presentations!
An API “Playground” Enables you to try out a company’s API from the browser without writing any software or script. API Explorers are tools for making live calls to the API endpoints.
Some devportal refer to their API Reference documentation website as an API Explorer. So, “API Explorer” is also used for static API documentation.
Primary benefits of API Explorers:
Text areas for creating API request:
Benefits:
Issues:
An API Explorer that supports:
Additional features in the tool:
To have an API Explorer that supports click configuration and deeply nested API elements:
Use the open source Google Blockly library that enables an easy update of the library
Use the builder pattern to add data to the request object - the user does not have to worry about erase, child or grandchild objects
As result: the blocks are easy to edit and form the most complicated API requests
Each block includes a small JavaScript function - altogether the blocks create a fluent (chained) output program
An additional layer of software takes the fluent input and produces the JSON output
(e.g. from Node.js to JSON)
Automated array creation: the Builder tool uses the Swagger file definitions to automatically create arrays as needed
Automatic object creation:
Auto-programming the API’s SDK: CodeGen software generates SDKs from the OAS and the Builder tool uses recursion to auto-program the SDK
The tool is built from the API’s Swagger file (OAS): as a separate batch process, a configuration app parses the Swagger file and creates the block definitions.
No significant server component. The tool makes direct calls to DocuSign via CORS.
Single page React application with the Docusign inhouse-style library
See the Builder Tool demo in the presentation to find out how DocuSign could meet the goals.
RT @DeliberateComp1: "How cognitive biases and ranking can foster an ineffective architecture and design" Don't miss out on… https://t.co/Njau4ATXn0
RT @DeliberateComp1: "APIs: Semi-permeable, osmotic interfaces" Don't miss out on @dawnahukanna's talk next week at the… https://t.co/rF2qm9E2WM
Deliberate Complexity 2022 features a series of three events organized by @pronovix with the intent to create a spa… https://t.co/5ZkCEKHS7S
Deliberate Complexity 2022 features a series of three events organized by @pronovix with the intent to create a spa… https://t.co/uFiX820fCE
Big thanks to @palantir and @pronovix for sponsoring the #drupal update project bot. This tool is a major reason… https://t.co/OVYevQEFLG