README

[Un-Official] A lightweight, Un-Official PHP Library for validating phone numbers and retrieving tags from the GetContact API. Designed to be framework-agnostic, efficient, and easy to integrate.

📦 Installation

Install the package via Composer:

composer require restugbk/get-contact

1. Basic Initialization

use Restugbk\GetContact;

$token    = 'YOUR_TOKEN';
$finalKey = 'YOUR_FINAL_KEY';

$getContact = new GetContact($token, $finalKey);

2. Validate Number of Tags

$number = '081234567890';

$response = $getContact->checkNumber($number);

if ($response['success']) {
    echo "Validated Number: " . $response['number'] . "\n";
    echo "Tags: " . implode(', ', $response['tags']) . "\n";
} else {
    echo "Error: " . $response['message'] . "\n";
}

3. Search Profile by Validated Number

$number = '081234567890';

$response = $getContact->searchNumber($number);

if ($response['success']) {
    echo "Validated Number: " . $response['number'] . "\n";
    echo "Profile: " . implode(', ', $response['profile']) . "\n";
} else {
    echo "Error: " . $response['message'] . "\n";
}

📋 Data Structure Reference

The checkNumber() method returns an array with the following keys:

🔑 How to Get Token

Requirements: Android with ROOT-rights (or emulator).

1. Install and login into GetContact app.
2. Open file manager on your phone and navigate to:

   /data/data/app.source.getcontact/shared_prefs/GetContactSettingsPref.xml

3. Inside the file, you will find:

   YOUR_TOKEN = TOKEN / CHAT_TOKEN
   YOUR_FINAL_KEY = FINAL_KEY

🤝 Contributing

Contributions are what make the open-source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

1. Fork the Project.
2. Create your Feature Branch (git checkout -b feature/AmazingFeature).
3. Commit your Changes (git commit -m 'Add some AmazingFeature').
4. Push to the Branch (git push origin feature/AmazingFeature).
5. Open a Pull Request.

📄 License

This open-source software is distributed under the MIT License. See LICENSE for more information.

🛠 Support

If you found this project helpful, please give it a ⭐ star!

For issues and questions, please create an issue in the GitHub repository.