August 2020 Summaries

REST (REpresentational State Transfer) is a widely used software architectural style for designing web APIs, known for its simplicity and uniformity in making digital resources like data, content, and media accessible through web URLs. This approach allows developers to define, locate, and manage resources across various applications through standard HTTP methods such as GET, POST, PUT, and DELETE, enabling operations like retrieval, addition, updating, and deletion of resources. REST is not a strict specification but a guiding principle that promotes organizing digital resources and operations, facilitating collaboration and integration across web and mobile platforms. For example, Facebook employs REST principles in its Graph API, allowing authenticated users to access and manipulate their profiles and other resources in various formats, such as HTML and JSON, using simple web requests. REST continues to be popular because it leverages the existing web infrastructure to provide a standardized method for sharing and managing digital capabilities across diverse online environments.

In response to the challenges of air quality monitoring during the California wildfires and the ongoing pandemic, the Postman Air Quality Collection offers a timely solution by leveraging APIs for real-time data exchange. Initially developed in 2017 after Northern California fires, this tool integrates Postman Collections, Monitors, and Environments with the AccuWeather API to provide up-to-date air quality information. Users can configure the collection to post updates to Twitter, allowing for personalized and localized alerts about air conditions, especially important as extreme weather and fires lead to hazardous pollution levels. This initiative aims to keep California residents and others informed and safe by delivering critical air quality data through accessible technology platforms.

Over the past four years, the Postman Console has been an essential tool for developers dealing with unexpected API behaviors, providing a detailed view of requests, responses, and errors similar to a browser's developer console but specifically tailored for APIs. Recently, Postman released an update with version 7.28, integrating the console into the main application window as a new pane, which streamlines the debugging process by allowing developers to access detailed information on warnings, errors, logs, and other data without leaving their current screen. This enhancement significantly reduces the time previously spent switching between the application and a separate console window, improving efficiency for both desktop and web versions of Postman. The console's functionality is vast, limited only by the last 5,000 messages and 24 hours, and developers can further enhance their understanding through a brief YouTube tutorial designed to optimize their use of the Postman Console.

Postman highlights the contributions of its vibrant community, focusing on Allen Helton, a prominent member from Texas who actively participates in the Postman Community forum. Allen, a software engineering manager at Tyler Technologies, has been a member since July 2019 and is recognized for his high engagement, ranking as the sixth most active member in the past year with significant contributions in posts and interactions. Motivated by a desire to help others succeed, Allen encourages doing things correctly and shares his insights on his blog, "Ready, Set, Cloud!" The Postman Community forum serves as a platform where users can freely discuss and share their experiences with APIs, fostering a supportive environment for innovation and collaboration.

Postman's data team has restructured itself using the hub-and-spoke model to enhance scalability, efficiency, and communication within the organization. This model, inspired by practices in the transportation industry, involves a central team that addresses broad analytical problems and develops self-service decision-making tools, while embedded and distributed teams focus on specific domain challenges. The central team acts as the "hub," providing a foundational support system, while the embedded and distributed teams serve as "spokes" that extend specialized knowledge and solutions across various domains. By adopting this structure, Postman aims to facilitate the dissemination of data-driven insights throughout the organization without the need for linear team growth. The team employs Objectives & Key Results (OKRs) to standardize their approach and measure success, ensuring a strategic alignment with their goal of democratizing data access. This approach not only supports problem-solving at scale but also fosters a continuous learning environment through the development of a knowledge repository.

In a world overwhelmed with data, organizations face the challenge of managing and deriving insights from vast volumes of information, which can lead to siloed decision-making practices due to diverse tools and methods. Postman addressed this challenge by democratizing data, allowing more individuals within the organization to make data-driven decisions independently, thereby preventing knowledge silos and fostering a decentralized decision-making system. By implementing a framework that includes leadership buy-in, guidelines, and platforms for data integration, transformation, and visualization, Postman empowered its data consumers and ensured accountability through a distributed ownership model. This approach not only enabled sub-linear scaling of the data team but also aligned the data structure with organizational communication, facilitating a more efficient and collaborative environment. Through the use of tools like Looker and the Kimball modeling strategy, Postman maintained a consistent data strategy that mirrored the company's structure and promoted an analytical mindset across the organization.

In the evolving field of agtech, Beck's Hybrids, the largest family-owned retail seed company in the U.S., exemplifies the integration of APIs to modernize agricultural practices. With roots dating back to 1937, Beck's has transitioned from a traditional farming company into a tech-driven entity by employing a team of developers to build API-powered applications. These applications support various operations, including sales, production, and precision farming through their FARMserver platform. The use of Postman API Platform has become essential for Beck's, facilitating collaboration, testing, and documentation among developers, thereby enhancing productivity and integration with third-party platforms. This technological shift not only optimizes Beck's internal workflows but also significantly improves farmer productivity, ROI, and crop yields by consolidating large data sets within a single application. As APIs gain prominence in agriculture, Beck's ongoing development and use of Postman underscore the increasing value of digital solutions in transforming the agricultural landscape.

Postman's release of version 7.27 enhances developers' ability to troubleshoot API requests by providing detailed network information, which includes IP addresses, TLS details, and certificate information. This update addresses common challenges such as SSL certificate issues by offering a comprehensive view of the network and server components involved in API transactions. The additional insights aim to make API operations more transparent and actionable for developers, aligning with feedback from Postman's community and GitHub submissions. By improving visibility into the API supply chain, Postman supports the growing community of over 17 million developers working on diverse applications, facilitating better control and understanding of the technical intricacies of API requests.

The tutorial introduces beginners to HTTP status codes and demonstrates how to build a Postman Collection using the HTTP Cats API, providing a playful and engaging way to explore API interactions. It explains the significance of HTTP status codes, categorized into informational, successful, redirects, client errors, and server errors, while highlighting the importance of accurate and consistent usage by developers. By guiding users through creating a Postman workspace and using JavaScript within Postman to scrape hyperlinks, the tutorial emphasizes the utility of environments for storing configuration data and variables. It further illustrates how to manipulate requests using pre-request scripts and environment variables, enhancing understanding of API workflows. Additionally, it encourages exploration of advanced Postman features like visualizing server responses and integrating additional APIs, concluding with a suggestion to explore other cat-related tech resources and APIs for further learning and experimentation.

The Postman blog invites developers and API enthusiasts to contribute by writing guest posts, offering a platform for sharing expertise and insights within the API community. The blog, which serves as a resource for tutorials, stories, and best practices, now encourages individuals to showcase their API knowledge and projects, enhancing the community's understanding and engagement with APIs. Contributions can explore conceptual thoughts, practical tips, or innovative uses of Postman, while avoiding marketing pitches. This initiative allows contributors to establish their voice in the API world and benefit from the feedback provided during the publication process, fostering both personal growth and community learning. Interested individuals can learn more by reviewing submission guidelines and submitting their ideas for consideration.

OAuth serves as a critical component in API development by providing authentication and authorization for web and mobile applications, yet its varied implementations can pose challenges for developers. Postman, a popular tool in API development, has actively responded to these challenges by incorporating feedback from its community to reduce OAuth-related friction. Recent improvements include support for custom Authorization header prefixes in OAuth 2.0, enhancements for managing OAuth 2.0 tokens, and fixes for issues related to the use of older browser versions and visibility in the Postman Console. These updates aim to streamline the integration of OAuth in APIs and enhance developer productivity, emphasizing Postman's commitment to addressing user-reported issues and continuously evolving its platform to meet developer needs.