Managing UUIDs for Clients

[iwatkot]

Problem: The 3x-ui API does not return the actual Client UUID, it's returning just numerical ID, while for updating a client you'll need to know its UUID.

[iwatkot]

Solution: When creating a new Client you will need to save some sort of a map, e.g. e-mail -> UUID. It's up to you how to store this information, but without UUID you will not be able to update the Client.
Code reference:

# First we obtain the user UUID somewhere (e.g. from the database) and pass it into the function above. 

async def set_traffic_limit(telegram_id: int, user_uuid: str) -> None:
    client = await api.client.get_by_email(str(telegram_id)) # Getting the client from API.
    client.id = user_uuid # Updating the client ID to correct UUID (e.g. from the database).
    client.total_gb = gigabytes_to_bytes(10) # Just for reference, setting the traffic limit for a Client to 10 Gb.
    await api.client.update(user_uuid, client) # Updating the client.

[Goosegit11]

You can get it through get_inbounds() method, like that:

inbounds = await get_inbounds()
inbound = inbounds[0]
id = inbound.settings.clients[0].id

[iwatkot]

@Goosegit11 hey!

On the previous versions of 3x-ui I was receiving numerical IDs (1, 2, 3 and so on), not actual UUIDs.

And also, I remember there was inconsistency in the API responses for different protocols, for example some were returning this data, while other - not.

So need to check of now it returns required data everywhere and maybe close this thread.

Sincerely

[Goosegit11]

No no

The thing is, with client.id you get a numeric ID, that's true. Like this:

client: client = await api.client.get_by_email(email)

print(client.id) # 1

But you can also get the client through the get_inbounds() method, and now it has UUID in it.

That's how I got around this problem.

So, you could put something like that to get client UUID by its email

inbounds = await get_inbounds()
inbound = inbounds[0] # get first inbound

client: client = await api.client.get_by_email(email)
num_id = client.id - 1
client_uuid = inbound.settings.clients[num_id].id

[Goosegit11]

oh and that's for vless particularly. haven't tried other protos

I remember there was inconsistency in the API responses for different protocols, for example some were returning this data, while other - not.