# Przegląd numerów

Numer telefonu to nadawca Twoich wiadomości i połączeń. Bird sprzedaje numery w obsługiwanych krajach, a numer przypisany do Twojego obszaru roboczego może obsługiwać SMS, MMS lub głos w zależności od tego, co dany numer wspiera. Strona [**Numbers**](https://bird.com/dashboard/w/numbers) w dashboardzie pokazuje numery przypisane do Ciebie, a ten sam cykl życia jest dostępny przez API: wyszukaj, co jest w sprzedaży, zamów numer, sprawdź, co masz, i zwolnij to, czego już nie potrzebujesz.

## Numery dedykowane i współdzielone

Każdy przypisany do Ciebie numer ma `kind` i to on decyduje, co możesz z tym numerem zrobić.

Numer `dedicated` należy wyłącznie do Twojego obszaru roboczego. Kupiłeś go, ponosisz za niego miesięczną opłatę i możesz go zwolnić, gdy nie jest Ci już potrzebny. To właśnie daje zamówienie numeru.

Numer `shared` to krótki kod na infrastrukturze zarządzanej przez Bird. Otrzymujesz prawo do korzystania z niego zamiast go kupować, więc nie ponosisz własnej opłaty miesięcznej i nie możesz go zwolnić. Próba zwolnienia kończy się błędem [`E14002`](/docs/api/errors/E14002).

## Co może obsługiwać numer

Dwa pola opisują, czym jest numer, i odpowiadają na różne pytania.

`number_type` to fizyczny rodzaj numeru: `mobile`, `local`, `national`, `toll_free` lub krótki kod. Decyduje o tym, jak numer zachowuje się w sieci, a w kilku krajach także jakich dokumentów wymaga.

`capabilities` to faktyczne możliwości numeru: `sms`, `mms`, `voice` lub ich kombinacja. Numer, który zawiera `voice`, obsługuje połączenia; numer bez niego nie. Filtruj wyniki wyszukiwania po możliwościach, gdy potrzebujesz konkretnej, i sprawdź to pole, zanim zaczniesz budować na numerze, który już masz.

Sam przypisany numer nie zawsze wystarczy, żeby z niego wysyłać. Niektóre kraje docelowe wymagają też zatwierdzonej rejestracji nadawcy, która jest osobnym zatwierdzeniem niezależnym od samego numeru.

## Status przypisanego numeru

`status` mówi, czy numer może obsługiwać ruch.

`active` oznacza, że numer jest przypisany do Ciebie i gotowy do użycia.

`pending_ownership_registration` oznacza, że numer jest przypisany do Ciebie i naliczana jest za niego opłata, ale dany kraj wymaga dokumentów potwierdzających prawo własności, które nie zostały jeszcze zaakceptowane. Pole `ownership` wskazuje, co jest jeszcze wymagane i które wywołanie to realizuje. Większość numerów nigdy nie wchodzi w ten stan, ponieważ większość krajów nie wymaga niczego: ich `ownership` to `null`.

`released` oznacza, że numer nie jest już do Ciebie przypisany.

## Zamawianie jest asynchroniczne

Zamówienie numeru tworzy zlecenie i to zlecenie jest tym, co śledzisz. Większość kończy się w ramach żądania i od razu zwraca numer. Zlecenie, które musi czekać na operatora, wraca wciąż w toku, więc odpytujesz je, aż osiągnie `completed` lub `failed`.

Ma to znaczenie z dwóch powodów. Numer jest Twój dopiero po osiągnięciu przez zlecenie statusu `completed`, więc nic nie powinno zakładać, że numer istnieje wcześniej. Opłata konfiguracyjna, która została już pobrana, nie jest zwracana w przypadku niepowodzenia zlecenia, dlatego wyszukiwanie i zamówienie to osobne wywołania: wyszukiwanie pokazuje, co jest dostępne, zanim zdecydujesz się na zakup.

## Następne kroki

- [Kup i zwolnij numer](/docs/guides/numbers/buying-numbers) to przewodnik po pełnym cyklu życia przez API.
- [Dokumentacja Numbers API](/docs/api/reference/list-available-numbers) opisuje każdą operację i pole.
- [Idempotentność](/docs/guides/idempotency) wyjaśnia, jak bezpiecznie ponowić zamówienie.

## Related resources

- [What is a virtual phone number (VMN)?](/explained/numbers/what-is-a-virtual-phone-number) (answer)
- [SMS numbers](/sms-api/features/numbers) (product)
- [Number types](/docs/guides/numbers/number-types) (docs)

[Get an implementation brief](/learn/workspace?topic=phone-numbers)