notion-py icon indicating copy to clipboard operation
notion-py copied to clipboard

Published 20 hours ago • verified publisher icon jamalex

Changes with official notion API?

Open horsto opened this issue 3 years ago • 5 comments

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?

horsto avatar May 14 '21 11:05 horsto

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

odeckmyn avatar May 14 '21 14:05 odeckmyn

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.

ramnes avatar May 14 '21 23:05 ramnes

@ramnes your work seems awesome ! thanks

odeckmyn avatar May 16 '21 18:05 odeckmyn

@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?

vintlucky777 avatar Jun 07 '21 23:06 vintlucky777

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.

ramnes avatar Jun 08 '21 06:06 ramnes