API Basics

A quick overview of how the PosterMyWall API behaves.

REST

The PosterMyWall API is RESTful. The API is currently read-only, so most operations only accept HTTP GET requests.

JSON

The PosterMyWall API speaks exclusively in JSON. Always set the Content-Type header to application/json so your requests are accepted and processed correctly.

Request throttling

Requests to the PosterMyWall API are limited to 300 requests per minute per registered application.

Authentication

Some endpoints only need your application’s API key. Others require a user to authorize your app with OAuth 2.0. See Authentication for how each type of call works.

Errors

The API always returns HTTP 200, even for failed requests, and reports the failure in the response body instead. See Error Handling for the full convention and a list of error codes.

Full endpoint list

For the complete set of endpoints, parameters and response schemas, see the API Reference.