Page

A document, for example world.silk.co/page/Monaco.

Site

Page

User

Taglist 

Query 

FAQ

Facts collected from tagged text on this page
Facts about this page

Introduction

The content on Silk site is in the pages. The word page and document is used here interchangeably.  Here is an overview of API calls related to pages.

We recently made big changes to our page structure, so some of these parts of the API still needs to be documented. Please drop a note at support@silk.co if you have questions!

Get a page

To get the contents of a page, simply GET the page, this can be done without any additional parameters if the site is public:

Page structure

Basic structure

The structure of a page with a left and right column.

This two column lay-out is the basic structure of a page in Silk. It is possible to add multiple sections or have only one column, but it is not recommended. The page might still work but can possibly not be edited in the browser.

Semantic information

Semantic information can be added to pages by using tags. Tags are datapoints within pages (also see taglist). The syntax for tags in pages (hint: HTML5 data- attributes) looks like this:

Tags and categories are the building blocks of Silk pages. It is highly recommended that you use tags for data and give categories to pages. Doing so will allow you to filter, search and visualize information in your site.

Components (maps, graphs, etc)

Components like maps, graphs or images can be added to pages. For the left column you can add the following components (this is a recommendation):



Text, image, map, media, table of contents, data table.

For the right (main) column you can add the following components:



Text, image, map, pie chart, line chart, table, media, list of recently modified documents and a bar chart. 

In the XML of the pages, the attribute data-component-uri is added to divs to indicate which component is used.

Update or create a page

To update or create a page PUT the content like this

If the page already exist, this action will replace the contents (also see versions), if the page does not exist, the page is created. Remember, page names are case sensitive.

Versions

Silk keeps versions of each edited page. To get a list of the versions for a page do

To see versions for a page, you can also point your browser to a page and append /version to the url. 

Autosaves

While editing a page, every few seconds an autosave is made by Silk. When the user clicks Save, the autosave is removed. To get the autosaves (one per user per page), do: