Comment on page
API
All notable changes to the REST API will be documented in this page.
We have changed the way we compute the feedback score based on user ratings which is affecting the following endpoint:
/v1/spaces/:id/insights/content
- [Updated]
score
is now calculated this way. This is done to reinforce negative ratings and help surfacing content that may require updates. - [Updated]
rating
is now computed this way'good'
whenever the score is > 0'ok'
whenever the score is 0'bad'
whenever the score is < 0
- [Added]
ponderedScore
is computed by multiplying thescore
by the total amount of ratings given by visitors.
Note: The GitBook app is displaying
ponderedScore
inside of the Insights section.We are introducing a collection of API endpoints to automate the management of members and teams in an organization:
Endpoint
/v1/owners/:id/spaces
has been removed and replaced by:/v1/orgs/:id/spaces
for an organization/v1/users/:id/spaces
for a user
Page previously had only one
path
property representing the page slug in its direct page parent. Pages will now include 2 properties:slug
: representing the page's slug in its direct parentpath
: representing the complete page's path in the revision
Requests on page using a URL will now require a URL encoded page's path. For example the previous request:
GET /v1/spaces/u23h2u4hi24/content/url/a/b/c
should now be:
GET /v1/spaces/u23h2u4hi24/content/path/a%2Fb%2Fc
Previously
POST /v1/spaces/:space/change-requests
was only returning the ID of the newly created change-request.The response will now contain the entire change-request object. A property
changeRequest
is appended for compatibility, but marked as deprecated and will be removed in the near future.Last modified 23d ago