search

jamalex / notion-py

Unofficial Python API client for Notion.so
MIT License
4.29k stars 474 forks source link

Changes with official notion API? #327

Open horsto opened 3 years ago

horsto commented 3 years ago

I just got an email informing about the new (beta) notion API (https://developers.notion.com/). I just wondered what this means (if anything) for the future of this repository here? Are there any significant changes / add-ons planned?

odeckmyn commented 3 years ago

I was about to ask the same question :-) thanks @horsto :-)

ramnes commented 3 years ago

FWIW I've rewritten most of the official JS client for their new API in Python: https://github.com/ramnes/notion-sdk-py

I wavered between contributing here and building this new client, but ultimately concluded that a fresh start would be much easier in this situation.

odeckmyn commented 3 years ago

@ramnes your work seems awesome ! thanks

vintlucky777 commented 3 years ago

@ramnes the official API they announced does follows the official beta API, that does not allow for 90% of the fine-grained features like block attributes (color, icon, cover, cover_position, etc.), many block types and more.

what are the benefits of switching to javascript SDK or your rewrite?

ramnes commented 3 years ago

Better guarantees and a brighter future. Endpoints from the unofficial API can get deprecated at any time, while the beta API will supposedly get more and more traction. But given the circumstances, using notion-py still makes a lot of sense if you need to do something that's not covered by the new API.