Darmowe API wycieków danych
Sprawdzaj miliardy ujawnionych rekordów dzięki naszemu darmowemu API RESTful. Klucz API nie jest potrzebny.
Uwierzytelnianie
Większość punktów końcowych jest publiczna. Punkty końcowe domen wymagają klucza API.
Limit żądań
2 żądania na sekundę na adres IP, plus godzinowe i dzienne limity dla każdego punktu końcowego. Zobacz limity.
Format odpowiedzi
Wszystkie odpowiedzi zwracają JSON ze standardowymi kodami HTTP.
Bazowy URL
api.xposedornot.com
Oficjalne SDK
Skorzystaj z naszych oficjalnych bibliotek, aby zintegrować XposedOrNot ze swoimi aplikacjami za pomocą zaledwie kilku linijek kodu.
Instalacja przez npm:
npm install xposedornot
Szybki przykład:
const { XposedOrNot } = require('xposedornot');
const xon = new XposedOrNot();
// Check email for breaches
const result = await xon.checkEmail('test@example.com');
console.log(result);
Instalacja przez pip:
pip install xposedornot
Szybki przykład:
from xposedornot import XposedOrNot
xon = XposedOrNot()
# Check email for breaches
result = xon.check_email('test@example.com')
print(result)
Dostępne również dla
Kliknij dowolną kartę, aby zobaczyć rejestr pakietów, lub ikonę GitHub, aby przejść do kodu źródłowego.
Wolisz gotową integrację? XposedOrNot łączy się z MISP, TheHive/Cortex, OpenCTI, Maltego, Wazuh, Splunk i Microsoft Sentinel. Przeglądaj wszystkie integracje.
Dziękujemy za zainteresowanie serwisem XposedOrNot. Naszym celem jest utrzymanie API tak dostępnego i responsywnego, jak to możliwe, aby było wartościowym narzędziem dla każdego. Hostowane bezpośrednio na infrastrukturze Google i solidnie buforowane przez Cloudflare, API XposedOrNot zapewnia szybkie odpowiedzi na wszystkie zapytania, niezależnie od miejsca ich pochodzenia.
API XposedOrNot jest zgodne z zasadami architektury REST. Zwraca odpowiedzi zakodowane w JSON i wykorzystuje standardowe kody odpowiedzi HTTP. Większość naszych tras API nie wymaga uwierzytelniania, co zapewnia łatwy dostęp i prostotę użycia. Pamiętaj jednak, że nasza specjalna trasa API służąca do zapytań o dane związane z domenami wymaga autoryzacji kluczem API. Ten środek zapewnia, że tylko zweryfikowani właściciele lub administratorzy wskazanych domen mają dostęp do tych wrażliwych informacji.
Aby poeksperymentować z punktami końcowymi, wypróbuj API Playground, gdzie możesz interaktywnie poznawać API XposedOrNot.
Jak czytać przykłady: wartości pokazane w
{nawiasach klamrowych} to symbole zastępcze. Zastąp
każdą z nich (wraz z nawiasami) własną wartością. Na
przykład {email} staje się
test@example.com.
Limity żądań
Limity darmowego planu na adres IP, dla każdego punktu końcowego:
| Punkt końcowy | Na sekundę | Na godzinę | Na dzień |
|---|---|---|---|
/v1/check-email/{email} | 2 | 25 | 100 |
/v1/breach-analytics | 2 | 25 | 100 |
/v1/breaches | 2 | 50 | 100 |
/v1/domain-breaches | 2 | 25 | 50 |
/v1/metrics | 5/min | 50 | 100 |
/api/v1/pass/anon/{prefix} | Osobna usługa o dużej przepustowości; brak stałego opublikowanego limitu. | ||
HTTP 429 oznacza, że osiągnięto limit godzinowy lub dzienny: poczekaj na zresetowanie okna, zanim spróbujesz ponownie. Odpowiedź zawiera link do planów z wyższymi limitami.
Potrzebujesz wyższych limitów żądań?
Darmowe API jest przeznaczone do użytku osobistego i o niskim wolumenie, i pozostaje darmowe. Jeśli budujesz produkt oparty na danych o wyciekach lub potrzebujesz większej przepustowości, xonAPI+ oferuje płatne plany już od 5 USD/miesiąc z limitami do 25 000 żądań/minutę, dostępem przez klucz API i wsparciem komercyjnym. To te same dane o wyciekach, i to właśnie dzięki nim darmowy plan pozostaje darmowy.
GET 1. Wywołanie API: sprawdzanie wycieków danych adresu e-mail
To API sprawdza, czy adres e-mail pojawił się w znanych wyciekach danych. Przeszukuje obszerną bazę wycieków i ostrzega Cię, jeśli e-mail jest zagrożony.
Punkt końcowy API:
https://api.xposedornot.com/v1/check-email/{email}
Parametry:
| Parametr | W | Wymagany | Typ | Opis |
|---|---|---|---|---|
email |
path | Tak | string | Adres e-mail do sprawdzenia pod kątem wycieków. |
details |
query | Nie | boolean | Dołącza szczegółowe informacje o wyciekach do odpowiedzi. Domyślnie false (akceptuje true/false, yes/no, 1/0). |
{
"breaches": [
[
"Tesco",
"KiwiFarms",
"Vermillion",
"Verified",
"LizardSquad",
"2fast4u",
"Autotrader",
"MyRepoSpace",
"SweClockers"
]
],
"email": "test@example.com",
"status": "success"
}
Odpowiedź jest w formacie JSON, dzięki czemu łatwo ją
przetworzyć w dowolnym języku skryptowym. Pozwala to łatwo
zintegrować dane z Twoimi aplikacjami.
Odpowiedź, gdy nie znaleziono wycieku:
Jeśli adres e-mail nie zostanie znaleziony w żadnej bazie wycieków, otrzymasz następującą odpowiedź JSON:
{"Error":"Not found","email":null}
GET 2. Wywołanie API: analityka wycieków danych dla adresów e-mail
Nasze API oferuje dogłębną analizę historii wycieków danych adresu e-mail. Pokazuje, kiedy i gdzie doszło do wycieków, dostarczając kluczowej analityki do oceny wpływu i powagi tych incydentów. To narzędzie jest niezbędne do zrozumienia poziomu ekspozycji danych i wzmacniania strategii bezpieczeństwa.
Punkt końcowy API:
https://api.xposedornot.com/v1/breach-analytics?email={email}
Parametry:
| Parametr | W | Wymagany | Typ | Opis |
|---|---|---|---|---|
email |
query | Tak | string | Adres e-mail do przeanalizowania. |
API odpowiada na dwa możliwe sposoby: sukcesem lub niepowodzeniem. Poniżej znajdują się kluczowe komponenty pomyślnej odpowiedzi:
- BreachesSummary: Szybki przegląd wszystkich wycieków powiązanych z adresem e-mail, wraz z listą dotkniętych serwisów. Idealne do szybkiego sprawdzenia historii wycieków.
- ExposedBreaches: Szczegółowe informacje o każdym wycieku, w tym nazwa podmiotu dotkniętego wyciekiem, opis, domena, branża, poziom ryzyka, odniesienia, typy ujawnionych danych oraz rok i liczba ujawnionych rekordów. Pomaga to ocenić szczegóły i powagę każdego wycieku.
- BreachMetrics: Ten komponent dostarcza analitykę wycieków, taką jak dotknięte branże, siła haseł, ocena ryzyka, typy ujawnionych danych oraz podział roczny. Te dane są kluczowe do zrozumienia pełnego wpływu wycieków.
- xposed_data: Wgląd w konkretne typy danych ujawnionych w wyciekach, takie jak imiona i nazwiska, zdjęcia, narodowości itd. Pomaga to zrozumieć charakter i zakres ekspozycji danych osobowych.
- PastesSummary: Przegląd wycieków typu "paste" (ekspozycji danych w publicznych serwisach typu pastebin), wraz z liczbą i najnowszym wystąpieniem. To szybki sposób na ocenę ekspozycji na tych platformach.
- ExposedPastes & PasteMetrics: Te komponenty dostarczają szczegółowych informacji i rocznej analizy wycieków typu paste, pozwalając głębiej zrozumieć trendy ekspozycji w czasie.
Ten kompleksowy zestaw narzędzi analitycznych oferuje dogłębny wgląd w historię wycieków danych dowolnego e-maila, dostarczając informacji potrzebnych do lepszego zarządzania bezpieczeństwem cyfrowym.
Przykładowy wynik JSON po pomyślnym znalezieniu pasującego rekordu:
{
"BreachMetrics": {
"get_details": [],
"industry": [
[
[ "elec", 1 ],
[ "misc", 0 ],
[ "mini", 0 ],
[ "musi", 0 ],
[ "manu", 0 ],
[ "ener", 0 ],
[ "news", 0 ],
[ "ente", 0 ],
[ "hosp", 0 ],
[ "heal", 0 ],
[ "food", 0 ],
[ "phar", 0 ],
[ "educ", 0 ],
[ "cons", 0 ],
[ "agri", 0 ],
[ "tele", 0 ],
[ "info", 0 ],
[ "tran", 0 ],
[ "aero", 0 ],
[ "fina", 0 ],
[ "reta", 0 ],
[ "nonp", 0 ],
[ "govt", 0 ],
[ "spor", 0 ],
[ "envi", 0 ]
]
],
"passwords_strength": [
{
"EasyToCrack": 0,
"PlainText": 0,
"StrongHash": 1,
"Unknown": 0
}
],
"risk": [
{
"risk_label": "Low",
"risk_score": 3
}
],
"xposed_data": [
{
"children": [
{
"children": [
{
"colname": "level3",
"group": "A",
"name": "data_Usernames",
"value": 1
}
],
"colname": "level2",
"name": "👤 Personal Identification"
},
{
"children": [
{
"colname": "level3",
"group": "D",
"name": "data_Passwords",
"value": 1
}
],
"colname": "level2",
"name": "🔒 Security Practices"
},
{
"children": [
{
"colname": "level3",
"group": "F",
"name": "data_Email addresses",
"value": 1
}
],
"colname": "level2",
"name": "📞 Communication and Social Interactions"
}
]
}
],
"yearwise_details": [
{
"y2007": 0,
"y2008": 0,
"y2009": 0,
"y2010": 0,
"y2011": 0,
"y2012": 0,
"y2013": 0,
"y2014": 0,
"y2015": 1,
"y2016": 0,
"y2017": 0,
"y2018": 0,
"y2019": 0,
"y2020": 0,
"y2021": 0,
"y2022": 0,
"y2023": 0
}
]
},
"BreachesSummary": {
"site": "SweClockers"
},
"ExposedBreaches": {
"breaches_details": [
{
"breach": "SweClockers",
"details": "SweClockers experienced a data breach in early 2015, where 255k accounts were exposed. As a result, usernames, email addresses, and salted hashes of passwords, which were stored using a combination of MD5 and SHA512, were disclosed. Exposed data: Usernames, Email addresses, Passwords.",
"domain": "sweclockers.com",
"industry": "Electronics",
"logo": "Sweclockers.png",
"password_risk": "hardtocrack",
"references": "",
"searchable": "Yes",
"verified": "Yes",
"xposed_data": "Usernames;Email addresses;Passwords",
"xposed_date": "2015",
"xposed_records": 254967
}
]
},
"ExposedPastes": null,
"PasteMetrics": null,
"PastesSummary": {
"cnt": 0,
"domain": "",
"tmpstmp": ""
}
}
Kilka punktów danych używanych w BreachMetrics:
- Klasyfikacja według branż Podaje liczbę wycieków ujawnionych w 19 najważniejszych branżach.
- Siła haseł Podaje liczbę wycieków, w których hasła były: 1. łatwe do złamania, 2. zapisane jawnym tekstem oraz 3. zabezpieczone silnymi i bezpiecznymi hashami.
- Szczegóły według lat Podaje historyczne dane o wyciekach danych od roku 2010 do teraz.
Przykładowy wynik, gdy pasujący adres e-mail nie zostanie znaleziony:
{
"BreachMetrics": null,
"BreachesSummary": {
"site": ""
},
"ExposedBreaches": null,
"ExposedPastes": null,
"PasteMetrics": null,
"PastesSummary": {
"cnt": 0,
"domain": "",
"tmpstmp": ""
}
}
Odpowiedź złożona z samych wartości null, jak powyżej (zwrócona z HTTP 200), oznacza, że e-mail nie został znaleziony w żadnym z wycieków danych zaindeksowanych przez XposedOrNot.
GET 3. Wywołanie API do anonimowego sprawdzania ujawnionych haseł
Ten punkt końcowy sprawdza, czy hasło pojawiło się w znanych wyciekach, bez ujawniania samego hasła. Obliczasz lokalnie hash SHA3 Keccak-512 hasła i wysyłasz tylko jego pierwsze 10 znaków, więc hasło i pełny hash nigdy nie opuszczają Twojego komputera. Odpowiedź wskazuje trafienie lub jego brak.
https://passwords.xposedornot.com/api/v1/pass/anon/{hash_prefix}
Tutaj {hash_prefix} to pierwsze 10 znaków hasha
SHA3 Keccak-512 hasła, które chcesz sprawdzić.
Parametry:
| Parametr | W | Wymagany | Typ | Opis |
|---|---|---|---|---|
hash_prefix |
path | Tak | string | Pierwsze 10 znaków hasha SHA3 Keccak-512 hasła do sprawdzenia. |
{
"SearchPassAnon": {
"anon": "808d63ba47",
"char": "D:6;A:0;S:0;L:6",
"count": "11999477",
"wordlist": 0
}
}
API dostarcza wyniki w formacie JSON, który jest bardziej informacyjny niż proste tak/nie. Ten szczegółowy wynik umożliwia dalszą analizę i rozbudowę obszernej listy ujawnionych haseł w czasie rzeczywistym.
Przewodnik po strukturze wyniku:
-
anon: odesłany z powrotem prefiks hasha, o który pytasz. Nic, co mogłoby ujawnić Twoje hasło, nie jest przechowywane ani przesyłane. -
char: rozkład składu hasła w formacieD:<digits>;A:<alphabets>;S:<special>;L:<length>(zobacz tabelę poniżej). -
count: liczba wystąpień tego hasła w zgromadzonych ujawnionych wyciekach danych. -
wordlist: czy hasło znaleziono w znanej liście słów (1= tak,0= nie).
To API jest przydatne nie tylko do identyfikowania ujawnionych haseł, ale pomaga też tworzyć silniejsze, bezpieczniejsze polityki haseł.
Poniższa tabela wyjaśnia nieco więcej o tych cechach w prostych słowach:
| Kod | Cecha | Opis |
|---|---|---|
D |
Cyfry | Liczba cyfr |
A |
Litery | Liczba liter |
S |
Znaki specjalne | Liczba znaków specjalnych |
L |
Długość | Długość hasła |
Warto też zwrócić uwagę na użycie hashowania SHA3 Keccak-512 do wyszukiwania i przechowywania danych w XON. Tradycyjne algorytmy hashujące, takie jak MD5 i SHA1, są obecnie przestarzałe, a biorąc pod uwagę ogromną liczbę ujawnionych rekordów, zdecydowałem się na algorytm SHA3 Keccak-512. Hashe Keccak-512 mają 128 znaków długości.
Sprawdź prosty i łatwy w użyciu przykładowy ekran logowania, korzystający z tego API.
Dwa przykładowe hashe Keccak-512 dla łatwego odniesienia:
Keccak-512("test")
1e2e9fc2002b002d75198b7503210c05a1baac4560916a3c6d93bcce3a50d7f00fd395bf1647b9abb8d1afcc9c76c289b0c9383ba386a956da4b38934417789e
Keccak-512("pass")
adf34f3e63a8e0bd2938f3e09ddc161125a031c3c86d06ec59574a5c723e7fdbe04c2c15d9171e05e90a9c822936185f12b9d7384b2bedb02e75c4c5fe89e4d4
Przykładowy wynik, gdy pasujący hash hasła nie zostanie znaleziony:
{ "Error": "Not found"}
GET 4. Wywołanie API do sprawdzenia wszystkich wycieków danych załadowanych w XposedOrNot
Parametry: wszystkie opcjonalne. Bez parametrów punkt końcowy zwraca każdy załadowany wyciek.https://api.xposedornot.com/v1/breaches
| Parametr | W | Wymagany | Typ | Opis |
|---|---|---|---|---|
domain |
query | Nie | string | Filtruje wyniki do pojedynczej domeny. |
breach_id |
query | Nie | string | Filtruje wyniki do pojedynczego wycieku według jego ID. |
Ten JSON może być łatwo przetworzony przez wszystkie języki skryptowe, co ułatwia interpretację i wyodrębnianie elementów danych do wykorzystania w Twoich aplikacjach.
{
"exposedBreaches": [
{
"breachID": "APK.TW",
"breachedDate": "2022-09-01T00:00:00+00:00",
"addedDate": "2023-11-08T06:30:35+00:00",
"domain": "apk.tw",
"exposedData": [
"Email addresses",
"Usernames",
"Passwords",
"IP addresses"
],
"exposedRecords": 2457094,
"exposureDescription": "APK.TW, a Taiwanese Android forum, experienced a data breach in September 2022, affecting 3.7 million members. This incident exposed usernames, email addresses, IP addresses, and passwords encrypted with salted MD5 hashes.",
"industry": "Information Technology",
"logo": "https://xposedornot.com/static/logos/APKTW.png",
"passwordRisk": "easytocrack",
"referenceURL": "",
"searchable": true,
"sensitive": false,
"verified": true
},
{
"breachID": "Habibs",
"breachedDate": "2021-08-01T00:00:00+00:00",
"addedDate": "2023-11-08T06:30:35+00:00",
"domain": "habibs.com.br",
"exposedData": [
"Email addresses",
"Names",
"Phone numbers",
"Dates of birth",
"IP addresses"
],
"exposedRecords": 3519666,
"exposureDescription": "Habib's, a Brazilian fast food restaurant, experienced a significant data breach in August 2021, that impacted 3.5 million users, revealing personal information like email addresses, IP addresses, names, phone numbers, and dates of birth, along with CPF numbers and social media profile links. ",
"industry": "Food",
"logo": "https://xposedornot.com/static/logos/Habibs.png",
"passwordRisk": "unknown",
"referenceURL": "",
"searchable": true,
"sensitive": false,
"verified": true
},
{
"breachID": "GreenGaming",
"breachedDate": "2024-03-01T00:00:00+00:00",
"addedDate": "2024-04-15T10:22:18+00:00",
"domain": "mrgreengaming.com",
"exposedData": [
"Email addresses",
"IP addresses",
"Geographic locations",
"Usernames",
"Dates of birth"
],
"exposedRecords": 27142,
"exposureDescription": "MrGreenGaming announced on their community forum reported a security breach due to unauthorized access via an inactive administrator account leading to a data breach on 01-Mar-2024. The intrusion led to vandalism and the potential exposure of user data, including usernames, email addresses, IP addresses at account creation, and birthdays.",
"industry": "Entertainment",
"logo": "https://xposedornot.com/static/logos/GreenGaming.png",
"passwordRisk": "unknown",
"referenceURL": "https://forums.mrgreengaming.com/topic/30151-%E2%9A%A0%EF%B8%8Fdata-breach%E2%9A%A0%EF%B8%8F/#comment-536079",
"searchable": true,
"sensitive": false,
"verified": true
},
{
"breachID": "CutoutPro",
"breachedDate": "2024-02-01T00:00:00+00:00",
"addedDate": "2024-03-10T08:15:42+00:00",
"domain": "cutout.pro",
"exposedData": [
"Names",
"Passwords",
"Email addresses",
"IP addresses"
],
"exposedRecords": 20021813,
"exposureDescription": "Cutout.Pro, an AI-powered photo editing platform, experienced a data breach affecting 20 million users. Information exposed includes email addresses, hashed passwords, IP addresses, and names. A cybercriminal posted 5.93 GB of data on hacker forum, including a 41.4 million record database dump with unique email addresses.",
"industry": "Information Technology",
"logo": "https://xposedornot.com/static/logos/Cutout.pro.png",
"passwordRisk": "easytocrack",
"referenceURL": "https://www.bleepingcomputer.com/news/security/20-million-cutoutpro-user-records-leaked-on-data-breach-forum/",
"searchable": true,
"sensitive": false,
"verified": true
}
… odpowiedź skrócona dla zwięzłości; pełna lista jest dłuższa.
Ponadto możesz też przekazać parametr, taki jak domena, i przefiltrować wyniki, aby wyświetlić treść dotyczącą konkretnego wycieku.
https://api.xposedornot.com/v1/breaches?domain={domain}
{
"exposedBreaches": [
{
"breachID": "Twitter-Scraped",
"breachedDate": "2021-01-01T00:00:00+00:00",
"addedDate": "2023-11-08T06:30:35+00:00",
"domain": "twitter.com",
"industry": "Information Technology",
"logo": "https://xposedornot.com/static/logos/Twitter.png",
"passwordRisk": "unknown",
"searchable": true,
"sensitive": false,
"verified": true,
"exposedData": [
"Usernames",
"Names",
"Email addresses",
"Phone numbers",
"Geographic locations"
],
"exposedRecords": 208918735,
"exposureDescription": "The Twitter Email Addresses Leak involves a data leak of over 200 million Twitter user profiles around 2021. The leak includes email addresses, names, screen names, follow counts, and account creation dates. The data was obtained through a Twitter API vulnerability that allowed the input of email addresses and phone numbers to confirm their association with Twitter IDs.",
"referenceURL": ""
}
],
"status": "success"
}
API zwraca pomyślną odpowiedź wyłącznie w formacie JSON.POST 5. Wywołanie API do sprawdzenia wszystkich wycieków danych dla zweryfikowanych domen
Parametry:https://api.xposedornot.com/v1/domain-breaches/
| Parametr | W | Wymagany | Typ | Opis |
|---|---|---|---|---|
x-api-key |
header | Tak | string | Twój klucz API domeny. Domena jest wyprowadzana z klucza. |
Content-Length |
header | Tak | 0 |
Ten punkt końcowy nie przyjmuje treści żądania, więc ustaw długość treści na 0. |
** Nie masz jeszcze klucza? Zobacz, jak uzyskać klucz API dla danych o wyciekach domen. Opisano tam weryfikację domeny i pobieranie klucza z Twojego panelu.
Przykładowe żądanie API z użyciem curl. Przechowuj swój klucz w zmiennej środowiskowej zamiast wpisywać go na stałe, aby nie trafił do historii powłoki ani do systemu kontroli wersji:
Odpowiedź API jest w formacie JSON. Główny klucz 'metrics' zawiera szczegóły wycieku. Poniżej znajduje się opis każdego podklucza w 'metrics':export XON_API_KEY="your_api_key_here" curl -L -X POST \ -H "x-api-key: $XON_API_KEY" \ -H "Content-Length: 0" \ https://api.xposedornot.com/v1/domain-breaches/
1.Breach_Summary: To pole zawiera podsumowanie liczby wycieków na organizację.
2.Breaches_Details: To tablica zawierająca szczegółowe informacje o każdym pojedynczym wycieku, w tym nazwę organizacji dotkniętej wyciekiem, domenę oraz adres e-mail powiązany z wyciekiem.
3.Detailed_Breach_Info: To pole zawiera szczegółowe podsumowanie wycieków, w tym datę wycieku, logo organizacji, informację, czy hasło było zagrożone, czy wyciek jest przeszukiwalny, typ ujawnionych danych, łączną liczbę ujawnionych rekordów oraz opis wycieku.
4.Domain_Summary: Zawiera podsumowanie liczby wycieków na domenę.
5.Top10_Breaches: To pole zawiera listę 10 największych wycieków.
6.Yearly_Metrics: To pole zawiera roczny podział liczby wycieków od 2010 roku do bieżącego roku.
Przykładowy wynik dla łatwego odniesienia.
{
"metrics": {
"Breach_Summary": {
"AerServ": 1
},
"Breaches_Details": [
{
"breach": "AerServ",
"domain": "xposedornot.com",
"email": "deva@xposedornot.com"
}
],
"Detailed_Breach_Info": {
"AerServ": {
"breached_date": "Tue, 01 Apr 2014 00:00:00 GMT",
"logo": "Aerserv.png",
"password_risk": "plaintext",
"searchable": "Yes",
"xposed_data": "Email Addresses",
"xposed_records": 64777,
"xposure_desc": "AerServ, an ad management platform, experienced a data breach in April 2018. This incident occurred after its acquisition by InMobi and affected more than 64,000 unique email addresses. The exposed data included contact information and passwords, which were stored as salted SHA-512 hashes. Later in 2018, the breached data was publicly posted on Twitter, prompting InMobi to acknowledge the incident "
}
},
"Domain_Summary": {
"xposedornot.com": 1
},
"Top10_Breaches": {
"AerServ": 1
},
"Yearly_Metrics": {
"2010": 0,
"2011": 0,
"2012": 0,
"2013": 0,
"2014": 1,
"2015": 0,
"2016": 0,
"2017": 0,
"2018": 0,
"2019": 0,
"2020": 0,
"2021": 0,
"2022": 0,
"2023": 0
}
},
"status": "success"
}
Obsługa błędów: Jeśli klucz API jest
nieprawidłowy, punkt końcowy odpowiada HTTP 401 i następującym
JSON:
{
"detail": "Invalid or missing API key"
}
Pole detail zawiera opis błędu. Pamiętaj, aby przed wysłaniem żądania do punktu końcowego ustawić
XON_API_KEY na swój rzeczywisty klucz
API.
6. Kody odpowiedzi API
Innymi słowy, kody z zakresu 4xx wskazują błąd po stronie klienta (Twoje żądanie), a kody 5xx wskazują błąd po stronie serwera (u nas).
| Kod | Opis |
|---|---|
| 200 | Sukces, zwrócona zostanie odpowiedź JSON |
| 401 | Nieprawidłowy/nieautoryzowany klucz API |
| 404 | Błąd w danych wejściowych ( nie znaleziono danych ) |
| 429 | Osiągnięto limit szybkości, czas zwolnić |
| 502/503 | Błąd po stronie serwera. Zgłoś go, jeśli go napotkasz. |
Obowiązuje próg 2 zapytań na sekundę dla każdego żądania API. Miej to na uwadze i w razie potrzeby ponów próbę w trybie wolniejszym lub z użyciem uśpienia.
Powtarzające się niewłaściwe użycie lub nadużycie tego API jest automatycznie blokowane przez xGuardian. Korzystaj z API odpowiedzialnie.
Widzisz błąd? Zgłoś go przez Twitter lub e-mail, a zostanie naprawiony.