SleepingOwl Apist
SleepingOwl Apist is a small library which allows you to access any site in api-like style, based on html parsing.
Overview
This package allows you to write method like this:
class WikiApi extends Apist
{
public function getBaseUrl()
{
return 'http://en.wikipedia.org';
}
public function index()
{
return $this->get('/wiki/Main_Page', [
'welcome_message' => Apist::filter('#mp-topbanner div:first')->text()->mb_substr(0, -1),
'portals' => Apist::filter('a[title^="Portal:"]')->each([
'link' => Apist::current()->attr('href')->call(function ($href)
{
return $this->getBaseUrl() . $href;
}),
'label' => Apist::current()->text()
]),
'languages' => Apist::filter('#p-lang li a[title]')->each([
'label' => Apist::current()->text(),
'lang' => Apist::current()->attr('title'),
'link' => Apist::current()->attr('href')->call(function ($href)
{
return 'http:' . $href;
})
]),
'sister_projects' => Apist::filter('#mp-sister b a')->each()->text(),
'featured_article' => Apist::filter('#mp-tfa')->html()
]);
}
}
and get the following result:
{
"welcome_message": "Welcome to Wikipedia",
"portals": [
{
"link": "http:\/\/en.wikipedia.org\/wiki\/Portal:Arts",
"label": "Arts"
},
{
"link": "http:\/\/en.wikipedia.org\/wiki\/Portal:Biography",
"label": "Biography"
},
...
],
"languages": [
{
"label": "Simple English",
"lang": "Simple English",
"link": "http:\/\/simple.wikipedia.org\/wiki\/"
},
{
"label": "العربية",
"lang": "Arabic",
"link": "http:\/\/ar.wikipedia.org\/wiki\/"
},
{
"label": "Bahasa Indonesia",
"lang": "Indonesian",
"link": "http:\/\/id.wikipedia.org\/wiki\/"
},
...
],
"sister_projects": [
"Commons",
"MediaWiki",
...
],
"featured_article": "<div style=\"float: left; margin: 0.5em 0.9em 0.4em 0em;\">...<\/div>"
}
Installation
Require this package in your composer.json and run composer update (or run composer require sleeping-owl/apist:1.x
directly):
"sleeping-owl/apist": "1.*"
Documentation
Documentation can be found at sleeping owl apist.
Examples
View examples.
Support Library
You can donate via PayPal, Yandex money (410012943296949) or in BTC: 13k36pym383rEmsBSLyWfT3TxCQMN2Lekd
Copyright and License
Apist was written by Sleeping Owl and is released under the MIT License. See the LICENSE file for details.