May 2022 Summaries

Postman has enhanced its changelog feature to streamline communication of updates in collections, addressing the challenge of manually informing team members and partners about changes. The new changelog automatically generates a chronological list of updates, detailing who made changes and when, and offers precise details along with a diff of modifications. Additionally, Postman introduces changelog sessions, grouping changes within specific timeframes to make it easier to identify contributors and track changes in collaborative environments. The revamped changelog uses simpler representations and contrasting colors to ensure clarity and comprehensibility, thereby making it easier for users to access relevant information and not miss any critical updates.

Postman has introduced new server-level response APIs that allow users to simulate server errors, such as 500 and 503 status codes, on mock servers, which is difficult to replicate during testing. These APIs enable users to apply server-level responses across all paths on a mock server without individually defining 5xx errors, enhancing the ability to simulate unavailable server scenarios. By setting a server-level response as active, every call to the mock server will return with the active server-level response, providing a more accurate testing environment. Users can explore more about setting up mock servers and view mock call logs through the Postman Learning Center, and can follow updates on the Postman Public Roadmap for ongoing enhancements to the tool's functionality.

In a blog post, a developer advocate at Postman shares their experience of creating a global team visualization project using Postman's Visualizer feature. The project highlights the remote-first work culture by mapping out team members' locations across the globe using longitude and latitude data. The advocate utilized various APIs, such as Twitter for user location, PositionStack for geocoding, and Open Weather for weather data, to gather necessary information. By building a POST request with sample data and employing the Postman Echo API, they demonstrated how to visualize user data on a map. The process involved creating workflows to manage data serialization and environment variables, allowing the visualization of real user data and encouraging others to replicate the project with their own teams. This endeavor not only showcased Postman’s capabilities in handling multiple APIs and data visualization but also set the stage for future blog posts on building Postman workflows.

JSON (JavaScript Object Notation) is a widely used text-based data format for exchanging data between systems, particularly popular due to the rise of REST APIs. While XML was once prevalent, JSON has become favored for its human-readable structure and compatibility with various programming languages, supported by pre-built libraries. JSON utilizes arrays and objects to structure data, accommodating basic data types like strings, numbers, and booleans, which makes it highly adaptable for representing both simple and complex datasets. The blog post elaborates on JSON's architecture and structure, providing examples of JSON datasets ranging from basic key/value pairs to intricate combinations of nested arrays and objects. It also emphasizes the use of JSON in API testing, particularly with Postman, where JSON properties are accessed and tested using code snippets. The discussion includes methods for retrieving properties from arrays of objects and utilizing JavaScript functions to search and manipulate data, underscoring JSON's role in automated testing and validation workflows.

The introduction of the API Network Manager role and an optional approval process in Postman's Private API Network aims to enhance API governance and consistency across organizations. This new role allows users to manage APIs without the need to be a Super Admin, enabling them to add APIs to the Private API Network, create folders, and manage other API aspects. The approval process allows editors to request API additions, with notifications sent to API Network Managers for approval or denial, ensuring that APIs adhere to governance practices. These features are designed to streamline content curation, maintain security, and prevent bottlenecks, and are available on Postman's Enterprise plan.

PayPal has introduced a new public Postman Collection to make its APIs more accessible to developers with varying levels of coding expertise, following feedback about initial difficulties in using their APIs. Recognizing the diversity among PayPal developers—from those using no-code/low-code platforms to those building complex web applications—PayPal collaborated internally to create an interface that caters to all skill levels. The Postman Collection was tested extensively by hundreds of developers and PayPal staff to refine the user experience. It is now publicly available, aiming to facilitate seamless integration of PayPal payments. The blog post also provides a step-by-step guide on how to get started with the collection, emphasizing ease of use and encouraging users to engage with the collection and provide feedback.

May is recognized as Asian American and Pacific Islander (AAPI) Heritage Month in the United States, a time to celebrate the diverse cultures and significant contributions of Asians and Pacific Islanders. At Postman, this celebration aligns with their journey towards an API-first world, highlighting the entrepreneurial spirit and cultural heritage of their founders, who are part of this community. The company showcases the voices of its "API" Postmanauts through a video and shared quotes, emphasizing Postman's commitment to fostering belonging and inclusion in their work environment.

Postman, a platform known for its robust community, invites developers of all experience levels to contribute to its blog through a guest writer program. The program seeks original content focused on technical tutorials, thought leadership, and educational resources that explore the possibilities with APIs. Examples of successful contributions include tutorials on increasing resilience against breaking changes, exploring shift-left testing, automating tasks with API integrations, and utilizing Postman in healthcare tech. While the blog encourages diverse topics that resonate with the community, such as building projects or introducing new technologies, it explicitly discourages sales pitches, self-promotional content, and non-original material. Contributors are encouraged to submit their ideas following the blog's detailed submission guidelines, and those interested in non-writing contributions can engage with Postman through social media or explore job opportunities with the company.

The Postman Public API Network, renowned for hosting over 120,000 collections from major global brands, provides developers with access to public APIs and offers "utility collections" that enhance API workflows. These utility collections, created to improve the utilization of the Postman API Platform, include tools such as Joyce Lin’s Public Workspace Linter, Nick Schott’s API First Workflow Patterns, and Carson Hunter’s Workspace Cloning Utility, which streamline tasks like workspace analysis, synchronization of OpenAPI specifications, and workspace cloning. Developers are encouraged to create and share their own utility collections, following guidelines that emphasize simplicity, minimal setup requirements, comprehensive documentation, and respect for existing workspace data. By doing so, they can contribute to the collaborative ecosystem within the Postman Public API Network, benefiting a community of over 20 million users.

Kajal Hake, a Postman Student Leader since 2020 and a final-year BTech student at Usha Mittal Institute of Technology, organized a successful 10-day hackathon called We-Accinge in collaboration with various technical councils on her campus. The event, backed by organizations such as Postman and Devfolio, aimed to provide opportunities for student developers to collaborate, learn, and develop projects, especially focusing on API literacy using Postman. It featured mentors and judges from major companies like Barclays, Deutsche Bank, and JP Morgan Chase & Co. Over 80 students became certified Postman Student Experts, and more than 100 students utilized Postman's collaborative workspace, creating over 120 new public workspaces. Kajal emphasizes the importance of student communities in career development and encourages aspiring Postman Student Leaders to attend summits and meet-ups to leverage the opportunities and resources available through the program.

API-first is a strategy that emphasizes the prioritization of Application Programming Interfaces (APIs) in the development and operation of digital systems, recognizing them as vital components that enable connectivity, productivity, and quality across various platforms. This approach is crucial for maintaining competitiveness in the digital landscape, as APIs power a wide range of applications and devices by performing essential connectivity functions. Within API-first, several methodologies exist, including design-first, code-first, prototype-first, and proxy-first, each offering different paths to creating an effective API contract that supports documentation, validation, and discoverability. While design-first is often seen as the ideal approach due to its emphasis on collaboration and iterative testing, the choice of method should ultimately focus on meeting consumer needs and facilitating organizational transformation. The goal is to foster inclusivity and reduce friction in adopting API-first practices, allowing teams to choose the approach that best suits their workflows while ensuring the creation of efficient and consumer-friendly APIs.