<?php

class Api
{
    /**
     * Auto routed method which maps to POST api/method/{param1}
     *
     * @param int       $param1 map to url
     * @param array     $param2 map to request body
     * @param string    $param3 map to query string
     *
     * @return string
     */
    public function postMethod($param1, array $param2, $param3 = 'optional')
    {
        return 'you have called Api::postMethod()';
    }

    /**
     * Auto routed method that creates all possible routes.
     * This was the standard behavior for Restler 2
     *
     * @smart-auto-routing false
     */
    public function soManyWays($p1, $p2, $p3 = 'optional')
    {
        return 'you have called Api::soManyWays()';
    }

    /**
     * Manually routed method. we can specify as many routes as we want
     *
     * @url POST method2
     * @url POST method2/{anything}
     * @url GET what/ever/you/want
     */
    public function whatEver($anything)
    {
        return 'you have called Api::whatEver()';
    }

    /**
     * Manually wildcard routed method. all paths that begin with `all` will be
     * routed to this method
     *
     * @url GET all/*
     */
    public function allIsMine()
    {
        return 'you have called Api::allIsMine('
            . implode(', ', func_get_args())
            . ')';
    }
}