> ## Documentation Index
> Fetch the complete documentation index at: https://docs.enrow.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Ustawienia API

> Skonfiguruj dostęp do API Enrow, swój klucz API, domyślny adres URL webhooka oraz parametr country_code z poziomu panelu

Ustawienia API określają, w jaki sposób uzyskujesz dostęp do API Enrow i jak zachowuje się ono przy każdym żądaniu. Ta strona opisuje, kto może korzystać z API, gdzie znaleźć swój klucz API, jak ustawić domyślny adres URL webhooka oraz jak parametr `country_code` zmienia działanie wyszukiwania.

## Kto może korzystać z API Enrow?

API Enrow jest dostępne dla klientów z **aktywną subskrypcją** lub **kredytami w modelu pay-as-you-go**. Jeśli Twoje konto nie ma żadnej z tych opcji, sekcja API nie będzie dostępna. Aby zobaczyć, ile kredytów zużywa każdy endpoint, zobacz [Kredyty i rozliczenia](/pl/credits-billing).

## Gdzie znajdę swój klucz API?

Twój klucz API znajduje się w [panelu Enrow](https://app.enrow.io) — kliknij **API** w menu po lewej stronie i skopiuj klucz. Ten sam klucz uwierzytelnia każdy endpoint za pośrednictwem nagłówka `x-api-key`. Przykłady żądań i obsługę błędów znajdziesz w sekcji [Uwierzytelnianie](/pl/authentication).

<Warning>
  Przechowuj swój klucz API w bezpiecznym miejscu. Nigdy nie umieszczaj klucza API w systemie kontroli wersji ani nie udostępniaj go publicznie. Traktuj go jak hasło.
</Warning>

## Jak ustawić domyślny adres URL webhooka?

Domyślny adres URL webhooka możesz skonfigurować w panelu. Ten adres URL jest używany za każdym razem, gdy w pojedynczym żądaniu nie podano parametru `webhook`, dzięki czemu nie musisz go powtarzać przy każdym wywołaniu. Parametr `webhook` podany w obiekcie `settings` w danym żądaniu zawsze nadpisuje wartość domyślną z panelu.

Informacje o formatach payloadu, ponownych próbach oraz bezpieczeństwie znajdziesz w sekcji [Jak działają webhooki](/pl/how-webhooks-work).

## Co robi parametr country\_code?

Parametr `country_code` (ISO 3166-1 alpha-2) określa, której lokalnej wersji Google używa API do zidentyfikowania firmy. Podaj go w obiekcie `settings` swojego żądania. Jeśli nic nie zostanie podane, wartością domyślną jest `US`.

<Info>
  Kod kraju jest przydatny tylko podczas wyszukiwania z użyciem `company_name` (a nie `company_domain`). Wskazuje on Enrow, której lokalnej wersji Google użyć do zidentyfikowania firmy — na przykład `google.de` dla Niemiec lub `google.fr` dla Francji.
</Info>

Kod kraju jest szczególnie przydatny w przypadku **homonimów** — firm o tej samej nazwie w różnych krajach:

```json theme={null}
// Dove the soap brand (UK)
{
  "company_name": "Dove",
  "fullname": "John Doe",
  "settings": { "country_code": "GB" }
}

// Dove the chocolate brand (Germany)
{
  "company_name": "Dove",
  "fullname": "Hans Müller",
  "settings": { "country_code": "DE" }
}
```

Obiekt `settings` przyjmuje również parametry `webhook` (adres URL webhooka dla danego żądania), `retrieve_gender` (wartość logiczna) oraz `retrieve_company_info` (wartość logiczna). Pełną listę dostępnych ustawień znajdziesz w dokumentacji [Find Single Email](/pl/api-reference/email-finder/find-single).

## FAQ

<AccordionGroup>
  <Accordion title="Czy potrzebuję osobnego klucza API dla każdego endpointu?">
    Nie. Jeden klucz API uwierzytelnia każdy endpoint — [Email Finder](/pl/api-reference/email-finder/find-single), [Email Verifier](/pl/api-reference/email-verifier/verify-single) oraz [Phone Finder](/pl/api-reference/phone/find-single). Podaj klucz w nagłówku `x-api-key` przy każdym żądaniu.
  </Accordion>

  <Accordion title="Czy country_code działa z company_domain?">
    Nie. Parametr `country_code` wpływa tylko na wyszukiwania korzystające z `company_name`. Gdy podajesz `company_domain`, domena już identyfikuje firmę, więc kod kraju nie ma żadnego wpływu.
  </Accordion>

  <Accordion title="Co się stanie, jeśli ustawię zarówno webhook w panelu, jak i webhook dla danego żądania?">
    Pierwszeństwo ma parametr `webhook` podany w obiekcie `settings` dla danego żądania. Wartość domyślna z panelu jest używana tylko wtedy, gdy żądanie nie zawiera własnego adresu URL `webhook`.
  </Accordion>
</AccordionGroup>

## Następne kroki

<CardGroup cols={2}>
  <Card title="Uwierzytelnianie" icon="key" href="/pl/authentication">
    Jak przekazać swój klucz API w nagłówku x-api-key.
  </Card>

  <Card title="Jak działają webhooki" icon="bell" href="/pl/how-webhooks-work">
    Skonfiguruj webhooki, aby otrzymywać powiadomienia po zakończeniu wyszukiwania.
  </Card>

  <Card title="Kredyty i rozliczenia" icon="coins" href="/pl/credits-billing">
    Zobacz, ile kredytów zużywa każdy endpoint.
  </Card>

  <Card title="Znajdź adres e-mail" icon="envelope" href="/pl/api-reference/email-finder/find-single">
    Uruchom pojedyncze wyszukiwanie adresu e-mail z niestandardowymi ustawieniami.
  </Card>
</CardGroup>