Información del usuario
curl --request GET \
--url https://api.vertracloud.app/v1/users/me \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.vertracloud.app/v1/users/me', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.vertracloud.app/v1/users/me"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.vertracloud.app/v1/users/me"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"response": {
"id": "123456789012345678",
"email": "[email protected]",
"name": "user",
"language": "pt-br",
"plan": {
"name": "pro",
"expires_at": "2026-04-20T00:00:00.000Z",
"duration": 30,
"memory": {
"limit": 1024,
"used": 1024
}
},
"applications": [
{
"id": "v111d4af8cd74272a284831fbae14a8v",
"type": 2,
"name": "My API",
"description": "REST API with Express",
"language": "javascript",
"ram": 512,
"status": "up",
"subdomain": "my-api",
"domains": [],
"owner_plan": "pro",
"owner_id": "123456789012345678",
"main_file": "src/index.js",
"version": "recommended",
"start_command": "npm start",
"last_snapshot": "2026-03-15T10:00:00.000Z",
"offline_since": null,
"created_at": "2026-01-15T15:51:47.234Z",
"updated_at": "2026-03-19T15:06:41.449Z"
}
],
"databases": [
{
"id": "v41806687fe6488884a464d1dc06692v",
"type": 1,
"owner_plan": "pro",
"name": "my-postgres",
"description": "PostgreSQL Database",
"status": "up",
"ram": 1024,
"host": "database.example.com",
"port": 5432,
"owner_id": "123456789012345678",
"last_snapshot": "2026-03-18T00:00:00.000Z",
"offline_since": null,
"created_at": "2026-02-01T22:00:54.785Z",
"updated_at": "2026-03-19T22:13:38.489Z"
}
],
"connections": [
{
"provider": "github",
"username": "myuser",
"created_at": "2026-01-15T15:51:47.234Z"
},
{
"provider": "discord",
"username": "myuser#1234",
"created_at": "2026-01-15T15:51:47.234Z"
}
],
"created_at": "2026-01-15T01:26:04.784Z",
"updated_at": "2026-03-19T22:10:31.220Z"
}
}
Usuarios
Información del usuario
Devuelve la información completa del usuario, incluidas aplicaciones, bases de datos, plan y conexiones OAuth.
GET
/
v1
/
users
/
me
Información del usuario
curl --request GET \
--url https://api.vertracloud.app/v1/users/me \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.vertracloud.app/v1/users/me', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.vertracloud.app/v1/users/me"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.vertracloud.app/v1/users/me"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"response": {
"id": "123456789012345678",
"email": "[email protected]",
"name": "user",
"language": "pt-br",
"plan": {
"name": "pro",
"expires_at": "2026-04-20T00:00:00.000Z",
"duration": 30,
"memory": {
"limit": 1024,
"used": 1024
}
},
"applications": [
{
"id": "v111d4af8cd74272a284831fbae14a8v",
"type": 2,
"name": "My API",
"description": "REST API with Express",
"language": "javascript",
"ram": 512,
"status": "up",
"subdomain": "my-api",
"domains": [],
"owner_plan": "pro",
"owner_id": "123456789012345678",
"main_file": "src/index.js",
"version": "recommended",
"start_command": "npm start",
"last_snapshot": "2026-03-15T10:00:00.000Z",
"offline_since": null,
"created_at": "2026-01-15T15:51:47.234Z",
"updated_at": "2026-03-19T15:06:41.449Z"
}
],
"databases": [
{
"id": "v41806687fe6488884a464d1dc06692v",
"type": 1,
"owner_plan": "pro",
"name": "my-postgres",
"description": "PostgreSQL Database",
"status": "up",
"ram": 1024,
"host": "database.example.com",
"port": 5432,
"owner_id": "123456789012345678",
"last_snapshot": "2026-03-18T00:00:00.000Z",
"offline_since": null,
"created_at": "2026-02-01T22:00:54.785Z",
"updated_at": "2026-03-19T22:13:38.489Z"
}
],
"connections": [
{
"provider": "github",
"username": "myuser",
"created_at": "2026-01-15T15:51:47.234Z"
},
{
"provider": "discord",
"username": "myuser#1234",
"created_at": "2026-01-15T15:51:47.234Z"
}
],
"created_at": "2026-01-15T01:26:04.784Z",
"updated_at": "2026-03-19T22:10:31.220Z"
}
}
Respuesta
APIUserInfoResponse
Datos completos del usuario autenticado.
Mostrar Mostrar objeto
Mostrar Mostrar objeto
string
ID único del usuario (Snowflake).
string
Correo electrónico del usuario.
string
Nombre visible del usuario.
string
Idioma preferido del usuario (
pt-br, en-us, es-es).string
Fecha de creación de la cuenta (ISO 8601).
string
Fecha de la última actualización de la cuenta (ISO 8601).
APIUserPlan | null
Información del plan actual, o
null cuando la cuenta no tiene un plan activo. Una cuenta sin plan no puede
crear aplicaciones ni bases de datos (PLAN_REQUIRED).Mostrar Mostrar objeto
Mostrar Mostrar objeto
string
El nombre del plan:
economy, pro, scale, intermediary o enterprise-<GB>, donde <GB> es 4, 6, 8, 12, 14, 16,
18, 20, 22, 24, 26, 28, 30 o 32 (por ejemplo, enterprise-8). El nombre es el único identificador del plan.string
Fecha de vencimiento del plan.
integer
Duración del plan en días.
APIApplication[]
Lista de aplicaciones del usuario.
Mostrar Mostrar objeto
Mostrar Mostrar objeto
string
ID único de la aplicación (Snowflake).
integer
ID del clúster que aloja la aplicación.
integer
Tipo de aplicación.
1 = Bot, 2 = Sitio web.string
Nombre de la aplicación.
string | undefined
Descripción de la aplicación.
string
Lenguaje de programación (
javascript, typescript, python, go, php, ruby, java, rust, bun, deno, dotnet, elixir, static).integer
Memoria asignada en MB.
string
Estado actual:
up, down o building.string | null
Subdominio de la aplicación.
APIApplicationDomain[]
Los dominios personalizados de la aplicación, con estado, puerto, prefijo de ruta y redirección. Vacío cuando no tiene
ninguno. Los campos se describen en Listar dominios de la aplicación.
string | null
El nombre del plan del propietario, o
null cuando el propietario no tiene plan.string
Archivo principal de la aplicación.
string
Versión del runtime (
recommended, latest o una versión específica).string | null
Fecha del último snapshot.
string | null
Fecha desde la que la aplicación está fuera de línea.
null si está en línea.string
Fecha de creación.
string
Fecha de la última actualización.
APIDatabase[]
Lista de bases de datos del usuario.
Mostrar Mostrar objeto
Mostrar Mostrar objeto
string
ID único de la base de datos (Snowflake).
integer
ID del clúster.
integer
Tipo:
1 = PostgreSQL, 2 = MongoDB, 3 = Redis, 4 = MySQL.string | null
El nombre del plan del propietario (por ejemplo,
pro), o null cuando el propietario no tiene plan.string
Nombre de la base de datos.
string
Descripción de la base de datos.
string
Estado actual:
up, down o building.integer
Memoria asignada en MB.
string
Dirección del host para la conexión.
integer
Puerto de conexión.
string | null
Fecha del último snapshot.
string | null
Fecha desde la que está fuera de línea.
string
Fecha de creación.
string
Fecha de la última actualización.
APIWorkspaceResourceOrganization
La organización personal del usuario. Es privada para este usuario e incluye las carpetas y los favoritos usados
para organizar aplicaciones y bases de datos. Los detalles de las modificaciones están en
Organización personal de recursos.
Mostrar Mostrar objeto
Mostrar Mostrar objeto
string
Siempre
personal en esta respuesta.string
ID del usuario propietario de esta organización.
string | null
Siempre
null en esta respuesta personal.APIWorkspaceResourceFolder[]
Carpetas personales. Cada carpeta contiene
id, name, color, position, resources,
created_at y updated_at. color es neutral, red, orange, yellow, green,
blue o purple.APIWorkspaceFavorite[]
Favoritos personales. Cada elemento contiene
resource_type (application o database),
resource_id, position y created_at.{
"response": {
"id": "123456789012345678",
"email": "[email protected]",
"name": "user",
"language": "pt-br",
"plan": {
"name": "pro",
"expires_at": "2026-04-20T00:00:00.000Z",
"duration": 30,
"memory": {
"limit": 1024,
"used": 1024
}
},
"applications": [
{
"id": "v111d4af8cd74272a284831fbae14a8v",
"type": 2,
"name": "My API",
"description": "REST API with Express",
"language": "javascript",
"ram": 512,
"status": "up",
"subdomain": "my-api",
"domains": [],
"owner_plan": "pro",
"owner_id": "123456789012345678",
"main_file": "src/index.js",
"version": "recommended",
"start_command": "npm start",
"last_snapshot": "2026-03-15T10:00:00.000Z",
"offline_since": null,
"created_at": "2026-01-15T15:51:47.234Z",
"updated_at": "2026-03-19T15:06:41.449Z"
}
],
"databases": [
{
"id": "v41806687fe6488884a464d1dc06692v",
"type": 1,
"owner_plan": "pro",
"name": "my-postgres",
"description": "PostgreSQL Database",
"status": "up",
"ram": 1024,
"host": "database.example.com",
"port": 5432,
"owner_id": "123456789012345678",
"last_snapshot": "2026-03-18T00:00:00.000Z",
"offline_since": null,
"created_at": "2026-02-01T22:00:54.785Z",
"updated_at": "2026-03-19T22:13:38.489Z"
}
],
"connections": [
{
"provider": "github",
"username": "myuser",
"created_at": "2026-01-15T15:51:47.234Z"
},
{
"provider": "discord",
"username": "myuser#1234",
"created_at": "2026-01-15T15:51:47.234Z"
}
],
"created_at": "2026-01-15T01:26:04.784Z",
"updated_at": "2026-03-19T22:10:31.220Z"
}
}
Última modificación el 28 de octubre de 2026