{
  "error": "rate_limit_exceeded",
  "message": "Превышено 60 запросов в минуту, повторите через 15 секунд",
  "retryable": true,
  "requestId": "req_01HX9JKP7QZK7M5T2N4F8R6Y3W",
  "docsUrl": "https://docs.aacsearch.com/troubleshooting/rate-limits"
}

{
  "error": "rate_limit_exceeded",
  "message": "Превышено 60 запросов в минуту. Повторите через 15 секунд."
}

X-RateLimit-Limit: 60            // Максимум запросов за минуту
X-RateLimit-Remaining: 42        // Запросов осталось в текущей минуте
X-RateLimit-Reset: 1717201234    // Когда сбросится (Unix время)
Retry-After: 15                  // Если лимит превышен: подождите столько секунд

try {
  const results = await client.search({ q: "shoes" });
} catch (err) {
  if (err.code === "rate_limit_exceeded") {
    console.log("Лимит исчерпан, подожду 15 секунд...");
    setTimeout(() => {
      // Повторить запрос
    }, 15000);
  }
}

// JavaScript с библиотекой p-retry
import pRetry from "p-retry";

const results = await pRetry(
  () => client.search({ q: "headphones" }),
  {
    retries: 3,           // Максимум 3 попытки
    factor: 2,            // Экспоненциальная задержка: 1s, 2s, 4s
    minTimeout: 1000,     // Минимум 1 секунда между попытками
  }
);

# Python с retry
from retry import retry

@retry(tries=3, delay=1, backoff=2)
def search():
    return client.search(q="headphones")

results = search()

import { SearchClient } from "@aacsearch/client";

try {
	const result = await client.search({ q: "shoes" });
} catch (err) {
	if (err instanceof AacSearchError) {
		console.error("aacsearch error", {
			code: err.code,
			requestId: err.requestId, // для тикетов в поддержку
			traceId: err.traceId, // для дашбордов distributed tracing
		});
	}
}

const result = await client.search(opts);
logger.info({
	event: "search.ok",
	requestId: result.requestId,
	searchTimeMs: result.searchTimeMs,
});

import { AacSearchError } from "@aacsearch/client";

try {
	await client.search({ q: "shoes" });
} catch (err) {
	if (err instanceof AacSearchError) {
		err.code; // string — код ошибки из тела, стабильный
		err.message; // string — для людей
		err.status; // number — HTTP status (0 для сетевых ошибок)
		err.retryable; // boolean — из тела, fallback к status >= 500
		err.requestId; // string | undefined
		err.traceId; // string | undefined
		err.docsUrl; // string | undefined
		err.response; // Response | undefined — сырой fetch Response если доступен
	}
}

function SearchInvalidKey({ requestId }: { requestId?: string }) {
	return (
		<div role="alert" className="search-error">
			<h3>Поиск настроен некорректно</h3>
			<p>Ваш API-ключ невалиден, истёк или был отозван.</p>
			<p>
				Если вы владелец сайта — выпустите новый ключ в панели AACsearch. Иначе попробуйте позже.
			</p>
			{requestId && <small>Reference: {requestId}</small>}
		</div>
	);
}

function SearchQuotaExceeded({ resetDate }: { resetDate: Date }) {
	return (
		<div role="alert" className="search-error">
			<h3>Поиск временно недоступен</h3>
			<p>Сайт исчерпал месячный лимит поиска.</p>
			<p>Сервис восстановится {resetDate.toLocaleDateString()}.</p>
			<p>
				<a href="https://app.aacsearch.com/billing">Сменить тариф</a>
			</p>
		</div>
	);
}

function NoResults({ query }: { query: string }) {
	return (
		<div className="no-results">
			<h3>Ничего не найдено по &quot;{query}&quot;</h3>
			<p>Попробуйте более короткий запрос, другие ключевые слова или просмотрите наши категории ниже.</p>
			<a href="/c/all">Все товары →</a>
		</div>
	);
}

function SearchUnavailable({
	requestId,
	onRetry,
}: {
	requestId?: string;
	onRetry: () => void;
}) {
	return (
		<div role="alert" className="search-error">
			<h3>Поиск временно недоступен</h3>
			<p>Не удалось достучаться до сервиса поиска. Попробуйте через минуту.</p>
			<button onClick={onRetry}>Повторить</button>
			{requestId && <small>Reference: {requestId}</small>}
		</div>
	);
}

function SearchResults({ query }: { query: string }) {
	const { data, error, refetch } = useQuery({
		queryKey: ["search", query],
		queryFn: () => client.search({ q: query }),
	});

	if (error instanceof AacSearchError) {
		switch (error.code) {
			case "unauthorized":
			case "invalid_or_revoked_key":
				return <SearchInvalidKey requestId={error.requestId} />;
			case "quota_exceeded":
				return <SearchQuotaExceeded resetDate={nextMonthFirst()} />;
			case "rate_limit":
			case "search_failed":
			case "service_unavailable":
				return <SearchUnavailable requestId={error.requestId} onRetry={refetch} />;
			default:
				return <SearchUnavailable requestId={error.requestId} onRetry={refetch} />;
		}
	}

	if (data?.found === 0) return <NoResults query={query} />;
	return <ResultGrid hits={data?.hits ?? []} />;
}