LibraryService

CreateBook

Creates a book, and returns the new Book.

post/v1/shelves/{shelf}/books

Path parameters

shelfstring required

The shelf id.

Request body

namestring required

The resource name of the book. Book names have the form shelves/{shelf_id}/books/{book_id}. The name is ignored when creating a book.

authorstring

The name of the book author.

titlestring

The title of the book.

readboolean

Value indicating whether the book has been read.

borrow_timestring date-time

The previous borrowing timestamp.

created_atstring date-time

The creation date and time.

updated_atstring date-time

The last update date and time.

Response

OK

namestring required

The resource name of the book. Book names have the form shelves/{shelf_id}/books/{book_id}. The name is ignored when creating a book.

authorstring

The name of the book author.

titlestring

The title of the book.

readboolean

Value indicating whether the book has been read.

borrow_timestring date-time

The previous borrowing timestamp.

created_atstring date-time

The creation date and time.

updated_atstring date-time

The last update date and time.

Changes

Changed in 8 of the 12 revisions of this API.117

Apr 11, 2022v1ac9d37cae0e02See the full diff
- ▲
  the request's body type changed from no type to object
  request-body-type-changed
- ▲
  the response's body type changed from no type to object for status
  response-body-type-changed
Feb 23, 2022v1639a4ec995ca11See the full diff
- ▲
  the request property became required
  request-property-became-required
- ○
  the response property became required for the status
  response-property-became-required
Jan 12, 2022v1dbd82bd71d471See the full diff
- ▲
  the response's property format changed from RFC3339 to date-time for status
  response-property-type-changed
Jan 12, 2022v100e696b6b84a21See the full diff
- ▲
  added the pattern ^shelves/[a-z2-7]{26}/books/[a-z2-7]{26}$ to the request property
  request-property-pattern-added
- ▲
  the response's property format changed from date-time to RFC3339 for status
  response-property-type-changed
- ○
  the response's property pattern ^shelves/[a-z2-7]{26}/books/[a-z2-7]{26}$ was added for the status
  response-property-pattern-added
Jan 12, 2022v1fab7e7c2f60c1See the full diff
- ▲
  the response's property format changed from RFC3339 to date-time for status
  response-property-type-changed
Jan 11, 2022v12a0f5e3b87341See the full diff
- ○
  api operation id CreateBook removed and replaced with LibraryService_CreateBook
  api-operation-id-removed
Jan 11, 2022v10dea6034d9691See the full diff
- ○
  api operation id LibraryService_CreateBook removed and replaced with CreateBook
  api-operation-id-removed
Dec 9, 2021v11f7e8ced536943See the full diff
- ▲
  the request's body type changed from object to no type
  request-body-type-changed
- ▲
  the response's body type changed from object to no type for status
  response-body-type-changed
- ▲
  the response property became optional for the status
  response-property-became-optional
- ▲
  the response's property format changed from date-time to RFC3339 for status
  response-property-type-changed
- ○
  the request property became optional
  request-property-became-optional
- ○
  removed the pattern ^shelves/[a-z2-7]{26}/books/[a-z2-7]{26}$ from the request property
  request-property-pattern-removed
- ○
  the response's property pattern ^shelves/[a-z2-7]{26}/books/[a-z2-7]{26}$ was removed for the status
  response-property-pattern-removed
This revision also has 2 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog