October 2019 Summaries

Postman has enhanced its API collaboration capabilities by introducing a new team discovery feature, simplifying the process for team members to find and join teams within their organization. This feature automates the onboarding process by allowing users who log in with a company email to view and request access to available teams, with administrators receiving notifications to approve or deny these requests. As teams grow, this reduces the manual effort previously required to add collaborators, making it easier to scale participation in API projects. Team administrators can enable the discovery feature in team settings, facilitating a seamless integration with existing project management and productivity tools. The team discovery feature is designed to enhance collaboration by allowing stakeholders to contribute more effectively to API projects, thus focusing on solving business challenges through improved communication and development strategies.

Postman collections serve as machine-readable representations of APIs, allowing developers to define, design, mock, deploy, test, document, and secure APIs throughout their lifecycle using a variety of services and tools. They provide an executable and shareable format that reduces friction in API development and offer features like folders for organization, HTTP verbs for specifying requests, path and query parameters for dynamic results, and various authentication methods to ensure secure access. These collections also allow for the inclusion of headers, request bodies, cookies, examples, and comments, providing a comprehensive reference that can be converted from existing specifications like Swagger, OpenAPI, and RAML. Although Postman collections do not replace traditional API documentation, they provide a centralized source of truth that can be used to publish up-to-date documentation and facilitate the design, development, and integration of APIs across various platforms.

Postman has introduced public profiles to recognize and showcase the contributions of individuals and teams within its community, allowing users to receive credit for the helpful collections they have shared. These profiles enable authors to display personal or team information, such as photos, descriptions, and a list of published APIs and templates, making their work easily discoverable within the Postman app. Users can explore public profiles from organizations like Okta, Cisco DevNet, and Twitter to find useful collections and templates for learning and automating tasks. If desired, profiles can be disabled, which will unpublish any templates associated with the user or team. This new feature not only enhances visibility but also provides immediate feedback on how often a collection or template has been viewed or imported, offering a sense of community engagement and recognition.

API contracts, as understood by Postman, extend beyond traditional machine-readable API definitions like Swagger or OpenAPI, incorporating elements that highlight both technical and business aspects. At the core of Postman's approach is the Collection, which organizes API requests into shareable and executable formats, allowing users to define, run, and collaborate on API workflows. These collections are divided into API Reference Collections, detailing the surface area of APIs, and API Workflow Collections, which include environment variables and chain multiple API calls to illustrate business workflows. Postman enhances API contracts with features like pre-request scripts, test scripts, and runners, which automate validation and ensure contracts are maintained through CI/CD pipelines. Additionally, Postman facilitates the publication of mock APIs and detailed API documentation, enabling stakeholders to explore and validate contract functionality. This comprehensive view of API contracts emphasizes both machine-readability and human usability, making them accessible to developers and business stakeholders alike, fostering understanding and trust within the API community.

Developers using Postman, a leading API platform, frequently encounter challenges in delivering detailed performance metrics and alerts to stakeholders, necessitating a comprehensive understanding of API performance across global data centers. To address these challenges, APImetrics has partnered with Postman to enable seamless synchronization for Postman Pro and Enterprise users, enhancing their ability to monitor API performance across multiple cloud environments. The integration requires minimal setup and offers features such as detailed metrics, automated alert configurations via popular platforms like Slack and PagerDuty, and machine learning-based analysis for problem detection. APImetrics provides a global network of monitoring locations across AWS, Azure, and Google data centers, allowing users to simulate client-side API performance from different regions. By setting up API monitoring, users can access data on network timings, availability, pass rates, and latency, as well as a CASC score for overall API health. Additional tools help track SLAs and integrate with various alerting services, while users can sign up for an APImetrics account, with a promotional discount available for new users.

Postman is supporting the NASA Space Apps Challenge, an international hackathon that encourages teams to solve problems using NASA's open data, by providing a NASA Postman collection to assist participants of all skill levels in understanding and utilizing APIs. APIs, which facilitate data exchange across web, mobile, and device applications, are integral to modern technology, enabling data integration for desktop, web, and mobile applications, as well as system integrations, spreadsheets, and connected devices. Postman, an API development platform, simplifies API usage for both developers and non-developers by enabling the crafting of API requests, managing authentication, viewing responses, and fostering collaboration through collections and shared requests. The unofficial NASA Postman collection offers access to over 20 NASA APIs, organized into 21 folders focusing on various aspects such as near-Earth objects, Mars rover photos, weather data, and space technology, to inspire and aid participants in developing innovative projects during the hackathon. Participants can access these APIs, some of which require a NASA API key, to explore and integrate NASA's data into their applications, while Postman offers resources like a video walkthrough to further explain API usage in conjunction with the hackathon.

API change within large organizations is driven by leaders, or "champions," who promote API use and integration across teams, playing a crucial role in the success of API programs. These champions utilize tools like Postman to onboard, connect, and empower team members, fostering collaboration and innovation by helping both developers and non-developers use APIs effectively. Postman serves as a vital resource for mapping an organization's API landscape, enabling API champions to identify who uses APIs, how they are being used, and to document and share API definitions and best practices. Engaging with team members to understand their use of Postman, encouraging the sharing and organization of API collections, and focusing on education and support are key strategies for champions to enhance API operations. This effort also involves standardizing API practices and testing, documenting APIs, and ensuring proper support to avoid orphaned APIs, ultimately leading to a well-documented, repeatable, and measurable API lifecycle. Through continuous refinement and engagement, API champions work to reduce redundancy, improve collaboration, and stabilize API delivery processes, playing a pivotal role in advancing an organization's digital capabilities.

APIs have become a fundamental component of how businesses operate online, evolving significantly since their inception. Originating in the early 2000s, web APIs were driven by companies like Salesforce, eBay, and Amazon, which used them to revolutionize online commerce by providing access to machine-readable data formats like JSON and XML. This evolution continued with the rise of social media platforms such as Facebook and Twitter, which leveraged APIs to enhance connectivity and data sharing. The advent of the cloud further transformed the landscape, with Amazon Web Services setting new standards for deploying infrastructure via APIs. The mobile revolution, spurred by the launch of the iPhone and Android, pushed APIs into the mainstream, facilitating the development of location-based services and communication applications. Today, APIs are integral to the Internet of Things, connecting everyday objects to the internet and creating an interconnected ecosystem. As mainstream industries increasingly adopt APIs, understanding their deployment and integration becomes vital for future innovation and industry leadership.

Onboarding individuals to the world of APIs presents challenges due to the vast array of use cases and varying levels of technical knowledge among users. Postman is addressing these challenges by developing onboarding techniques and entry-level content to bridge the gap between technical and non-technical users. Engaging with existing public APIs, such as those from social media or productivity apps, is a recommended starting point, allowing users to explore the functionality of APIs they already interact with daily. For those interested in organizational APIs, mapping the existing API landscape and engaging with relevant documentation and teams is crucial. This exploration helps users understand the role of APIs within their work environment and enables them to make informed decisions about their API journey. The process of learning about APIs involves both discovering existing APIs and building relationships with the community, enhancing the user's ability to become both an API consumer and potential provider.

Postman offers a comprehensive set of tools for effectively defining, designing, developing, and operating APIs, making them more discoverable, usable, and adaptable across diverse teams and stages of development. It emphasizes the use of collections, environments, and workspaces as the fundamental building blocks to manage APIs efficiently. Collections serve as machine-readable API descriptions, environments provide context for API requests, and workspaces organize these elements to reflect developer and consumer usage. The text discusses the importance of naming conventions, domain-driven design, and aligning API organization with business lines, team structures, and resource-centric views, all to enhance collaboration and efficiency. It highlights the need for thoughtful planning and adaptability in naming and organizing these components, to support workflows that encapsulate the entire API lifecycle from development to monitoring, encouraging collaboration and reducing friction in operations.

Cisco has released a comprehensive suite of ten Postman API collections on the Cisco DevNet platform, aimed at enhancing access to their networking, security, and video conferencing solutions. These collections, which can be accessed via the Postman API Network, offer over 200 individual API requests, covering areas like Cisco SD-WAN, Cisco DNA Center, Cisco Security APIs, Cisco NGFW Firepower, Cisco CE xAPI, Cisco Intersight, and Webex Admin and Teams APIs. These resources allow developers to manage infrastructure efficiently, automate workflows, and improve collaboration by organizing APIs into accessible, meaningful folders and requests. Users can integrate these collections into their Postman instances using the "Run in Postman" button, and further explore them by signing up on the Cisco DevNet portal to obtain access keys. The initiative not only facilitates the deployment of Cisco APIs but also serves as a model for defining and organizing API collections for broader public exposure.

APIs have emerged as a crucial component in modern business operations, extending far beyond the realm of developers to encompass a broader audience, including business users. They offer seamless integration capabilities that enhance agility, facilitate access to vast data sets, and strengthen both internal operations and external partnerships. APIs enable business stakeholders to actively participate in the development and management of digital transformations, allowing them to streamline workflows, orchestrate service integrations, and engage with technical teams effectively. Understanding APIs empowers businesses to define, govern, and optimize their digital capabilities, ensuring they maintain a competitive edge in an API-driven landscape. By becoming API-aware, business users can contribute to shaping the future of their organizations, leveraging the power of APIs to drive innovation and efficiency across various platforms and services.