New feature: Hardcore episode thumbnails ("hardcore_thumb") ... View Full Article
New feature: Hardcore episode thumbnails ("hardcore_thumb")
All of our episodes already provide a thumbnail (usually a headshot) in the 160x120 size. Now, we're also sending a second thumbnail, also 160x120, that shows a little more of the action.
Check out the new "hardcore_thumb" key in any set of episode data! View Less
Have you noticed that your API key(s) have a "Level" in your Settings page? What is that? ... View Full Article
Have you noticed that your API key(s) have a "Level" in your Settings page? What is that?
When you generate a new API key (or, get one automatically when you sign up), it has the "Development" level. There's also the "Approved" level, and a new level we've just added.
Approved: This key has full access to data. There's no cap on the "start" parameter, and "limit" is only limited on certain requests (some API requests do force you to paginate).
Development: Keys with the Development level can get at most two pages, with 10 items per page. The "start" value is limited to 10 and so is the "limit". You're free to use this key while you develop, but you should upgrade it to "Approved" if you want to use the whole library.
Demo: This is our new key level. Demo keys are for tools you create and plan to distribute (e.g. a blog plug-in that wraps the PV API). We don't want you distributing an Approved key because people using your software will be using your key and have no incentive to get their own. We recommend you give your users a way to enter their own key, and link them to our website. Demo keys have "start" and "limit" both capped at 1, meaning you can fetch two pages with one item each.
"But how do I get my key Approved?"
Head to our Support Page and choose "Project Approval Request". Tell us how to see what you've down with the API (a url is best, but if your implementation isn't a website, we can work with you to figure out how we'll review it) and we can probably get you approved pretty quickly.
"And why should I bother if my site works well with a Development key?"
We can't promise the restrictions on the dev keys will stay the same. Maybe you're fine with the 10-items-per-page limit. Maybe your site looks great! But if we change these limits later, you might find your site doesn't do what you want.
- the PinkVisual API dev team View Less
It's good to see so many of you trying out our new API. We've gotten some good feedback. Here is a list of things we've fixed: ... View Full Article
It's good to see so many of you trying out our new API. We've gotten some good feedback. Here is a list of things we've fixed:
The single-source request was returning its source in the "niches" key, which was an error. It now comes in the "sources" key.
CURL was on our user agent blacklist. This was an oversight because it was preventing CURL from being used to fetch our data.
Errors should no longer trigger 307 redirects. You should get a 404, plus the body of the page (in json or xml, as requested) stating the "errorcode" number and "error" message. If you still manage to get a 307 redirect, please let us know via the support form.
Have you had any other issues with the API? You can let us know with the "Support" button. We're interested in your feedback. View Less
You might have noticed that your API key says "Development". What does that mean? Well, it means we have to see your website/app and approve it before you have full access to our content. ... View Full Article
You might have noticed that your API key says "Development". What does that mean? Well, it means we have to see your website/app and approve it before you have full access to our content.
While your key is labeled "Development", you have two main limitations:
The "limit" value you pass to any API request cannot be higher than 10. If you pass a higher limit, or request no limit, it'll go to 10.
The "start" value can't be higher than 9. As with limit, we'll drop it to 9 if you ask for something higher.
Why start=9 and limit=10? Well, it lets you do the first 2 "pages" of any request at 10 items per page.
You can write your code with whatever start and limit you want, so that once we approve your API key, everything will start working normally.
Once you're ready to submit for approval, head on over to our Support page and send us the details. View Less
Through PV™ APi, Pink Visual® is making our data and content available to you, the developer. Aside from some very basic and Sensible rules (please see our Terms of Service) you are free to do with these resources as you like, from crafting mobile apps to creating a video interface that loads clips from our content database at random, or even authoring a game based on Pink Visual®'s data and content.