$payload */ public function send(string $type, array $payload, string $idempotencyKey, int $timeout = 10): FeedbackResult { try { $response = VendorHttp::guard(fn () => $this->http->request($timeout, identifyDevice: false) ->withHeaders(['Idempotency-Key' => $idempotencyKey]) ->post($this->url($type), $payload)); } catch (ServerError $e) { return FeedbackResult::retry('Der Server ist nicht erreichbar.'); } $data = $response->json() ?? []; return match (true) { $response->status() === 201 || ($response->successful() && isset($data['reference'])) => FeedbackResult::sent((string) ($data['reference'] ?? '')), $response->status() === 404 => FeedbackResult::disabled(), $response->status() === 422 => FeedbackResult::invalid($this->fieldErrors($data), $data['error'] ?? $data['message'] ?? null), $response->status() === 429 => FeedbackResult::rateLimited($this->retryAfter($response->header('Retry-After'), $data)), // 409: dieselbe Meldung wird gerade verarbeitet – kurz warten, dann erneut (kein Fehler). $response->status() === 409 => FeedbackResult::retry('Wird bereits verarbeitet.', 30), default => FeedbackResult::retry('Server antwortet mit HTTP '.$response->status().'.', $this->retryAfter($response->header('Retry-After'), $data)), }; } private function url(string $type): string { return rtrim(config('updater.api_url'), '/').'/software/'.config('updater.software').'/'.$type; } /** * Unterstützt {"errors": {"feld": ["Grund"]}} und {"field": "feld", "error": "Grund"}. * * @param array $data * @return array */ private function fieldErrors(array $data): array { $errors = []; if (is_array($data['errors'] ?? null)) { foreach ($data['errors'] as $field => $messages) { $errors[(string) $field] = is_array($messages) ? (string) reset($messages) : (string) $messages; } } if (is_string($data['field'] ?? null)) { $errors[$data['field']] = (string) ($data['error'] ?? $data['message'] ?? 'Ungültige Eingabe.'); } return $errors; } /** * @param array $data */ private function retryAfter(?string $header, array $data): ?int { $value = $data['retry_after'] ?? $header; return is_numeric($value) ? (int) $value : null; } }