textverified-async 0.0.2

A simple asynchronous Python API client for working with the Textverified REST API

Unofficial Textverified API client in Python

ℹ️ About the Project

This library is designed to access the TextVerified API using an asynchronous Python client.

---

🏎 The difference between the official and my code

🐢 The official Python client uses a slow http.client, and also stops the main stream (for example, the client.sms.incoming function)

🚀 My client uses aiohttp as a request handler, and also has support for create_task and gather processes without blocking the main flow.

🔐 This client also supports Bearer tokens and automatically generates them after they expire for secure access to the API (just like the official client, but faster)

💻 Installation

Library download is recommended for Python >= 3.9

pip install textverified_async

🛠 Usage

Current available methods:

• Account Info
• Bearer Token
• Service List
• Sales
• Billing Cycles
• Back order rental reservation
• List Reservations
• Verifications (Soon)
• New Rental / Verification
• Renewable Rentals
• NonRenewable Rentals
• SMS
• Calls and Voices
• Wake Requests
• Webhook
• Legacy

There is no documentation yet, but it is quite easy to use. You can also hold down CTRL on the client and view the available functions and models, or get the current mini-documentation by hovering over the function.

Import the library

from textverified_async.api import TextVerifiedApi

Then create an API class (it will automatically create a session and token)

api = TextVerifiedApi(“api-key”, “username”)

Next, you can safely use commands from the API using its class

For example:

info = await api.get_account_info()

Note: If you want to get the information you need right away, put the asynchronous function in parentheses

Example:

balance = (await api.get_account_info()).currentBalance

All responses from the API will have the same value as in Textverified REST.API

📋 Example

Here is an example of code for using the client (you will also see this code in the api.py class of the library):

from textverified_async.api import TextVerifiedApi

# Usage
async def main():
    api = TextVerifiedApi(“api”, “mail”)
    
    await api.generate_bearer ()
    status = await api.check_token_status()
    print(f“Token status: {status}”)

    try:
        # Get all rented numbers
        all_rentals = await api.get_rentals()
        print(f“Found {len(all_rentals)} rentals:”)

        for rental in all_rentals:
            print(f“- {rental.serviceName}: {rental.number} ({rental.state})”)
                
        # Example of getting detailed information about a specific number
        if all_rentals:
            first_rental = all_rentals[0]
            print(f“\nGetting details for rental: {first_rental.id}”)

            rental_details = await api.get_rental_by_id(first_rental.id)

			print(f“Detailed info for {rental_details.number}:”)
			print(f“  Service: {rental_details.serviceName}”)
			print(f“  State: {rental_details.state}”)
            print(f“  Always on: {rental_details.alwaysOn}”)
            print(f“  Can refund: {rental_details.refund.canRefund}”)
            print(f“  Billing cycle ID: {rental_details.billingCycleId}”)

        wake = await api.wake_up_reservation(first_rental.id)
        print(f“\nWoke up {wake.usageWindowStart} | Woke down {wake.usageWindowEnd} with wake ID {wake.id}”)
                
    except Exception as e:
        print(f“Error: {e}”)


if __name__ == “__main__”:
    asyncio.run(main())