ScreenSteps

Overview and Authentication (v2 JSON API)

Updated on

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?

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 contributor 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

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.

Previous Article What happens if I delete a site that is connected to Zendesk?
Next Article Example requests and responses (v2 JSON API)
Still Need Help? Contact Us