API Reference
Start typing to search…

Configuring Proxy Session ID & Lifetime

get http://ip-api.com/json/

Configuring Proxy Session ID and Lifetime

Controlling the duration of your proxy sessions is essential for efficient and secure internet usage.
By creating sessions and providing lifetimes, you can set how long each connection lasts, ensuring uninterrupted and secure activities.
This feature aids in resource management, privacy maintenance, and overall performance enhancement.

Understanding the lifetime Parameter

Lifetime Constraints

  • Minimum lifetime: 3 minutes
  • Maximum lifetime: 1440 minutes (24 hours)
  • Default lifetime: 10 minutes

The lifetime parameter is measured in minutes. This defines how long the resource remains valid before it expires.

Examples:

  • lifetime: 5 → 5 minutes
  • lifetime: 30 → 30 minutes
  • lifetime: 60 → 1 hour
  • lifetime: 180 → 3 hours (since 3 hours = 180 minutes)

Custom Session ID Rules

Your custom session ID must follow a simple set of rules to be valid. Think of these rules as guidelines to ensure the string is clean, consistent,
and machine-readable.

✅ Start with a Valid Character:

The first character must be one of the following:

  • An uppercase letter (A-Z)
  • A lowercase letter (a-z)
  • A digit (0-9)
  • An underscore (_)

📏 Character Length:

  • The allowed characters can be repeated, but the total length must be between 1 and 25 characters.
  • This provides enough space for descriptive IDs while avoiding overly lengthy names.

🚫 No Extra Characters:

  • The string must end immediately after these 1 to 25 characters.
  • It cannot contain spaces or special symbols before or after the allowed characters.

📝 Simplified Explanation

In simpler terms:

  • The session ID must be composed entirely of 1 to 25 alphanumeric characters or underscores (_).

If you're familiar with regular expressions (regex), here’s what it looks like: 

^[A-Za-z0-9_]{1,25}$

This regex ensures:
✔ The string starts with a valid character.
✔ It contains only valid characters throughout.
✔ It ends precisely within the specified range of 1 to 25 characters.

Example cURL request:

curl \
  -x proxy.geonode.io:10000 \
  -U "username123-session-random001-lifetime-10:password123" \
  http://ip-api.com
Language