<?php

declare(strict_types=1);

namespace DomainWarn\WordPress\Service;

/**
 * Der eine Weg nach außen. In WordPress steckt dahinter die HTTP-API (`wp_remote_request`), im Test ein Doppel –
 * so bleibt DomainWarnApi frei von WordPress und damit ohne Installation prüfbar.
 */
interface HttpTransport
{
    /**
     * @param  array<string, string>  $headers
     * @param  ?array<string, mixed>  $json
     *
     * @throws TransportException wenn die Gegenstelle nicht erreichbar ist
     */
    public function request(string $method, string $url, array $headers = [], ?array $json = null): TransportResponse;
}