digikraaft / abokifx-php

src/ApiResource.php

<?php

namespace Digikraaft\Abokifx;

use Digikraaft\Abokifx\Exceptions\InvalidArgumentException;

class ApiResource
{
    const OBJECT_NAME = null;

    use ApiOperations\Request;

    /**
     * @return string the base URL for the given class
     */
    public static function baseUrl()
    {
        return Abokifx::$apiBaseUrl;
    }

    /**
     * @return string the endpoint URL for the given class
     */
    public static function classUrl()
    {
        $base = static::OBJECT_NAME;

        return "{$base}";
    }

    /**
     * @param string $slug
     *
     * @return string the endpoint URL for the given class
     */
    public static function endPointUrl($slug)
    {
        $slug = Util\Util::utf8($slug);
        $base = static::classUrl();

        return "{$base}/{$slug}";
    }

    /**
     * @param string $slug
     * @param null $params array of query parameters

Are you sure the doc-type for parameter $params is correct as it would always require null to be passed?

     *
     * @return string the endpoint URL for the given class
     */
    public static function buildQueryString($slug, $params = null)
    {
        $url = self::endPointUrl($slug);
        if (! empty($params)) {
            $url .= '?'.http_build_query($params);
        }

        return $url;
    }

    /**
     * @param $id
     * @return string
     * @throws InvalidArgumentException
     */
    public static function resourceUrl($id)
    {
        if (null === $id) {
            $message = 'Invalid ID supplied. ID cannot be null';

            throw new InvalidArgumentException($message);
        }
        $id = Util\Util::utf8($id);
        $base = static::classUrl();
        $extn = urlencode($id);

        return "{$base}/{$extn}";
    }
}