ScreenStepsIntegrationsScreenSteps API v2 JSON APIOverview and Authentication (v2 JSON API)

Overview and Authentication (v2 JSON API)

The ScreenSteps v2 JSON API is designed to allow you to:

  • Extract content from your ScreenSteps site for backup purposes
  • Extract content from your ScreenSteps site for publishing to other systems
  • Create and update content in your ScreenSteps account

Important: If you are using the API to pull the HTML from your ScreenSteps site and display it in your own website then you will need to update the image permission settings for your site to get non-expiring image URLs.

See: Why are the links to my images broken?

Security and authentication

All API requests must be done over SSL. Authentication is done using basic authentication with:

  • Your ScreenSteps login and password, or
  • Your ScreenSteps login and an API token

See: How to create an API Token

API tokens are account wide and are not tied to an individual user on your account. 

If you want to limit the access of an integration to your content then you should use a username/password combination for a user who has the permissions you want.

For example, if you only want an integration to have access to a single site on your account then you should create an Author or Reader user, assign them to the site and use their username/password for the integration.

Basic authentication

Use the following format:

{login}:{api_token or password}
curl -u me@example.com:st_lOXL-sHouKuTan3i-LtOgg https://myaccount.screenstepslive.com/api/v2/sites.json
How to generate an API token
  1. Click on Account
  2. Click on API Tokens

Click on Create API Token.

Request format

You must set an Accept: application/json header on all requests.

Response format

All responses will be in JSON format.

Will unpublished content be returned by the API?

If you are using the search API then no unpublished articles will be returned.

If you are listing the contents of a site, manual, or chapter then it depends on the type of user that you are authenticating with. For api and reader users unpublished content is not returned. For admin and editor users unpublished content is returned.

2 Comments

Travis Thelen

How do I make an authenticated request to the v2 API? For example the site search call.

Trevor DeVore

@Travis - All authentication is done using Basic access authentication. The "Security and authentication" section of this article explains the format to use with Basic access authentication and provides an example of making the call with curl.

Add your comment

E-Mail me when someone replies to this comment