Security Scanning API for Developers

# Get your API key from profile
API_KEY="your_api_key_here"

# Create a target
curl -X POST https://secably.com/api/v1/targets/ \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"My Server","target_value":"example.com","target_type":"hostname"}'

# Start an Nmap scan
curl -X POST https://secably.com/api/v1/nmap/scan/ \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"target_id":123,"scan_config":{"scan_type":"full","port_range":"1-1000"}}'

# Response
{
  "scan_id": 5309,
  "status": "queued",
  "message": "Nmap scan started successfully"
}

# Check scan status
curl https://secably.com/api/v1/nmap/scan/5309/ \
  -H "Authorization: Bearer $API_KEY"

import requests

# Initialize the client
api_key = "YOUR_API_KEY"
headers = {
    "Authorization": f"Bearer {api_key}",
    "Content-Type": "application/json"
}

# Create a target
target_response = requests.post(
    "https://secably.com/api/v1/targets/",
    headers=headers,
    json={
        "name": "My Server",
        "target_value": "example.com",
        "target_type": "hostname"
    }
)
target_id = target_response.json()["id"]

# Start SSLyze SSL/TLS scan
scan_response = requests.post(
    "https://secably.com/api/v1/sslyze/scan/",
    headers=headers,
    json={
        "target_id": target_id,
        "scan_config": {
            "check_certificate": True,
            "check_tls_versions": True
        }
    }
)

scan_data = scan_response.json()
print(f"Scan ID: {scan_data['scan_id']}")
print(f"Status: {scan_data['status']}")

# Check scan status
status_response = requests.get(
    f"https://secably.com/api/v1/sslyze/scan/{scan_data['scan_id']}/",
    headers=headers
)
print(f"Security Score: {status_response.json()['security_score']}")

const axios = require('axios');

const API_KEY = 'YOUR_API_KEY';
const BASE_URL = 'https://secably.com/api/v1';

const headers = {
  'Authorization': `Bearer ${API_KEY}`,
  'Content-Type': 'application/json'
};

// Start a scan workflow
const runSecurityScan = async () => {
  try {
    // Create target
    const targetRes = await axios.post(
      `${BASE_URL}/targets/`,
      {
        name: 'My Server',
        target_value: 'example.com',
        target_type: 'hostname'
      },
      { headers }
    );

    const targetId = targetRes.data.id;
    console.log(`Target created: ${targetId}`);

    // Start OpenVAS scan
    const scanRes = await axios.post(
      `${BASE_URL}/openvas/scan/`,
      {
        target_id: targetId,
        scan_config: {
          scan_profile: 'full_and_fast'
        }
      },
      { headers }
    );

    console.log(`Scan started: ${scanRes.data.scan_id}`);
    console.log(`Status: ${scanRes.data.status}`);
  } catch (error) {
    console.error('Error:', error.response?.data || error.message);
  }
};

runSecurityScan();

package main

import (
    "bytes"
    "encoding/json"
    "fmt"
    "net/http"
)

func main() {
    // Prepare the request
    payload := map[string]interface{}{
        "target": "example.com",
        "scanner_type": "openvas",
        "scan_config": map[string]string{
            "scan_profile": "full_and_fast",
            "port_range": "default",
        },
    }

    jsonData, _ := json.Marshal(payload)

    req, _ := http.NewRequest("POST",
        "https://api.secably.com/v1/scans/create",
        bytes.NewBuffer(jsonData))

    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
    req.Header.Set("Content-Type", "application/json")

    // Send the request
    client := &http.Client{}
    resp, _ := client.Do(req)
    defer resp.Body.Close()

    // Parse response
    var result map[string]interface{}
    json.NewDecoder(resp.Body).Decode(&result)

    fmt.Printf("Scan ID: %v\n", result["scan_id"])
}