Cuenta

Obtener la cuenta

Devuelve la cuenta que hizo la petición: su nombre, la zona horaria en la que se leen las fechas sin hora, su divisa y su país, los add-ons a los que tiene acceso (un recurso detrás de un add-on que no figura responde 402), si está en periodo de prueba, la clave de API que hizo la petición con sus…

Herramienta

filmo_account_get

Lecturaaccount:read

account:read
120/min
Anotación del servidor: Solo lectura
Anotación del servidor: Idempotente

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "filmo_account_get",
    "arguments": {}
  }
}

{
  "structuredContent": {
    "data": {
      "name": "Example",
      "timezone": "<timezone>",
      "currency": "EUR",
      "country": "ES",
      "language": "es-ES",
      "addons": [
        "platform"
      ],
      "trial": {
        "active": true,
        "endsAt": "2026-09-01T08:00:00Z"
      },
      "apiKey": {
        "id": "id_8f2a1c",
        "name": "Example",
        "scopes": [
          "<scopes>"
        ]
      },
      "rateLimits": {
        "global": {
          "perMinute": 1
        },
        "availability": {
          "perMinute": 1
        }
      },
      "api": {
        "version": "<version>",
        "docsUrl": "https://example.com"
      }
    },
    "meta": {
      "rateLimit": {
        "limit": 120,
        "remaining": 119,
        "reset": 42
      }
    }
  }
}

generado desde el esquema

Es la primera llamada de cualquier integración: sustituye a adivinar.

Argumentos

Esta herramienta no tiene argumentos.

Resultado

En un éxito el resultado lleva structuredContent con data y meta. Estos son los atributos de data.

Ver los atributos de data

namestring

Nombre de la cuenta.

timezonestring

Zona horaria IANA del negocio, aquella en la que se leen las fechas sin hora de los filtros.

currencystring

Moneda de la cuenta en ISO 4217; los documentos pueden llevar la suya.

countrystring

País del negocio en ISO 3166-1 alpha-2.

languagestring

Idioma por defecto de los mensajes de error de esta clave (BCP 47), salvo que Accept-Language indique otro.

addonsstring[]

Ids de los add-ons a los que la cuenta tiene acceso hoy. Un recurso tras un add-on que no figura aquí responde 402.

Opciones disponibles: platform, user-seat, connected-account, extra-tax-cif, qr-codes, incidence, purchases, activity-log, custom-fields, profitability, web-builder, crm, consignments, email-calendar, sales-documents, internal-bookings, internal-communication, advanced-user-permissions, ai-pack-25k, ai-pack-55k, ai-pack-115k

trialobject

Periodo de prueba de la cuenta.

Mostrar atributos hijos

trial.activeboolean

true mientras dura el periodo de prueba de la cuenta: todos los add-ons están desbloqueados.

trial.endsAtstring<date-time> | null

Fin de la prueba en ISO 8601 UTC; null si no hay.

apiKeyobject

La clave que hizo la petición. Nunca su secreto.

Mostrar atributos hijos

apiKey.idstring

Identificador de la clave de API que hizo la petición.

apiKey.namestring

Nombre dado a la clave cuando se creó.

apiKey.scopesstring[]

Scopes concedidos a la clave, los que pueden usar sus peticiones.

rateLimitsobject

Límites de uso de la clave, los que informan las cabeceras RateLimit-*.

Mostrar atributos hijos

rateLimits.globalobject

Peticiones por minuto en toda la API.

Mostrar atributos hijos

rateLimits.global.perMinuteinteger

rateLimits.availabilityobject

Peticiones por minuto de las consultas de disponibilidad, contadas aparte.

Mostrar atributos hijos

rateLimits.availability.perMinuteinteger

apiobject

El contrato con el que se sirve a esta cuenta.

Mostrar atributos hijos

api.versionstring

Versión del contrato de la API pública.

api.docsUrlstring

Dónde está la documentación de esta versión.

Un error es un resultado con isError: true y el problema en content[0].text; no hay structuredContent. Consulta Errores.

Prompts de ejemplo

¿A qué cuenta de Filmo estoy conectado y cuáles son su zona horaria y su moneda?

La misma operación por REST

Esta herramienta ejecuta GET /api/v1/account.

Cuenta
Obtener la cuenta
Devuelve la cuenta que hizo la petición: su nombre, la zona horaria en la que se leen las fechas sin hora, su divisa y su país, los add-ons a los que tiene acceso (un recurso detrás de un add-on que no figura responde 402), si está en periodo de prueba, la clave de API que hizo la petición con sus scopes, los límites de uso que informan las cabeceras RateLimit-* y la versión de este contrato.
Guías
Escrituras seguras
Un asistente que puede escribir también puede escribir lo equivocado. Decide qué herramientas necesitan a una persona, reintenta sin duplicar y sabe qué pone en marcha una escritura.
Guías
Errores
Un error de herramienta es un resultado con isError: true y el problema en el primer bloque de texto. Ramifica por su code.

¿Te ha resultado útil esta página?

Resultado

Argumentos

Resultado

Prompts de ejemplo

La misma operación por REST

Páginas relacionadas

Obtener la cuenta

Escrituras seguras

Errores