# Quickstart

In this quickstart, we'll guide you through the most important functionalities of the package and how to use them.

In order to send a request. You should create a Connector class that implements Fansipan\Contracts\ConnectorInterface interface and add Fansipan\Traits\ConnectorTrait trait to the connector to fullfil the contract interface.

Additionally, you can set the request base URI by utilizing the baseUri static method. If a relative URI is specified in the request endpoint method, the connector will merge the base URI with the relative URI, following the guidelines outlined in RFC 3986, section 5.2.

<?php

use Fansipan\Contracts\ConnectorInterface;
use Fansipan\Traits\ConnectorTrait;

final class Connector implements ConnectorInterface
{
    use ConnectorTrait;

    public static function baseUri(): ?string
    {
        return 'https://mydomain.com/api';
    }
}

Let's say you want to send a request to https://httpbin.org/headers. Create GetHeadersRequest class that extends the Fansipan\Request abstract class and set the uri in endpoint public method. That's all.

<?php

use Fansipan\Request;

final class GetHeadersRequest extends Request
{
    public function endpoint(): string
    {
        return 'https://httpbin.org/headers';

        // If your connector has a defined base URI, then it can be
        return '/headers';
    }
}

Now you should be able to send the request:

$connector = new Connector();
$request = new GetHeadersRequest();
$response = $connector->send($request);

The request above will return an instance of Fansipan\Response, which provides a variety of methods that may be used to inspect the response:

if ($response->failed()) {
    return;
}

$data = $response->data();

// Perform your application logic.

You may be wondering where to find the HTTP client or how to customize it. In order to learn more about this topic, be sure to explore the next chapter, which delves into connectors, requests and responses.