Límites de frecuencia
Cada clave tiene dos límites: solicitudes por minuto y por día (el día se cuenta en UTC). Los valores de su clave los muestra GET /me en el campo rateLimit (rpm y rpd).
Cada respuesta a una llamada autenticada lleva el estado del límite que esté más cerca de agotarse, también las descargas de archivos (cuentan para el límite de frecuencia). Las respuestas dadas antes de comprobar la clave o el límite no llevan estas cabeceras: clave no válida (401), cuerpo mal formado (400), ruta desconocida (404), parámetros de consulta no válidos (400 validation), falta de ámbito (403 forbidden_scope), escritura rechazada para una clave de prueba (403).
En el navegador (CORS) se pueden leer las cabeceras RateLimit-*, Retry-After, Grem-Sandbox, X-Request-Id y Content-Range.
RateLimit-Limit: 60
RateLimit-Remaining: 12
RateLimit-Reset: 41
| Encabezado | Significado |
|---|---|
RateLimit-Limit | solicitudes permitidas en la ventana actual |
RateLimit-Remaining | solicitudes restantes |
RateLimit-Reset | segundos hasta que se reinicie la ventana |
Por encima del límite llega 429 con title: rate_limited y un encabezado Retry-After. El límite de frecuencia es una protección técnica y nunca cobra nada.
Vigile RateLimit-Remaining y reparta las solicitudes en el tiempo. La consulta del estado de los trabajos también cuenta para el límite, aunque sea gratuita: no consulte más a menudo que cada pocos segundos o pase a webhooks.
Cobro
No existe un plan de API aparte: el acceso forma parte de su suscripción y las acciones de pago se descuentan del mismo monedero que en el panel.
Una llamada de pago tiene dos partes:
- La llamada a la API. Del volumen de llamadas incluido en el plan. Por encima, las llamadas se cobran por uso.
- El precio de la herramienta: lo mismo que cuesta esa acción en el panel (del volumen incluido o del monedero).
Volumen de llamadas a la API por plan:
| Plan | Llamadas a la API al mes |
|---|---|
| Free | 100 |
| Start | 5.000 |
| PRO | 25.000 |
| MAX | 100.000 |
| Agency Start | 50.000 |
| Agency Growth | 250.000 |
| Agency Scale | ilimitado dentro de un uso razonable |
Otros planes, así como los volúmenes y precios actuales de las herramientas, están en la página de planes del panel.
Qué se cobra y qué no
La clase de cobro de cada operación figura en /openapi.json, campo x-grem-billing: free, api_call o api_call+sku:... (llamada más precio de la herramienta).
| De pago | Gratis |
|---|---|
Lanzar herramientas (POST a valoración, textos, vídeo, foto, PDF, sitio, etc.): llamada + precio de la herramienta | todas las lecturas (GET), incluidas consultas de trabajos y descargas |
| Folleto y confirmación de la revisión de informe: solo la llamada | Inmuebles: crear, editar, eliminar |
| Mensaje de chat: llamada + precio del mensaje | Leads y Swipe Match: crear, editar, eventos |
| Crear, editar y eliminar sesiones de chat: solo la llamada | Subir imágenes |
| Gestionar webhooks |
Una solicitud rechazada (4xx o 5xx) no consume llamada a la API. La excepción es 502 provider_error tras un tiempo de espera agotado: el trabajo puede terminar y cobrarse; compruebe GET /works (mejora de fotos, sitio y borrador: en el panel o entre sus inmuebles). Repetir la valoración exprés con el mismo Idempotency-Key devuelve el resultado gratis (ni la valoración ni la llamada a la API); en otras herramientas la clave queda ocupada 15 minutos tras el tiempo agotado: compruebe el resultado en lugar de repetir.
Las llamadas, el gasto y los errores por clave se ven en el panel, página API, pestaña Analítica.
Artículos relacionados
- Errores:
402y429. - Idempotencia: repeticiones seguras sin doble cobro.