IP2Location

When using the IP2Location integration in EvidenceHub, you may encounter error messages. This guide explains the error codes and messages, their meanings, and how to resolve them.

Error Code Overview

Error Code Error Message Description Solution
10000 Invalid API key or insufficient query. API key issue or query limit reached Verify API key and check usage limits
10001 Invalid IP address. The provided IP address is not valid Check IP format
10002 Internal server error. Server-side issue with IP2Location Retry later or contact support
10004 Translation is not available with your plan. Plan limitation Upgrade plan or use supported languages

 

Detailed Explanations

10000 - Invalid API key or insufficient query

Description: This error occurs when the provided API key is invalid or when you've reached the query limit for your current plan.

Resolution:

  • Verify that your API key is correct and active.
  • Check your current usage and plan limits in your IP2Location account.

Steps to Take:

  1. Log in to your IP2Location account.
  2. Navigate to the API key section and verify your key.
  3. Copy the API key and paste it into EvidenceHub's IP2Location integration settings.
  4. Save the configuration and try your query again.
  5. If the error persists, check your usage statistics and plan limits.
  6. Consider upgrading your plan if you've reached your query limit.

10001 - Invalid IP address

Description: The IP address provided in the query is not in a valid format or doesn't exist.

Resolution:

  • Ensure the IP address you're querying is in the correct format.
  • Check for any typos or formatting errors in the IP address.

Valid Formats:

  • IPv4: Four groups of numbers separated by dots (e.g., 192.168.1.1)
  • IPv6: Eight groups of four hexadecimal digits separated by colons (e.g., 2001:0db8:85a3:0000:0000:8a2e:0370:7334)

Steps to Take:

  1. Review the IP address you're trying to query.
  2. Ensure it's in the correct IPv4 or IPv6 format.
  3. If you're unsure about the format, use an IP address validator tool online.
  4. Correct any formatting issues and try your query again.

10002 - Internal server error

Description: This error indicates a problem on IP2Location's server side.

Resolution:

  • This issue is typically temporary and resolves on its own.
  • If the problem persists, it may require attention from IP2Location's support team.

Steps to Take:

  1. Wait a few minutes and try your query again.
  2. If the error continues, check IP2Location's status page or social media for any announced issues.
  3. If the problem persists for an extended period, contact IP2Location support.

10004 - Translation is not available with your plan

Description: Your current IP2Location plan does not include translation services.

Resolution:

  • Upgrade to a plan that includes translation services.
  • Use only the languages supported by your current plan.

Steps to Take:

  1. Log in to your IP2Location account.
  2. Review your current plan and its features.
  3. If translation is necessary for your use case, consider upgrading your plan.
  4. If upgrading is not an option, modify your queries to use only the languages supported by your current plan.

General Troubleshooting Tips for IP2Location Integration

  1. API Key Management:
    • Keep your API key secure and don't share it with unauthorized parties.
    • Regularly check the validity of your API key in your IP2Location account.
    • If you suspect your API key is compromised, regenerate it in your IP2Location account and update it in EvidenceHub.
  2. Usage Monitoring:
    • Regularly monitor your API usage to avoid hitting query limits unexpectedly.
    • Set up alerts in your IP2Location account for when you're approaching your usage limits.
  3. Data Accuracy:
    • Ensure the IP addresses you're querying are current and accurate.
    • Consider the context and source of the IP addresses you're investigating.
  4. Integration Updates:
    • Keep your EvidenceHub integration with IP2Location up to date.
    • Check for any announcements from IP2Location about API changes or updates.
  5. Error Logging:
    • If you encounter persistent errors, log the full error messages and the queries that caused them.
    • This information can be valuable when seeking support from EvidenceHub or IP2Location.

For additional assistance or if you encounter errors not listed here, please contact EvidenceHub support or consult the IP2Location API documentation.

Additional Resources

Remember to always use IP2Location and other threat intelligence services responsibly and in compliance with all applicable laws and regulations.