XposedOrNot API ஆவணம்

எங்கள் இலவச, RESTful API மூலம் மீறல் கண்டறிதலை உங்கள் பயன்பாட்டில் ஒருங்கிணைக்கவும்.
JSON பதில்களுடன் பில்லியன் கணக்கான வெளிப்படுத்தப்பட்ட பதிவுகளை உடனடியாக சரிபார்க்கவும்.

அங்கீகாரம்

பெரும்பாலான இறுதிப்புள்ளிகள் பொதுவானவை. டொமைன் இறுதிப்புள்ளிகளுக்கு API விசை தேவை.

வேக வரம்பு

அனைத்து இறுதிப்புள்ளிகளிலும் வினாடிக்கு 1 கோரிக்கை.

பதில் வடிவம்

அனைத்து பதில்களும் நிலையான HTTP குறியீடுகளுடன் JSON ஐ திருப்பி அனுப்பும்.

அடிப்படை URL

api.xposedornot.com

Swagger ஆவணம்

API விளையாட்டு மைதானம்

அதிகாரப்பூர்வ SDKகள்

சில வரி குறியீட்டுடன் XposedOrNot ஐ உங்கள் பயன்பாடுகளில் ஒருங்கிணைக்க எங்கள் அதிகாரப்பூர்வ நூலகங்களைப் பயன்படுத்தவும்.

Node.js / JavaScript

npm வழியாக நிறுவவும்:

npm install xposedornot

விரைவு எடுத்துக்காட்டு:

const { XposedOrNot } = require('xposedornot');

const xon = new XposedOrNot();

// மின்னஞ்சலை மீறல்களுக்காக சரிபார்க்கவும்
const result = await xon.checkEmail('[email protected]');
console.log(result);

npmjs.com இல் காண்க

Python

pip வழியாக நிறுவவும்:

pip install xposedornot

விரைவு எடுத்துக்காட்டு:

from xposedornot import XposedOrNot

xon = XposedOrNot()

# மின்னஞ்சலை மீறல்களுக்காக சரிபார்க்கவும்
result = xon.check_email('[email protected]')
print(result)

PyPI இல் காண்க


API விரைவு குறிப்பு கடைசியாக புதுப்பிக்கப்பட்டது: 04-டிச-2025

XposedOrNot இல் உங்கள் ஆர்வத்திற்கு நன்றி. எங்கள் API ஐ முடிந்தவரை அணுகக்கூடியதாகவும் பதிலளிக்கக்கூடியதாகவும் வைத்திருப்பதே குறிக்கோள், இது அனைவருக்கும் மதிப்புமிக்க கருவியாக அமைகிறது. Google உள்கட்டமைப்பில் நேரடியாக நடத்தப்பட்டு Cloudflare ஆல் வலுவாக தற்காலிக சேமிக்கப்படுகிறது, XposedOrNot API எந்த வினவல்களுக்கும் அவற்றின் தோற்றப் புள்ளியைப் பொருட்படுத்தாமல் விரைவான பதில்களை வழங்குகிறது.

XposedOrNot API REST கட்டிடக்கலை கொள்கைகளை கடைபிடிக்கிறது. இது JSON-குறியீடு செய்யப்பட்ட பதில்களை திருப்பி அனுப்புகிறது மற்றும் நிலையான HTTP மறுமொழி குறியீடுகளைப் பயன்படுத்துகிறது. எங்களின் பெரும்பாலான API வழிகளுக்கு அங்கீகாரத் தேவைகள் எதுவும் இல்லை. இருப்பினும், எங்கள் குறிப்பிட்ட டொமைன் தொடர்பான தரவை வினவுவதற்குப் பயன்படுத்தப்படும் API வழிக்கு API விசை அங்கீகாரம் தேவை.

பரிசோதனை மற்றும் சோதனை நோக்கங்களுக்காக, எங்கள் API விளையாட்டு மைதானத்தை ஆராய உங்களை அன்புடன் அழைக்கிறேன்.

இந்த பயனர் நட்பு API, மின்னஞ்சல் முகவரி ஏதேனும் அறியப்பட்ட தரவு மீறல்களில் ஈடுபட்டுள்ளதா என்பதை விரைவாகச் சரிபார்க்கிறது. இது மீறல்களின் விரிவான தரவுத்தளத்தைத் தேடுகிறது மற்றும் மின்னஞ்சல் ஆபத்தில் இருந்தால் உங்களை எச்சரிக்கும்.

டிஜிட்டல் பாதுகாப்பைப் பேணுவதற்கும் மின்னஞ்சலின் மீறல் வரலாற்றைப் புரிந்துகொள்வதற்கும் இந்தக் கருவி விலைமதிப்பற்றது.


API இறுதிப்புள்ளி:
https://api.xposedornot.com/v1/check-email/[[email protected]]
வெற்றிகரமான மீறல் கண்டறிதலின் எடுத்துக்காட்டு: மீறல் கண்டறியப்பட்டால், இது போன்ற JSON பதிலைப் பெறுவீர்கள்:
 {
  "breaches": [
    [
      "Tesco",
      "KiwiFarms",
      "Vermillion",
      "Verified",
      "LizardSquad",
      "2fast4u",
      "Autotrader",
      "MyRepoSpace",
      "SweClockers"
    ]
  ]
}
		  
பதில் JSON வடிவத்தில் உள்ளது, எந்த ஸ்கிரிப்டிங் மொழியுடனும் அலசுவதை எளிதாக்குகிறது.
எந்த மீறலும் காணப்படாதபோது பதில்:
எந்த மீறல் தரவுத்தளத்திலும் மின்னஞ்சல் முகவரி காணப்படவில்லை என்றால், பின்வரும் JSON பதிலைப் பெறுவீர்கள்:
{"Error":"Not found"}
 

எங்கள் API ஆனது மின்னஞ்சல் முகவரியின் தரவு மீறல் வரலாற்றின் ஆழமான பகுப்பாய்வை வழங்குகிறது. எப்போது, எங்கு மீறல்கள் நிகழ்ந்தன என்பதை இது வெளிப்படுத்துகிறது, இந்த சம்பவங்களின் தாக்கம் மற்றும் தீவிரத்தை அளவிடுவதற்கு அத்தியாவசிய பகுப்பாய்வுகளை வழங்குகிறது.


API இறுதிப்புள்ளி:
https://api.xposedornot.com/v1/breach-analytics?email=[email-address]

API இரண்டு சாத்தியமான விளைவுகளுடன் பதிலளிக்கிறது: வெற்றி அல்லது தோல்வி. வெற்றிகரமான பதிலின் முக்கிய கூறுகள் கீழே உள்ளன:


  • BreachesSummary: மின்னஞ்சல் முகவரியுடன் இணைக்கப்பட்டுள்ள அனைத்து மீறல்களின் விரைவான மேலோட்டத்தைப் பெறவும், பாதிக்கப்பட்ட தளங்களின் பட்டியல் உட்பட.

  • ExposedBreaches: மீறப்பட்ட நிறுவனத்தின் பெயர், விளக்கம், டொமைன், தொழில்துறை, இடர் நிலை, குறிப்புகள், வெளிப்படுத்தப்பட்ட தரவு வகைகள் மற்றும் வெளிப்படுத்தப்பட்ட பதிவுகளின் ஆண்டு மற்றும் எண்ணிக்கை உட்பட ஒவ்வொரு மீறலின் விரிவான தகவலைப் பெறவும்.

  • BreachMetrics: பாதிக்கப்பட்ட தொழில்கள், கடவுச்சொல் வலிமை, ஆபத்து மதிப்பெண், வெளிப்படுத்தப்பட்ட தரவு வகைகள் மற்றும் வருடாந்திர முறிவு போன்ற மீறல்கள் பற்றிய பகுப்பாய்வுகளை இந்தக் கூறு வழங்குகிறது.

  • xposed_data: பெயர்கள், புகைப்படங்கள், தேசியங்கள் போன்ற மீறல்களில் வெளிப்படும் குறிப்பிட்ட தரவு வகைகளைப் பற்றிய நுண்ணறிவைப் பெறுங்கள்.

  • PastesSummary: 'பேஸ்ட்' மீறல்களின் (பொது பேஸ்ட்பின் போன்ற சேவைகளின் தரவு வெளிப்பாடுகள்), எண்ணிக்கை மற்றும் மிக சமீபத்திய நிகழ்வு உட்பட மேலோட்டத்தை வழங்குகிறது.

  • ExposedPastes & PasteMetrics: இந்த கூறுகள் விரிவான தகவல் மற்றும் பேஸ்ட் மீறல்கள் பற்றிய வருடாந்திர பகுப்பாய்வை வழங்குகின்றன.

இந்த விரிவான பகுப்பாய்வுக் கருவிகள் எந்த மின்னஞ்சலின் தரவு மீறல் வரலாற்றையும் ஆழமாகப் படிக்கவைத்து, சிறந்த டிஜிட்டல் பாதுகாப்பு நிர்வாகத்திற்குத் தேவையான நுண்ணறிவுகளை வழங்குகிறது.


பொருத்தமான பதிவை வெற்றிகரமாகக் கண்டறிவதற்கான மாதிரி JSON வெளியீடு:

{
  "BreachMetrics": {
    "get_details": [],
    "industry": [
      [
        [          "elec",          1        ],
        [          "misc",          0        ],
        ...
      ]
    ],
    "passwords_strength": [
      {
        "EasyToCrack": 0,
        "PlainText": 0,
        "StrongHash": 1,
        "Unknown": 0
      }
    ],
    "risk": [
      {
        "risk_label": "Low",
        "risk_score": 3
      }
    ],
    "xposed_data": [...],
    "yearwise_details": [...]
  },
  "BreachesSummary": {
    "site": "SweClockers"
  },
  "ExposedBreaches": {
    "breaches_details": [...]
  },
  "ExposedPastes": null,
  "PasteMetrics": null,
  "PastesSummary": {
    "cnt": 0,
    "domain": "",
    "tmpstmp": ""
  }
}
	       
BreachMetrics இல் பயன்படுத்தப்படும் சில தரவுப் புள்ளிகள் பின்வருமாறு:
  1. தொழில் வாரியான வகைப்பாடு
  2. இது சிறந்த 19 தொழில்களில் வெளிப்படும் மீறல்களின் எண்ணிக்கையை உங்களுக்கு வழங்குகிறது.
  3. கடவுச்சொல் வலிமை
  4. கடவுச்சொற்களைக் கொண்ட மீறல்களின் எண்ணிக்கையை இது உங்களுக்கு வழங்குகிறது: 1. சிதைப்பது எளிது, 2. எளிய உரை கடவுச்சொற்கள், 3. வலுவான மற்றும் பாதுகாப்பான கடவுச்சொல் ஹாஷ்கள்.
  5. ஆண்டு வாரியான விவரங்கள்
  6. இது 2010 ஆம் ஆண்டு தொடங்கி தற்போது வரையிலான தரவு மீறல்களின் வரலாற்றுத் தரவை உங்களுக்கு வழங்குகிறது.

பொருந்தக்கூடிய மின்னஞ்சல் முகவரியைக் கண்டுபிடிக்கவில்லை என்பதற்கான மாதிரி வெளியீடு:
{  "Error": "Not found"}
 

XposedOrNot இல் ஏற்றப்பட்ட தரவு மீறல்கள் எதிலும் தேடப்பட்ட மின்னஞ்சல் காணப்படவில்லை என்பதும் இதன் பொருள்.


வெளிப்படுத்தப்பட்ட கடவுச்சொற்களைச் சரிபார்க்க நீங்கள் ஆர்வமாக இருந்தால், இந்த API உங்களுக்கு ஏற்றது. இது இரண்டு வடிவங்களில் முடிவுகளை வழங்குகிறது: வெற்றி அல்லது தோல்வி.


https://passwords.xposedornot.com/v1/pass/anon/[first 10 characters of SHA3-keccak-512 hash]
பொருத்தமான கடவுச்சொல் ஹாஷை வெற்றிகரமாகக் கண்டறிவதற்கான மாதிரி JSON வெளியீடு:
 {
  "SearchPassAnon": {
    "anon": "808d63ba47",
    "char": "D:6;A:0;S:0;L:6",
    "count": "11999477",
    "wordlist": 0
  }
}
 

API ஆனது JSON வடிவத்தில் முடிவுகளை வழங்குகிறது, இது ஆம்/இல்லை என்பதை விட அதிக தகவல் தருகிறது.


வெளியீட்டு கட்டமைப்பு வழிகாட்டி:


  • "anon" உறுப்பு: எங்கள் தரவுத்தளத்தில் உள்ள ஒவ்வொரு கடவுச்சொல் ஹாஷிலும் "anon" உறுப்பாகும். இது அநாமதேயமாக இருக்கும் போது தேட விரும்பும் பயனர்களுக்கு தனியுரிமையை உறுதி செய்வதாகும்.
  • "char" உறுப்பு: இந்த உறுப்பு நீளம், எழுத்துக்களின் பயன்பாடு, எண்கள் மற்றும் சிறப்பு எழுத்துக்கள் போன்ற கடவுச்சொல்லின் பண்புகளின் முறிவை வழங்குகிறது.

இந்த API ஆனது வெளிப்படும் கடவுச்சொற்களை அடையாளம் காண்பதற்கு மட்டுமல்ல, வலுவான, மிகவும் பாதுகாப்பான கடவுச்சொல் கொள்கைகளை உருவாக்கவும் உதவுகிறது.


பின்வரும் அட்டவணை எளிமையான சொற்களில் பண்புகளைப் பற்றி இன்னும் கொஞ்சம் விளக்குகிறது:

இலக்கங்கள் எண்களின் எண்ணிக்கை
எழுத்துக்கள் எழுத்துக்களின் எண்ணிக்கை
சிறப்பு எழுத்துக்கள் சிறப்பு எழுத்துகளின் எண்ணிக்கை
நீளம் கடவுச்சொல்லின் நீளம்
கடைசி ஒன்று "count" சேகரிக்கப்பட்ட அம்பலப்படுத்தப்பட்ட தரவு மீறல்களில் இந்த கடவுச்சொல் காணப்பட்ட முறைகளின் எண்ணிக்கையைக் குறிக்கிறது. அனைத்து அம்பலப்படுத்தப்பட்ட வலைத்தளங்களின் விரிவான பட்டியலுக்கு, தயவுசெய்து பார்வையிடவும் XON இல் Xposed இணையதளங்கள் .

மேலும், கவனிக்க வேண்டிய மற்றொரு புள்ளி SHA3 Keccak-512 ஹாஷிங் பயன்பாடு ஆகும். MD5 மற்றும் SHA1 போன்ற பாரம்பரிய ஹாஷிங் அல்காரிதம்கள் தற்போது நிராகரிக்கப்பட்டுள்ளன. SHA3 Keccak-512 அல்காரிதம் பயன்படுத்தப்படுகிறது. Keccak-512 ஹாஷ்கள் 128 எழுத்துகள் நீளம் கொண்டவை.

எளிமையான மற்றும் பயன்படுத்த எளிதானவற்றைச் சரிபார்க்கவும் மாதிரி உள்நுழைவு திரை, இந்த API ஐப் பயன்படுத்துகிறது.

இரண்டு மாதிரி Keccak-512 ஹாஷ்கள் எளிதான குறிப்புக்காக கொடுக்கப்பட்டுள்ளன:

Keccak-512("test")
1e2e9fc2002b002d75198b7503210c05a1baac4560916a3c6d93bcce3a50d7f00fd395bf1647b9abb8d1afcc9c76c289b0c9383ba386a956da4b38934417789e

Keccak-512("pass")
adf34f3e63a8e0bd2938f3e09ddc161125a031c3c86d06ec59574a5c723e7fdbe04c2c15d9171e05e90a9c822936185f12b9d7384b2bedb02e75c4c5fe89e4d4

பொருந்தக்கூடிய கடவுச்சொல் ஹாஷ் கண்டுபிடிக்கப்படவில்லை என்பதற்கான மாதிரி வெளியீடு:
            {  "Error": "Not found"}
        


https://api.xposedornot.com/v1/breaches
API ஆனது JSON வடிவத்தில் மட்டுமே வெற்றிகரமான பதிலை வழங்குகிறது.

இந்த JSON ஐ அனைத்து ஸ்கிரிப்டிங் மொழிகளாலும் எளிதாகப் பாகுபடுத்தி எளிதாக விளக்கலாம் மற்றும் உங்கள் அந்தந்த பயன்பாடுகளில் பயன்படுத்தப்படும் தரவு கூறுகளைப் பிரித்தெடுக்கலாம்.
   {
  "exposedBreaches": [
    {
      "breachID": "APK.TW",
      "breachedDate": "2022-09-01T00:00:00+00:00",
      "domain": "apk.tw",
      "exposedData": [
        "Email addresses",
        "Usernames",
        "Passwords",
        "IP addresses"
      ],
      "exposedRecords": 2457094,
      "exposureDescription": "APK.TW, a Taiwanese Android forum...",
      "industry": "Information Technology",
      "logo": "https://xposedornot.com/static/logos/APKTW.png",
      "passwordRisk": "easytocrack",
      "searchable": true,
      "sensitive": false,
      "verified": true
    },
    ...
  ]
}
	       

மேலும், நீங்கள் ஒரு டொமைன் போன்ற அளவுருவை அனுப்பலாம் மற்றும் அந்த மீறலுக்கான குறிப்பிட்ட உள்ளடக்கத்தை அனுப்ப முடிவுகளை வடிகட்டலாம்.
https://api.xposedornot.com/v1/breaches?domain=[twitter.com]

{
  "Exposed Breaches": [
    {
      "Breach ID": "Twitter-Scraped",
      "Breached Date": "2021-01-01T00:00:00+00:00",
      "Domain": "twitter.com",
      "Exposed Data": "Usernames;Email addresses;Names;...",
      "Exposed Records": 208918735,
      "Industry": "Information Technology",
      "Logo": "Twitter.png",
      "Password Risk": "unknown",
      "Searchable": "Yes",
      "Verified": "Yes"
    }
  ],
  "status": "success"
}
		  
API ஆனது JSON வடிவத்தில் மட்டுமே வெற்றிகரமான பதிலை வழங்குகிறது.

https://api.xposedornot.com/v1/domain-breaches/
இது ஒரு POST கோரிக்கை மற்றும் 'x-api-key' விசையுடன் தலைப்பில் சரியான API விசை சேர்க்கப்பட வேண்டும். இந்த இறுதிப்புள்ளி எந்த கோரிக்கை அமைப்பையும் ஏற்காது, எனவே, உள்ளடக்க நீள தலைப்பு '0' ஆக அமைக்கப்பட வேண்டும்.
** சரிபார்க்கப்பட்ட டொமைன்களுக்கு, API விசை டாஷ்போர்டில் கிடைக்கிறது.

curl ஐப் பயன்படுத்தி மாதிரி API கோரிக்கை:
curl -L -X POST -H "x-api-key: 2a447449965fe2b3f1729b65ee94197d" -H "Content-Length: 0" https://api.xposedornot.com/v1/domain-breaches/
	       
API இன் பதில் JSON வடிவத்தில் உள்ளது. முக்கிய விசையான 'metrics' இல் மீறல் பற்றிய விவரங்கள் உள்ளன. 'metrics' இல் ஒவ்வொரு துணை விசையின் விளக்கமும் கீழே உள்ளது:

1.Breach_Summary: இந்த புலம் ஒரு நிறுவனத்திற்கு ஏற்படும் மீறல்களின் எண்ணிக்கையின் சுருக்கத்தை வழங்குகிறது.
2.Breaches_Details: இது மீறப்பட்ட அமைப்பின் பெயர், டொமைன் மற்றும் மீறலுடன் தொடர்புடைய மின்னஞ்சல் முகவரி உட்பட ஒவ்வொரு தனிப்பட்ட மீறலைப் பற்றிய விரிவான தகவலைக் கொண்ட ஒரு வரிசை.
3.Detailed_Breach_Info: மீறப்பட்ட தேதி, நிறுவனத்தின் லோகோ, கடவுச்சொல் ஆபத்தில் உள்ளதா இல்லையா, மீறலைத் தேடக்கூடியதா, அம்பலப்படுத்தப்பட்ட தரவு வகை, பதிவுகளின் மொத்த எண்ணிக்கை மற்றும் மீறல் பற்றிய விளக்கம் உள்ளிட்ட மீறல்களின் விரிவான சுருக்கம் இந்தப் புலத்தில் உள்ளது.
4.Domain_Summary: இது ஒரு டொமைனுக்கான மீறல்களின் எண்ணிக்கையின் சுருக்கத்தை வழங்குகிறது.
5.Top10_Breaches: இந்தப் புலம் முதல் 10 மீறல்களின் பட்டியலை வழங்குகிறது.
6.Yearly_Metrics: இந்த புலம் 2010 முதல் தற்போதைய ஆண்டு வரையிலான மீறல்களின் எண்ணிக்கையின் வருடாந்திர விவரத்தை வழங்குகிறது.

எளிமையான குறிப்புக்காக மாதிரி வெளியீடு கொடுக்கப்பட்டுள்ளது.
{
  "metrics": {
    "Breach_Summary": {
      "AerServ": 1
    },
    "Breaches_Details": [
      {
        "breach": "AerServ",
        "domain": "xposedornot.com",
        "email": "deva[@]xposedornot.com"
      }
    ],
    "Detailed_Breach_Info": {...},
    "Domain_Summary": {
      "xposedornot.com": 1
    },
    "Top10_Breaches": {
      "AerServ": 1
    },
    "Yearly_Metrics": {
      "2010": 0,
      ...
      "2023": 0
    }
  },
  "status": "success"
}

	       
பிழை கையாளுதல்: தவறான அல்லது API விசை விடுபட்டால், பதில் பின்வருமாறு இருக்கும்:
{
  "message":"Invalid or missing API key",
  "status":"error"
}
	       
message புலத்தில் பிழையின் விளக்கம் இருக்கும், மற்றும் status புலத்தில் பிழை ஏற்பட்டிருப்பதைக் குறிக்க "error" என்ற சரம் இருக்கும்.

இறுதிப்புள்ளிக்கு கோரிக்கை வைக்கும் போது "YOUR_API_KEY" ஐ உங்கள் உண்மையான API விசையுடன் மாற்ற மறக்காதீர்கள்.
XposedOrNot API API கோரிக்கையின் வெற்றி அல்லது தோல்வியைக் குறிக்க வழக்கமான HTTP மறுமொழி குறியீடுகளைப் பயன்படுத்துகிறது. பொதுவாக: 2xx வரம்பில் உள்ள குறியீடுகள் வெற்றியைக் குறிக்கின்றன. 4xx வரம்பில் உள்ள குறியீடுகள் பயனர் பிழையைக் குறிக்கின்றன. 5xx வரம்பில் உள்ள குறியீடுகள் சேவையகப் பிழையைக் குறிக்கின்றன.

குறியீடு விளக்கம்
200 வெற்றி JSON பதிலை வெளியிடும்
401 தவறான/அங்கீகரிக்கப்படாத API விசை
404 உள்ளீட்டில் பிழை (தரவு இல்லை)
429 வேக வரம்பு எட்டப்பட்டது - வேகத்தைக் குறைக்கும் நேரம்
502/503 சேவையகப் பிழை - சரிசெய்வது எனது பிரச்சனை. இதைப் பார்த்தால் எனக்குத் தெரிவிக்கவும் ;)

இந்த முழு திறந்த மூல தளத்தை வடிவமைப்பதில் எங்களுடன் சேருங்கள்! பங்களிப்புகள் வரவேற்கப்படுகின்றன ❤️ எங்கள் GitHub இல்.