[buddypress-trac] [BuddyPress Trac] #9145: Move the BP REST API into BuddyPress core

[buddypress-trac]

#9145: Move the BP REST API into BuddyPress core
--------------------------------------+--------------------------
 Reporter:  espellcaste               |       Owner:  espellcaste
     Type:  task                      |      Status:  assigned
 Priority:  normal                    |   Milestone:  15.0.0
Component:  REST API                  |     Version:
 Severity:  normal                    |  Resolution:
 Keywords:  has-patch has-unit-tests  |
--------------------------------------+--------------------------

Comment (by imath):

 Hi @espellcaste

 I just did a code review, I'm adding this comment to it:

 > As to V2, we can actually create it whenever we want

 I'm worried this might mean: never or very very late...

 I've read again #8200. By the time BP was 6.0.0, the version after the BP
 REST API has been included in core (**5 years ago**) @boonebgorges was
 talking about "backward-incompatible API change requests" not about
 features.

 What's for sure is current API has a design weakness or inconsistency that
 is requiring a **v2**:
 - Every endpoint `get_item()`, `update_item()` and `create_item()` methods
 are wrongly returning a list of 1 object.
 - This inconsistency compared to the WP REST API makes the API less
 predictible.
 - BP will be 15.0.0, 10 major releases after the one the BP REST API was
 introduced and this weakness or inconsistency is still there.

 To me a serious and responsible move would be to hit 2 birds with one
 stone & avoid 2 big changes: the merge move and later (how many years?) a
 v2 move. If I suggested to use the "BP Classic" plugin to include the
 deprecated version(s) of the BP REST API this was to carry on moving
 forward while leaving the possibility to users still using plugins slowing
 down BuddyPress progress by keeping their code out of date to be able to
 preserve their community features. To me it's easier to say use "BP
 Classic" compared to use "BP Classic oh and if you need the deprecated
 version of the BP REST API, use also the BP REST API v1 backward
 compatibility plugin".

-- 
Ticket URL: <https://buddypress.trac.wordpress.org/ticket/9145#comment:8>
BuddyPress Trac <http://buddypress.org/>
BuddyPress Trac