1 year ago

In this article, I'd like to focus on working with 3rd party services. In this article, I'll write a Gumroad (e-commerce) SDK in three different ways: Using one service for the whole API.

Get one product by ID: namespace App\Services\Gumroad; class GumroadService { public function product(string $id): ProductData { $product = Http::get( $this->url("products/$id"), $this->query(), )->json('product'); return ProductData::fromArray($product); }}

As you can see, I still use the url and query helpers, but now they are in the base Request class: namespace App\Services\Gumroad\Requests; abstract class Request { public function __construct( protected readonly string $accessToken, protected readonly string $uri, ) {} protected function query(array $extra = []): array { return [ 'access_token' => $this->accessToken, ...$extra, ]; } protected function url(string $path): string { return "{$this->uri}/$path"; }}

To solve these problems we can keep the GumroadService class as an entry point to access these requests: namespace App\Services\Gumroad; class GumroadService { public function sales(?Carbon $after = null): Collection { return app(GetSalesRequest::class)->send($after); } public function products(): Collection { return app(GetProductsRequest::class)->send(); } public function product(string $id): ProductData { return app(GetProductRequest::class)->send($id); }}