First Look at Notion’s Public API

API Style

Cursor-based pagination (https://developers.notion.com/reference/pagination)

Versioning

  • Date-based versions.
  • Additive changes are added to all versions, only breaking changes require a new one.
  • Versions are selected through a header.
  • URL versioning is present, but only in the rare case where it’s needed. (A brand new API, very large change, etc)

Documentation

https://developers.notion.com/reference/get-database
https://developers.notion.com/page/examples

Auth

--

--

--

#GraphQL Enthusiast, Speaker, Senior Software Developer @ Netflix 📖 Book is now available https://book.productionreadygraphql.com/

Love podcasts or audiobooks? Learn on the go with our new app.

Recommended from Medium

https://t.me/Pitbull_vbot?start=r0830000033

60 days to become a game developer. Day 51 .

Modeling Typescript Interfaces to support Angular HTTP requests

How to avoid a Deadlock while writing Concurrent Programs — Java Example

How to avoid deadlock in Java?

Knowledge Graph Representation: TypeDB or OWL?

5 Best Python Frameworks for Web Development in 2022

best Python frameworks for web development

Introduction to Matrix Architecture

Get the Medium app

A button that says 'Download on the App Store', and if clicked it will lead you to the iOS App store
A button that says 'Get it on, Google Play', and if clicked it will lead you to the Google Play store
Marc-André Giroux

Marc-André Giroux

#GraphQL Enthusiast, Speaker, Senior Software Developer @ Netflix 📖 Book is now available https://book.productionreadygraphql.com/

More from Medium

Sharing scalars between modules with Chimp

My Tests are Broken Again, Part 2: Examining a new Approach

Research project: Which is the best caching strategy with GraphQL for a big relational database?

Make your CI faster and improve developer experience: Upgrade to Yarn >2 with (or without)…