Censys.io 是一個提供全互聯網掃描平臺的網站。它擁有一個公共 API，允許用戶以編程方式訪問其服務。在這篇博客中，我們將討論如何使用 Censys.io 的 API 文檔，包括一些用 JavaScript 編寫的示例代碼。

在我們可以使用 Censys.io API 之前，我們需要注冊一個免費賬戶并獲取一個 API 密鑰。一旦我們有了 API 密鑰，我們就可以用它來向 API 發送請求。

Censys.io 在他們的網站上提供了全面的 API 文檔。文檔被組織成涵蓋 API 不同方面的部分，如認證、數據檢索和搜索。每個部分都提供了關于 API 的端點、參數和響應格式的詳細信息。

為了幫助你開始使用 Censys.io API，這里有一些用 JavaScript 編寫的示例代碼。

要與 Censys.io API 進行認證，我們需要在發送的請求中包含我們的 API 密鑰。以下是如何使用 axios 庫將 API 密鑰添加到請求中的示例。

const axios = require('axios');

const apiKey = 'your-api-key';

axios.get('https://censys.io/api/v1/data', {
  headers: {
    'Content-Type': 'application/json',
    'Authorization': `Basic ${Buffer.from(apiKey).toString('base64')}`
  }
})
.then((response) => {
  console.log(response.data);
})
.catch((error) => {
  console.error(error);
});

要從 Censys.io API 檢索數據，我們可以使用 /data 端點。以下是如何發送請求以檢索特定 IP 地址信息的示例。

const axios = require('axios');

const apiKey = 'your-api-key';
const ipAddress = '192.0.2.1';

axios.post('https://censys.io/api/v1/data', {
  query: `ip:${ipAddress}`,
  fields: ['ip', 'protocols', 'ports']
}, {
  headers: {
    'Content-Type': 'application/json',
    'Authorization': `Basic ${Buffer.from(apiKey).toString('base64')}`
  }
})
.then((response) => {
  const data = response.data.results[0];
  console.log(`IP address: ${data.ip}`);
  console.log(`Protocols: ${data.protocols.join(', ')}`);
  console.log(`Ports: ${data.ports.join(', ')}`);
})
.catch((error) => {
  console.error(error);
});

要使用 Censys.io API 搜索數據，我們可以使用 /search 端點。以下是如何發送請求以搜索具有特定通用名稱的 SSL 證書的示例。

const axios = require('axios');

const apiKey = 'your-api-key';
const commonName = 'example.com';

axios.post('https://censys.io/api/v1/search/certificates', {
  query: `parsed.subject.common_name:"${commonName}"`,
  fields: ['parsed.subject.common_name', 'parsed.validity.start', 'parsed.validity.end']
}, {
  headers: {
    'Content-Type': 'application/json',
    'Authorization': `Basic ${Buffer.from(apiKey).toString('base64')}`
  }
})
.then((response) => {
  const results = response.data.results;
  console.log(`Found ${results.length} SSL certificates with common name "${commonName}":`);
  results.forEach((result) => {
    console.log(`- Common Name: ${result.parsed.subject.common_name}`);
    console.log(`  Validity: ${result.parsed.validity.start} to ${result.parsed.validity.end}`);
  });
})
.catch((error) => {
  console.error(error);
});

在這篇博客中，我們討論了如何使用 Censys.io 的公共 API 文檔，包括一些用 JavaScript 編寫的示例代碼。有了這些知識，你應該能夠開始使用 Censys.io API 來訪問他們的全互聯網掃描服務。