Understanding how the API works
The Piano API provides publishers with the most flexible and secure elements of the Piano platform, but requires developers in order to implement on your site. We wanted to write an article for those business people that want to use the flexibility of the API, but will be managing a development team to implement it.
The basic principles of Piano are:
1) Piano is a service that controls access to resources.
2) We grant access to resources after they’re purchased.
3) Access to the resource may be limited by time.
A resource is defined by the publisher. It can represent anything or many things: an article, a movie, a blog post, a pdf, access to a forum, all premium site content, a bundle of videos on a website, all the videos on your website etc. Defining what you want to sell and how to sell it is up to you and your developers! Perhaps you run a daily news site where you sell individual articles as well as access to entire sections of premium content. Not only can each article be a resource, but a access to the entire site could be a resource as well.
In the world of Piano, we’re all about access control. The Piano service tells you whether or not a user has access to a resource. The length of access can last forever or can be fixed for 24 hours, 30 days, 2 weeks, etc.
There are only two states to think about when integrating Piano. Either the user has access or they do not have access. When a user does not have access, it is up to the publisher to define the messaging that appears on the access denied landing page that the user will be directed to. Piano does not make any assumptions or requirements regarding how this page should be designed or displayed. The style and content of the access denied page is left entirely up to the publisher.
When access is granted, the publisher’s server will show the content without interference from Piano. In this scenario, your website will look and feel as it always has.
If you have any other questions about our API, drop us a line at firstname.lastname@example.org and we’ll connect you with a Piano implementation specialist.