API Documentation

// Using fetch API to create a shortened URL
const longUrl = "https://example.com/very/long/url-that-needs-shortening";

// GET Method (Simple)
const getUrl = async () => {
  const apiUrl = `https://adcode.nabzclan.vip/api/?url=${encodeURIComponent(longUrl)}`;
  
  try {
    const response = await fetch(apiUrl);
    const data = await response.json();
    
    if (data.status === 'success') {
      console.log("Shortened URL:", data.adcodeurl);
      return data.adcodeurl;
    } else {
      console.error("Error:", data.message);
      return null;
    }
  } catch (error) {
    console.error("Network error:", error);
    return null;
  }
};

// POST Method (Recommended for production)
const postUrl = async () => {
  try {
    const response = await fetch('https://adcode.nabzclan.vip/api/', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
      },
      body: JSON.stringify({
        url: longUrl,
        pass: 'optional_password'  // Remove this line if not using password
      })
    });
    
    const data = await response.json();
    
    if (data.status === 'success') {
      console.log("Shortened URL:", data.adcodeurl);
      return data.adcodeurl;
    } else {
      console.error("Error:", data.message);
      return null;
    }
  } catch (error) {
    console.error("Network error:", error);
    return null;
  }
};

// Call either getUrl() or postUrl() based on your preference

import requests
import urllib.parse

def get_shortened_url(long_url, password=None):
    """
    Get a shortened URL using the GET method
    
    Args:
        long_url (str): The URL to shorten
        password (str, optional): Password to protect the URL
        
    Returns:
        str or None: The shortened URL or None if an error occurred
    """
    # Build the API URL with parameters
    base_url = "https://adcode.nabzclan.vip/api/"
    api_url = f"{base_url}?url={urllib.parse.quote_plus(long_url)}"
    
    # Add password if provided
    if password:
        api_url += f"&pass={urllib.parse.quote_plus(password)}"
    
    try:
        # Make the API request
        response = requests.get(api_url)
        
        # Check if the request was successful
        if response.status_code == 200:
            data = response.json()
            if data['status'] == 'success':
                return data['adcodeurl']
            else:
                print(f"Error: {data['message']}")
                return None
        else:
            print(f"HTTP Error: {response.status_code}")
            return None
            
    except Exception as e:
        print(f"Request Error: {e}")
        return None

def post_shortened_url(long_url, password=None):
    """
    Get a shortened URL using the POST method (recommended)
    
    Args:
        long_url (str): The URL to shorten
        password (str, optional): Password to protect the URL
        
    Returns:
        str or None: The shortened URL or None if an error occurred
    """
    # Prepare the request payload
    payload = {'url': long_url}
    if password:
        payload['pass'] = password
    
    try:
        # Make the API request
        response = requests.post(
            "https://adcode.nabzclan.vip/api/",
            json=payload,
            headers={'Content-Type': 'application/json'}
        )
        
        # Check if the request was successful
        if response.status_code == 200:
            data = response.json()
            if data['status'] == 'success':
                return data['adcodeurl']
            else:
                print(f"Error: {data['message']}")
                return None
        else:
            print(f"HTTP Error: {response.status_code}")
            return None
            
    except Exception as e:
        print(f"Request Error: {e}")
        return None

# Example usage
if __name__ == "__main__":
    long_url = "https://example.com/very/long/url-that-needs-shortening"
    
    # Using GET method
    short_url = get_shortened_url(long_url)
    if short_url:
        print(f"Shortened URL (GET): {short_url}")
    
    # Using POST method (recommended)
    short_url = post_shortened_url(long_url, password="optional_password")
    if short_url:
        print(f"Shortened URL (POST): {short_url}")

# Basic URL shortening with GET method
curl -G "https://adcode.nabzclan.vip/api/" \
  --data-urlencode "url=https://example.com/very/long/url"

# Password protected URL with GET method
curl -G "https://adcode.nabzclan.vip/api/" \
  --data-urlencode "url=https://example.com/very/long/url" \
  --data-urlencode "pass=myPassword"

# Recommended: Basic URL shortening with POST method
curl -X POST "https://adcode.nabzclan.vip/api/" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com/very/long/url"}'

# Recommended: Password protected URL with POST method
curl -X POST "https://adcode.nabzclan.vip/api/" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com/very/long/url","pass":"myPassword"}'

# Shell script example to process the response
#!/bin/bash
response=$(curl -s -X POST "https://adcode.nabzclan.vip/api/" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com/very/long/url"}')

# Parse the JSON response (requires jq)
status=$(echo $response | jq -r '.status')
if [ "$status" = "success" ]; then
  shorturl=$(echo $response | jq -r '.adcodeurl')
  echo "Shortened URL: $shorturl"
else
  error=$(echo $response | jq -r '.message')
  echo "Error: $error"
fi