Sourcefabric Manuals

 English |  Español |  Français |  Italiano |  Português |  Русский |  Shqip

TagesWoche Newscoop 4.4 Implementation

Newscoop API

Newscoop has a Representational State Transfer Application Programming Interface (REST API) which can be configured from the administration interface, by clicking Configure, then API in the main Newscoop navigation menu. This API enables other programs, plugins and widgets to interact with Newscoop, for example getting a list of articles or creating a new user on the system. The API features are aimed at programmers who are integrating Newscoop with other newsroom and web publishing systems.

By default, all API features are hidden from the public. You can enable just the API features that you need public access to by clicking the checkboxes on this page.

Configure API 

The format of API responses is JavaScript Object Notation (JSON). For example, a request to http://newscoop.example.com/api/users.json for a list of users, on a system with only one user other than 'admin', might return:

{
    "items":[
        {
            "id":9,
            "email":"editor@example.com",
            "username":"editor",
            "firstName":"Mary",
            "lastName":"Contrary",
            "attributes":[
                
            ]
        }
    ]
}

API authentication

Authenticated API clients can be set up on the Clients tab. Click the Add Client button to register a new client and generate a client secret for it.

Add API client

Choose a name for the client application, the Newscoop publication you wish it to access, and the URI of the client application which parses the authentication token sent by Newscoop.

After clicking the Save button, the generated Client ID and Secret will be shown in the table.

Client secret

API documentation

Documentation for the Newscoop REST API is automatically generated at documentation/rest-api/ on your Newscoop server.

API documentation

Click on one of the coloured rows to show details of the API request.

API details

There has been error in communication with Booktype server. Not sure right now where is the problem.

You should refresh this page.