https://github.com/naftiko/notion-sandbox
This is an API sandbox for the Notion API.
https://github.com/naftiko/notion-sandbox
bruno notion-api openapi sandbox
Last synced: 3 months ago
JSON representation
This is an API sandbox for the Notion API.
- Host: GitHub
- URL: https://github.com/naftiko/notion-sandbox
- Owner: naftiko
- Created: 2026-01-16T21:16:01.000Z (6 months ago)
- Default Branch: main
- Last Pushed: 2026-02-14T01:09:49.000Z (5 months ago)
- Last Synced: 2026-02-14T08:21:27.737Z (5 months ago)
- Topics: bruno, notion-api, openapi, sandbox
- Language: Bru
- Homepage:
- Size: 213 KB
- Stars: 2
- Watchers: 0
- Forks: 1
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Notion Sandbox
This is sandbox for the Notion Sandbox API, using an OpenAPI specification with examples, Microcks and Bruno as the sandbox interface, and this GitHub repository as the vehicle for delivering as a localized sandbox, or also enabling the working directly with production APIs.
## APIs.json Index
There is an APIs.yml file in the root of this repository, providing an index of all the artifacts used as part of this capability, providing a machine-readable way to read, manage, and execute the resources available here.
## OpenAPI
This capability uses OpenAPI as the definition, providing a complete definition of all available paths for the Notion Sandbox. The OpenAPI for this capability uses examples and Microcks extensions to mock the requests and responses for each API operation, something we will iterate and expand upon with richer examples as the capability evolves.
## Microcks
This capability uses Microcks to deliver the mock API. [You just install Microcks, with the Docker extension being the easiest](https://microcks.io/documentation/guides/installation/docker-desktop-extension/), [import the OpenAPI as a service](openapi/notion-openapi.yml), and you have a mocked API for all APIs, available via REST and MCP APIs--providing a multi-protocol sandbox.
## Bruno
This capability [uses Bruno as the client](https://www.usebruno.com/), leveraging Bruno Collections pre-generated from the OpenAPI and Bruno environments that uses the localhost and port of Microcks to work with the mocked API. You just have to install Microcks, then open the collection provided in this repository, select the available environments, and begin calling the Notion Sandbox via the sandbox or production.
## OpenAPIs
These are the OpenAPIs available for the Notion Sandbox, which are made available via this sandbox API, which can be imported into Microcks and deployed as a sandbox using their mock feature.
- [Notion Openapi](openapi/notion-openapi.yml)
## Support
Please provide any questions or feedback via GitHub issues, or just email kinlane@naftiko.io with feedback. The goal is to keep iterating upon this sandboxes using existing OpenAPI, Microcks, and Bruno features, offering value out of the box via this forkable capability.