Pobieranie rejestrów połączeń konta
Odczytuj rejestry połączeń przychodzących lub wychodzących dla swojego konta API. Rejestry te zawierają poufne informacje o połączeniach i rozliczeniach. Przetwarzaj je w autoryzowanych procesach po stronie serwera i unikaj zbędnego zapisywania ich w dziennikach lub udostępniania.
Ten starszy punkt końcowy korzysta obecnie ze stałego domyślnego zakresu dat i nie obsługuje stronicowania. Jeśli potrzebujesz innego okresu raportowania lub dużych eksportów danych historycznych, skorzystaj z funkcji historii połączeń i eksportu w portalu; niestandardowe parametry dat w tym punkcie końcowym nie działają niezawodnie.
Żądania
Uwierzytelniaj się przez HTTPS, używając włączonego konta API, z dozwolonego dla niego źródłowego adresu IP. Przykład korzysta z danych uwierzytelniających zapisanych w zmiennych środowiskowych. Obsługiwane żądania dotyczące domyślnego okresu nie wymagają treści żądania.
curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
https://api.multitel.net/v3/cdrs| Ścieżka | Zakres |
|---|---|
| /v3/cdrs | Rejestry połączeń przychodzących konta z domyślnego zakresu dat. |
| /v3/cdrs/{number} | Rejestry połączeń przychodzących, których numer jest dokładnie zgodny z podanym numerem. Najlepiej używać pełnego ciągu cyfr zapisanego w ewidencji numerów. |
| /v3/cdrs/all/outbound | Rejestry połączeń wychodzących konta z domyślnego zakresu dat. Gałąź obsługująca połączenia wychodzące ignoruje pierwszy argument ścieżki; all jest tutaj elementem zastępczym, a nie symbolem wieloznacznym dla połączeń przychodzących. |
Używaj dokładnie oznaczenia kierunku inbound lub outbound pokazanego powyżej. Gałąź obsługująca połączenia wychodzące nie implementuje filtrowania według pojedynczego numeru. Dodanie numeru do tej ścieżki nie zawęża wyników dotyczących połączeń wychodzących.
Domyślny okres raportowania
Zakres zapytania zaczyna się o północy w dniu przypadającym według kalendarza serwera 30 dni przed dniem dzisiejszym i kończy się o północy rozpoczynającej dzień dzisiejszy. Nie obejmuje zatem pozostałej części bieżącego dnia. Nie jest to ruchomy okres 720 godzin kończący się w bieżącej chwili.
Obecna implementacja nie obsługuje niezawodnie pól formularza date_from/date_to: podanie niestandardowych dat pozostawia zmienne określające lata partycji bez ustawionych wartości. Nie używaj tych pól do raportów produkcyjnych. Daty w ciągu zapytania ani parametry stronicowania nie zostały zaimplementowane jako rozwiązania alternatywne.
Odpowiedź
Wyłącznie wybrane pola połączeń przychodzących służące jako ilustracja; są to dane fikcyjne, a nie kompletny zwracany rekord.
{
"status": {
"code": "200",
"msg": "",
"results": 1
},
"response": [
{
"number": "12025550123",
"callerid": "12025550124",
"disposition": "ANSWERED",
"billseconds": "60",
"billcost": "0.0100",
"callsid": "11111111111111111111111111111111",
"date_created": "2026-10-01 12:00:00 UTC"
}
]
}response jest listą. Wspólna struktura odpowiedzi może zawierać status.results jako liczbę wierszy. Kody wyników mogą być ciągami znaków. W przypadku braku rekordów zwracany jest kod API 404 z komunikatem No entries found, zamiast pomyślnej odpowiedzi z pustą listą.
Pola rekordów
| Pola | Znaczenie |
|---|---|
| number, callerid | Numer, na który przychodzi połączenie, i identyfikator dzwoniącego w zestawie pól dla połączeń przychodzących. |
| calling, called, callerid | Identyfikatory strony dzwoniącej i wywoływanej w zestawie pól dla połączeń wychodzących. Nie traktuj identyfikatora dzwoniącego jako potwierdzenia zweryfikowanej tożsamości abonenta. |
| disposition, billseconds, billcost | Zapisany status połączenia, rozliczony czas trwania i zapisana kwota rozliczenia. Wartości mogą korzystać ze starszych formatów ciągów znaków stosowanych w bazie danych. |
| callsid | Zapisany identyfikator UUID połączenia służący do powiązania danych. |
| date_created | Ciąg znaków daty i czasu z dosłownym przyrostkiem UTC; nie ma gwarancji, że jest to znacznik czasu w formacie ISO8601. Parsuj zwracane dane, jawnie uwzględniając ich format. |
| Pozostałe pola | Rejestry połączeń przychodzących zawierają również dane diagnostyczne dotyczące błędów, kosztów, kanału, jakości i pochodzenia; rejestry połączeń wychodzących zawierają dane diagnostyczne dotyczące regionu terminacji. Pełna odpowiedź może zawierać informacje o infrastrukturze i powinna być traktowana jako poufna. |
Punkt końcowy nie określa jawnej kolejności wyników ani nie zapewnia stronicowania. Nie zakładaj, że najnowsze wyniki pojawią się jako pierwsze, że kolejność wierszy będzie stała ani że dostępny jest kursor do synchronizacji przyrostowej. Zwracane pola rozliczeniowe stanowią zapisane dane połączeń, a nie wycenę przyszłego połączenia.
Błędy i ograniczenia raportowania
Sprawdzaj zarówno status HTTP, jak i pola status.code/status.msg w odpowiedzi JSON. Brak wpisów dla wybranego konta i okresu powoduje zwrócenie kodu API 404. Obowiązują również wymagania uwierzytelniania i ograniczenia dotyczące źródłowego adresu IP. Duży raport bez stronicowania lub zawodne żądanie z niestandardowymi datami może zakończyć się niepowodzeniem; wielokrotne odpytywanie całej tabeli nie jest strategią eksportu przyrostowego.
Sprawdzona procedura obsługi zawiera zapytania odczytujące dane i nie obciąża konta ani nie inicjuje połączeń. Zwrócony rekord nie dowodzi, że połączenie odebrała osoba; interpretuj zapisany status i czas trwania zgodnie z celem raportu.