FAQs
General
What is the status of this project?
Standards and Best Practices
What is FAIR?
Which domain standards/specifications are recommended?
This project aligns with global standards and best practices endorsed by high‑value data producers, custodians, and user communities. Our work is guided by the FAIR principles and CODATA’s Cross‑Domain Interoperability Framework (CDIF).
See our overview of Standards & Best Practices for the specifications we currently support and prioritize.
Technologies
Which data API platforms and public services are supported?
The following platforms and public APIs are currently actively being integrated with:
- U.S. Census Bureau API: access to key demographic and economic indicators for the United States
- Socrata / Data Insights: a cloud‑based open data platform widely used by major cities and public agencies in North America
- MTNA Rich Data Services: a modern platform providing integrated access to data and metadata, with robust web‑based user interfaces
Our pipeline includes APIs from the World Bank and other custodians.
On the data cataloging side, we anticipate integration with:
Other options for providing API access to data include DreamFactory, Redivis, and OpenDataSoft. GraphQL also presents promising patterns with a range of open‑source and commercial solutions.
What is Postman?
At its core, Postman provides a comprehensive set of tools designed to streamline the entire API lifecycle. This includes robust capabilities for API documentation, seamless collaboration among teams, rigorous testing, continuous monitoring, and the orchestration of complex API workflows, increasingly augmented by advanced AI features.
Postman offers flexible plans to suit various needs, from a free tier for individual developers to Team and Enterprise plans for larger organizations.
Critically, Postman is engineered to make APIs FAIR (Findable, Accessible, Interoperable, and Reusable), embodying this commitment through its platform design and features. It serves as a powerful metadata and collaboration hub for APIs:
- Findable: APIs become easily discoverable through features like the Postman Discovery Network, allowing developers to quickly locate and understand available APIs.
- Accessible: Postman facilitates access through organized Workspaces and Collections, comprehensive API documentation, and direct interaction with APIs within the platform.
- Interoperable: For teams and enterprises, Postman promotes interoperability through collaborative features, Flows for chaining requests, support for API standards, and robust governance capabilities that ensure consistency across an organization's API landscape.
- Reusable: The platform encourages reusability by allowing developers to easily fork collections, integrate with version control systems like GitHub, and leverage a wide array of other integrations to incorporate APIs seamlessly into new projects.
By unifying the API development experience, Postman empowers developers and organizations to build, manage, and consume APIs more efficiently and effectively, aligning with the principles of open, well-managed API ecosystems.
What are data-centric Postman collections?
Unlike traditional application developers who care about APIs, data users naturally think in terms of 'datasets'. APIs are secondary or even a foreign concept to them. Their focus is on discovering and accessing ‘data’ to support their work and mission.
A data-centric collection is a resource that represents a well-documented dataset and its underlying APIs. It meets the needs and perspectives of high-value data users or agents by providing a view of APIs that make sense to them. In this case, there is a one-to-one relationship between a collection and a dataset: 1 dataset = 1 collection.
Such collection not only provides access to data endpoints, but also ‘metadata’ endpoints, delivering the combined knowledge in machine-friendly standard formats. The embedded documentation talks about the dataset, its structure, content, provenance, how to use it, and other aspects necessary for the effective use of high-value data.
The objective is also to demystify APIs and make them understandable and consumable by potentially less tech-savvy users. It further provides a collaborative space where data users and developers can come together and help each other.
Data-centric collections are also an entry point to other Postman features, particularly Flows, which can be used to stitch multiple data sources together or automate analytical pipelines.