snicksnk/maitavr-api

Api for maitavr.org

Maitavr-api

Библиотека для работы с api maitavr.org, _(*1)

Установка через composer

Добавьте в composer.json, _(*2)

"require": {
    "snicksnk/maitavr-api": "0.1.*@dev"
}

И выполните, _(*3)

php composer.phar update

Основные компоненты системы

• Базовый класс api MaitavrApi\Api
• Запрос списка пользователей MaitavrApi\Request\Users\UList
• Запрос количества пользоватлей MaitavrApi\Request\Users\Count
• Stream context transport MaitavrApi\Transport\StreamContext - средство доставки запросов по умолчанию

Параметры, которые позволяют изменить поля, приходящие от сервера

Если не используется не один из этих параметров в ответ приходят все поля, _(*4)

• Список полей, которые можно получить в ответе, _(*5)

• MaitavrApi\Request\Users\UList::__construct(array $rows) - передать список полей в виде массива в конструктор (ранее заданные поля будут заменены переданными в этот метод), _(*6)

• MaitavrApi\Request\Users\UList::setRows(array $rows=null) - задать список полей в виде массива, _(*7)

• MaitavrApi\Request\Users\UList::addRow($rowName) - добавить одно новое поле в ответ, _(*8)

Фильтрация:, _(*9)

• Фильтр, который можно применить к ответу, _(*10)

• MaitavrApi\Request\Users\UList::addFilter($rowName, $value) - Добавить фильтр, _(*11)

Пример использования

<?php
use MaitavrApi\Api;
use MaitavrApi\Request\Users\Count;
use MaitavrApi\Request\Users\UList;

//Подключаем автолоадер, если не используется composer
require (__DIR__.'/../src/Tools/CompleteAutoloader.php');

//Создаем инстанс API класса
$api = new Api('testapi', 'test12345678');

//Создаем объект запроса и передаем в конструктор поля, которые мы хотим видить в ответе
$request = new UList(array(UList::ROW_FIRSTNAME, UList::ROW_LASTNAME, UList::ROW_EMAIL));

//Добавляем фильтр по email адресу в запрос 
$request->addFilter(UList::FILTER_EMAIL, array('andrey_ivanov@ukr.net', 'galkina@i.ua'));

// Делаем запрос на сервер и получаем ответ в виде массива
$response = $api->request($request);
var_dump($response);
/*
array(2) {
  [0] =>
  array(3) {
    'firstname' =>
    string(18) "Александр"
    'lastname' =>
    string(12) "Галкин"
    'email' =>
    string(12) "galkina@i.ua"
  }
  [1] =>
  array(3) {
    'firstname' =>
    string(12) "Михаил"
    'lastname' =>
    string(14) "Сидоров"
    'email' =>
    string(21) "andrey_ivanov@ukr.net"
  }
}
*/

Другие примеры, _(*12)