API Version: 1.0001
GranNino Api provides uploaded artworks feed for registered artists. This Api feed can be embeded to any type of hosting sites with registered domain. Free Api provides upto 15 posts ordered by popularity or by uploaded dates. Regsitered artists can apply for free Api. For more than 15 posts, users can apply for paid version.
REQUEST AND WORKING METHOD
This simple Javascript API calls the user data from the main server as JSON format and processed it to html format, which can be directly called to the desired webpage at any specific place.
API PRICING COMPARISON
- Free
- Free Forever
- Maximum 15 items calling
- Single Domain
- Single Account
- No integration support
- No Customisation support
- Pro
- $ 20.00 / month (Billed Annually)
- Maximum 200 items calling
- Single Domain
- Single Account
- Integration support (Initial)
- On Demand Customisation (One Time)
- Premium
- $ 100.00 / month (Billed Annually)
- Unlimited calling
- 5 Domains
- 5 Accounts
- Integration support (Initial)
- Customisation (On demand for each domain)
REQUEST FOR API KEY
PARAMETERS
Parameter | Details | Checklist |
---|---|---|
username | GranNino registered username | Required |
public_key | GranNino offered API Public Key | Required |
limit | No of posts | Optional |
order | Based on popularity or upload time | Optional |
GalBg | Background color of the Gallery | Optional |
GalColor | Color of caption text in Gallery | Optional |
GalBorder | Color of caption border in Gallery | Optional |
GalHeader | Title of the Gallery | Optional |
LIBRARY DEPENDENCY
The API requires latest version of jquery.min.js plugin. Place the library code (copy from below) just before the API call scripts.
API CALL EXAMPLE
<div class="gncardblock"><header></header><div class="gncard"></div>
<script> //requires jquery.min.js plugin
const username = "username"; //Put your GranNino username here
const public_key = "74a298f973tadsrawseaaafc49a37e9c85"; //Put your API key here.
const limit = 15;
const order = "popularity"; //id, popularity etc.
const GalHeader = "My Art Gallery";
const GalBg = "#252424";
const GalColor = "#ffffff";
const GalBorder = "#4b4646";
const script = document.createElement("script");
script.async = true;
script.src = "https://api.grannino.com/puller.js";
document.body.appendChild(script);
</script>
Note: Place the code between body tags or in the place where you want to place your online art Gallery.
API RESPONSE (JSON FORMAT)
{
"artist":"username",
"artwork":"image-file-painting02_2022-09-08-23-44-31-082.jpg",
"description":"Description of the artwork",
"link":"2912/title-of-the-art-work"
}