feat: add support for bookmarks

closes #44

Author: dp3000

doc/web-links.md

@@ -1,32 +1,55 @@
 # Web Links
 
-Web link objects represent a web link (bookmark) from a user's account. They can perform common web link operations, like create, read, update, and delete.
+Represents a web link (bookmark) on Box
 
 ## Get a Web Link's Information
 
-Calling `getWebLinkInfo()` on a web link returns a snapshot of the web link's info.
-
 ```java
 BoxWebLink webLink = new BoxWebLink(api, 'web-link-id');
 BoxWebLink.Info info = webLink.getWebLinkInfo();
 ```
 
-## Update a Web Link's Information
+## Create a Web Link
+
+```java
+BoxWebLink webLink = new BoxWebLink(api, null);
+BoxWebLink.Info info = new BoxWebLink.Info('{"url":"https://www.salesforce.com/", "parent": {"id": "0"}, "name": "Salesforce", "description": "Link to Salesforce"}');
+BoxWebLink.Info created = webLink.createWebLink(info);
+```
 
-Updating a web link's information is done by creating a new `BoxWebLink.Info` object or updating an existing one, and then calling `updateWebLinkInfo(BoxWebLink.Info)`.
+## Update a Web Link's Information
 
 ```java
-BoxWebLink webLink = new BoxWebLink(api, '12303730068');
+BoxWebLink webLink = new BoxWebLink(api, 'web-link-id');
 BoxWebLink.Info info = webLink.getWebLinkInfo();
-info.addValue('description', 'Some web link I made');
+info.addValue('description', 'a descriptive description');
 BoxWebLink.Info updated = webLink.updateWebLinkInfo(info);
 ```
 
 ## Delete a Web Link
 
-A web link can be deleted with the `deleteWebLink()` method.
-
 ```java
 BoxWebLink webLink = new BoxWebLink(api, 'web-link-id');
 webLink.deleteWebLink();
 ```
+
+## Get a Trashed Web Link's Information
+
+```java
+BoxWebLink webLink = new BoxWebLink(api, 'web-link-id');
+BoxWebLink.Info info = webLink.getTrashedWebLinkInfo();
+```
+
+## Restore a Trashed Web Link
+
+```java
+BoxWebLink webLink = new BoxWebLink(api, 'web-link-id');
+BoxWebLink.Info info = webLink.restoreTrashedWebLink();
+```
+
+## Permanently Delete a Web Link
+
+```java
+BoxWebLink webLink = new BoxWebLink(api, 'web-link-id');
+webLink.permanentlyDeleteWebLink();
+```