[{"data":1,"prerenderedAt":714},["ShallowReactive",2],{"developers:\u002Fdevelopers\u002Fes\u002Frate-limits":3},{"doc":4,"lang":384,"nav":395,"alternatePath":500,"policy":501,"specVersion":545,"reference":546,"layout":703,"toc":704,"prev":711,"next":712,"operations":713,"overview":7,"heroExample":7},{"id":5,"title":6,"apiTag":7,"body":8,"description":381,"draft":382,"extension":383,"lang":384,"meta":385,"navTitle":7,"navigation":386,"order":387,"path":388,"rawbody":389,"section":390,"seo":391,"stem":392,"translationKey":393,"version":7,"__hash__":394},"developers_es\u002Fdevelopers\u002Fes\u002Frate-limits.md","Límites de frecuencia y cuota",null,{"type":9,"value":10,"toc":369},"minimark",[11,28,41,46,49,124,135,139,159,162,207,216,235,238,249,252,255,268,272,280,309,325,329,337,340,344],[12,13,14,15,19,20,23,24,27],"p",{},"Cada clave tiene dos límites, compartidos por todos los equipos que lee: un ",[16,17,18],"strong",{},"límite de frecuencia",", que fija a qué velocidad lee, y una ",[16,21,22],{},"cuota diaria",", que fija cuánto lee. Los dos cuentan ",[16,25,26],{},"elementos",", no peticiones. Un elemento es un objeto de una respuesta: una página del feed con 100 cambios son 100 elementos, eliminaciones incluidas.",[29,30,33],"dev-callout",{"title":31,"type":32},"Aproximados durante la Beta","note",[12,34,35,36,40],{},"En la Beta, cada servidor que atiende tus peticiones cuenta por separado estos límites y el bloqueo por intentos fallidos, y un reinicio empieza su cuenta de nuevo. Por eso las cifras de esta página son aproximadas: una clave a veces puede leer más, y una petición rechazada con ",[37,38,39],"code",{},"429"," puede funcionar al reintentarla. Diseña tu integración para las cifras de esta página.",[42,43,45],"h2",{"id":44},"dos-límites-por-clave","Dos límites por clave",[12,47,48],{},"Qué peticiones cuentan para cada límite:",[50,51,52,68],"table",{},[53,54,55],"thead",{},[56,57,58,62,65],"tr",{},[59,60,61],"th",{},"Peticiones",[59,63,64],{},"Límite de frecuencia",[59,66,67],{},"Cuota diaria",[69,70,71,93,113],"tbody",{},[56,72,73,88,91],{},[74,75,76,77,80,81,84,85],"td",{},"El feed de cambios, todas las listas, las actividades de un lead, ",[37,78,79],{},"GET \u002Fv1\u002Fteams",", ",[37,82,83],{},"GET \u002Fv1\u002Fmembers"," y ",[37,86,87],{},"GET \u002Fv1\u002Fbooking_services",[74,89,90],{},"Sí",[74,92,90],{},[56,94,95,108,110],{},[74,96,97,98,101,102,84,105],{},"Una petición de un solo registro, como ",[37,99,100],{},"GET \u002Fv1\u002Fleads\u002F{id}",", y también ",[37,103,104],{},"POST \u002Fv1\u002Fleads\u002Fsearch",[37,106,107],{},"GET \u002Fv1\u002Fme",[74,109,90],{},[74,111,112],{},"No",[56,114,115,120,122],{},[74,116,117],{},[37,118,119],{},"GET \u002Fv1\u002Fhealth",[74,121,112],{},[74,123,112],{},[12,125,126,127,130,131,134],{},"Cada endpoint de la referencia indica su fila: ",[16,128,129],{},"Sincronización"," para la primera y ",[16,132,133],{},"Lectura"," para la segunda.",[136,137,64],"h3",{"id":138},"límite-de-frecuencia",[12,140,141,142,146,147,150,151,154,155,158],{},"Una clave lee hasta ",[143,144],"api-const",{"name":145},"SYNC_VELOCITY.perMinute"," elementos por minuto, con ráfagas de hasta ",[143,148],{"name":149},"SYNC_VELOCITY.burst",". La capacidad que no usas se recupera a ese ritmo hasta completar de nuevo la ráfaga. Al superar el límite, la API responde ",[37,152,153],{},"429 rate_limited",", y ",[37,156,157],{},"Retry-After"," indica cuánto falta para que haya sitio para tu petición.",[12,160,161],{},"Cómo cuenta una petición:",[163,164,165,180,191,201],"ul",{},[166,167,168,169,172,173,175,176,179],"li",{},"Antes de ejecutarse, una petición aparta su ",[37,170,171],{},"limit",". Una petición de lista o del feed que no envía ",[37,174,171],{}," aparta ",[143,177],{"name":178},"PAGE_LIMIT.default","; una petición de un solo registro aparta uno.",[166,181,182,183,186,187,190],{},"Una vez ejecutada, se le cobran los elementos que devolvió, y como mínimo uno. Una página corta devuelve la diferencia, pero una petición que no devuelve nada cuesta igualmente un elemento: una búsqueda que no encuentra ningún lead, un identificador que responde ",[37,184,185],{},"404"," o cualquier otro error que reciba durante su ejecución, ",[37,188,189],{},"quota_exceeded"," incluido.",[166,192,193,194,197,198,200],{},"Una petición rechazada antes de ejecutarse no se cobra, como una autenticación fallida, un permiso que falta o, en una ruta que usa ",[37,195,196],{},"Totem-Team",", un equipo que la clave no puede leer o que aún no está listo. Una petición que indica un registro por su identificador, como ",[37,199,100],{}," o las actividades de un lead, comprueba su equipo durante la ejecución, así que un rechazo por ese equipo cuesta un elemento.",[166,202,203,204,206],{},"A una petición de un solo registro se le cobra lo que devuelve: ",[37,205,100],{}," devuelve un lead con sus dos facetas, así que cuenta hasta tres elementos. Una búsqueda cuenta cada lead que devuelve, o uno si no encuentra ninguno.",[12,208,209,210,212,213,215],{},"Como una petición aparta primero su ",[37,211,171],{}," completo, un ",[37,214,171],{}," más pequeño te permite seguir leyendo cuando queda poca capacidad.",[12,217,218,220,221,223,224,228,229,234],{},[37,219,153],{}," también puede significar que tu dirección IP o tu clave están bloqueadas tras demasiados intentos de autenticación fallidos. ",[37,222,157],{}," distingue los dos casos: un bloqueo siempre envía ",[143,225],{"name":226,"divide":227},"AUTH_FAILURE_LIMITS.banMs","1000"," segundos, la duración completa del bloqueo, mientras que el límite de frecuencia pide los pocos segundos que necesita tu petición. Ir más despacio no termina un bloqueo: busca el proceso de esa dirección que envía una clave ausente, mal formada, incorrecta o desconocida, corrígelo y espera. ",[230,231,233],"a",{"href":232},"\u002Fdevelopers\u002Fes\u002Fauthentication#intentos-fallidos","Autenticación"," explica qué cuenta como intento fallido.",[136,236,67],{"id":237},"cuota-diaria",[12,239,240,241,244,245,248],{},"Cada día UTC, una clave puede leer ",[143,242],{"name":243},"SYNC_DAILY_BUDGET.floor"," elementos, o ",[143,246],{"name":247},"SYNC_DAILY_BUDGET.recordsMultiplier"," veces el número de registros de sus equipos si es mayor. Para ese número cuentan los registros de todos los tipos, eliminaciones incluidas. Para la cuota cuenta cada elemento que devuelven las peticiones de la primera fila de la tabla, sea del tipo que sea.",[12,250,251],{},"El número de registros se toma con la primera petición de la clave de cada día UTC, así que un equipo que se añade a la clave más tarde ese día puede aumentar la cuota solo a partir del día siguiente. Planifica la carga inicial de un equipo grande para cuando su cuota lo permita.",[12,253,254],{},"La cuota deja margen para una carga inicial de todos los equipos y un día de consultas periódicas. Lo que la agota es volver a leer listas enteras una y otra vez.",[12,256,257,258,261,262,264,265,267],{},"Al agotar la cuota, esas peticiones responden ",[37,259,260],{},"429 quota_exceeded"," hasta las 00:00 UTC, cuando la cuota se renueva. ",[37,263,157],{}," indica los segundos que faltan. Las peticiones de un solo registro, la búsqueda y ",[37,266,107],{}," siguen funcionando.",[42,269,271],{"id":270},"reintenta-tras-un-429","Reintenta tras un 429",[12,273,274,276,277,279],{},[37,275,157],{}," llega con cada ",[37,278,39],{}," que devuelve la propia API, y siempre es un número entero de segundos. Espera al menos ese tiempo y vuelve a enviar la misma petición, con el mismo cursor. Mientras esperas no se pierde nada: el feed te guarda todos los cambios.",[163,281,282,296],{},[166,283,284,285,288,289,291,292,295],{},"Tras ",[37,286,287],{},"rate_limited",", la espera suele ser de unos segundos, o de ",[143,290],{"name":226,"divide":227}," segundos tras un ",[230,293,294],{"href":232},"bloqueo por intentos fallidos",".",[166,297,284,298,300,301,305,306,295],{},[37,299,189],{},", la espera dura hasta las 00:00 UTC y puede ser de horas. No dejes un proceso dormido tanto tiempo: termina la ejecución y programa la siguiente para esa hora. El ",[230,302,304],{"href":303},"\u002Fdevelopers\u002Fes\u002Fsync#cliente-de-referencia-probado","cliente de referencia"," lo hace con su resultado ",[37,307,308],{},"retry_later",[12,310,311,312,314,315,317,318,321,322,324],{},"Un ",[37,313,39],{}," del cortafuegos que protege la API no trae ",[37,316,157],{}," ni cuerpo de error JSON: reintenta con espera exponencial. Un ",[37,319,320],{},"5xx"," tampoco lleva ",[37,323,157],{},": reinténtalo también con espera exponencial.",[42,326,328],{"id":327},"estimación-de-la-carga-inicial","Estimación de la carga inicial",[12,330,331,332,336],{},"La tabla da el tiempo mínimo que el límite de frecuencia añade a una carga inicial, según los límites de esta página, para una sola clave sin más tráfico; durante la Beta es aproximado, como explica la nota del principio de esta página. Cuenta los registros de todos los tipos, un elemento cada uno: un lead con su atribución, su respuesta y tres actividades son seis registros. El tiempo de red, y el que Totem necesita para preparar un equipo recién añadido a una clave, se suman a esas cifras. Una copia que cabe en la ráfaga muestra ",[333,334,335],"em",{},"Menos de 1 minuto",": el límite de frecuencia no le añade nada, pero sigue llevando el tiempo de sus peticiones.",[338,339],"dev-initial-sync-table",{},[42,341,343],{"id":342},"buenas-prácticas","Buenas prácticas",[163,345,346,349,356,359,362],{},[166,347,348],{},"Sincroniza cada combinación de clave y equipo desde un solo proceso. Varios procesos con la misma clave comparten los mismos límites, así que solo consiguen hacerse esperar unos a otros.",[166,350,351,352,355],{},"Pide páginas completas, de ",[143,353],{"name":354},"PAGE_LIMIT.max"," elementos, durante una carga inicial.",[166,357,358],{},"Consulta el feed de cambios cada 1 a 5 minutos. Una consulta que no encuentra nada nuevo cuesta un elemento del límite de frecuencia y nada de la cuota diaria.",[166,360,361],{},"Lee los miembros y los servicios reservables al empezar con un equipo, cuando encuentres un identificador que no conoces y una vez al día: no en cada ejecución, ni otra vez por un identificador que la última lectura no resolvió.",[166,363,364,365,295],{},"Nunca crees más integraciones ni claves para sortear los límites. Si se te quedan cortos, ",[230,366,368],{"href":367},"\u002Fdevelopers\u002Fes\u002Fsupport","avísanos",{"title":370,"searchDepth":371,"depth":371,"links":372},"",3,[373,378,379,380],{"id":44,"depth":374,"text":45,"children":375},2,[376,377],{"id":138,"depth":371,"text":64},{"id":237,"depth":371,"text":67},{"id":270,"depth":374,"text":271},{"id":327,"depth":374,"text":328},{"id":342,"depth":374,"text":343},"Cuánto puede leer una clave por minuto y por día, qué cuenta para cada límite, cómo reintentar tras un 429 y cuánto tarda una carga inicial.",false,"md","es",{},true,"30","\u002Fdevelopers\u002Fes\u002Frate-limits","---\ntitle: Límites de frecuencia y cuota\ndescription: Cuánto puede leer una clave por minuto y por día, qué cuenta para cada límite, cómo reintentar tras un 429 y cuánto tarda una carga inicial.\nsection: reference\norder: 30\ntranslationKey: rate-limits\nlang: es\ndraft: false\n---\n\nCada clave tiene dos límites, compartidos por todos los equipos que lee: un **límite de frecuencia**, que fija a qué velocidad lee, y una **cuota diaria**, que fija cuánto lee. Los dos cuentan **elementos**, no peticiones. Un elemento es un objeto de una respuesta: una página del feed con 100 cambios son 100 elementos, eliminaciones incluidas.\n\n::dev-callout{type=\"note\" title=\"Aproximados durante la Beta\"}\nEn la Beta, cada servidor que atiende tus peticiones cuenta por separado estos límites y el bloqueo por intentos fallidos, y un reinicio empieza su cuenta de nuevo. Por eso las cifras de esta página son aproximadas: una clave a veces puede leer más, y una petición rechazada con `429` puede funcionar al reintentarla. Diseña tu integración para las cifras de esta página.\n::\n\n## Dos límites por clave\n\nQué peticiones cuentan para cada límite:\n\n| Peticiones | Límite de frecuencia | Cuota diaria |\n|---|---|---|\n| El feed de cambios, todas las listas, las actividades de un lead, `GET \u002Fv1\u002Fteams`, `GET \u002Fv1\u002Fmembers` y `GET \u002Fv1\u002Fbooking_services` | Sí | Sí |\n| Una petición de un solo registro, como `GET \u002Fv1\u002Fleads\u002F{id}`, y también `POST \u002Fv1\u002Fleads\u002Fsearch` y `GET \u002Fv1\u002Fme` | Sí | No |\n| `GET \u002Fv1\u002Fhealth` | No | No |\n\nCada endpoint de la referencia indica su fila: **Sincronización** para la primera y **Lectura** para la segunda.\n\n### Límite de frecuencia\n\nUna clave lee hasta :api-const{name=\"SYNC_VELOCITY.perMinute\"} elementos por minuto, con ráfagas de hasta :api-const{name=\"SYNC_VELOCITY.burst\"}. La capacidad que no usas se recupera a ese ritmo hasta completar de nuevo la ráfaga. Al superar el límite, la API responde `429 rate_limited`, y `Retry-After` indica cuánto falta para que haya sitio para tu petición.\n\nCómo cuenta una petición:\n\n- Antes de ejecutarse, una petición aparta su `limit`. Una petición de lista o del feed que no envía `limit` aparta :api-const{name=\"PAGE_LIMIT.default\"}; una petición de un solo registro aparta uno.\n- Una vez ejecutada, se le cobran los elementos que devolvió, y como mínimo uno. Una página corta devuelve la diferencia, pero una petición que no devuelve nada cuesta igualmente un elemento: una búsqueda que no encuentra ningún lead, un identificador que responde `404` o cualquier otro error que reciba durante su ejecución, `quota_exceeded` incluido.\n- Una petición rechazada antes de ejecutarse no se cobra, como una autenticación fallida, un permiso que falta o, en una ruta que usa `Totem-Team`, un equipo que la clave no puede leer o que aún no está listo. Una petición que indica un registro por su identificador, como `GET \u002Fv1\u002Fleads\u002F{id}` o las actividades de un lead, comprueba su equipo durante la ejecución, así que un rechazo por ese equipo cuesta un elemento.\n- A una petición de un solo registro se le cobra lo que devuelve: `GET \u002Fv1\u002Fleads\u002F{id}` devuelve un lead con sus dos facetas, así que cuenta hasta tres elementos. Una búsqueda cuenta cada lead que devuelve, o uno si no encuentra ninguno.\n\nComo una petición aparta primero su `limit` completo, un `limit` más pequeño te permite seguir leyendo cuando queda poca capacidad.\n\n`429 rate_limited` también puede significar que tu dirección IP o tu clave están bloqueadas tras demasiados intentos de autenticación fallidos. `Retry-After` distingue los dos casos: un bloqueo siempre envía :api-const{name=\"AUTH_FAILURE_LIMITS.banMs\" divide=\"1000\"} segundos, la duración completa del bloqueo, mientras que el límite de frecuencia pide los pocos segundos que necesita tu petición. Ir más despacio no termina un bloqueo: busca el proceso de esa dirección que envía una clave ausente, mal formada, incorrecta o desconocida, corrígelo y espera. [Autenticación](\u002Fdevelopers\u002Fes\u002Fauthentication#intentos-fallidos) explica qué cuenta como intento fallido.\n\n### Cuota diaria\n\nCada día UTC, una clave puede leer :api-const{name=\"SYNC_DAILY_BUDGET.floor\"} elementos, o :api-const{name=\"SYNC_DAILY_BUDGET.recordsMultiplier\"} veces el número de registros de sus equipos si es mayor. Para ese número cuentan los registros de todos los tipos, eliminaciones incluidas. Para la cuota cuenta cada elemento que devuelven las peticiones de la primera fila de la tabla, sea del tipo que sea.\n\nEl número de registros se toma con la primera petición de la clave de cada día UTC, así que un equipo que se añade a la clave más tarde ese día puede aumentar la cuota solo a partir del día siguiente. Planifica la carga inicial de un equipo grande para cuando su cuota lo permita.\n\nLa cuota deja margen para una carga inicial de todos los equipos y un día de consultas periódicas. Lo que la agota es volver a leer listas enteras una y otra vez.\n\nAl agotar la cuota, esas peticiones responden `429 quota_exceeded` hasta las 00:00 UTC, cuando la cuota se renueva. `Retry-After` indica los segundos que faltan. Las peticiones de un solo registro, la búsqueda y `GET \u002Fv1\u002Fme` siguen funcionando.\n\n## Reintenta tras un 429\n\n`Retry-After` llega con cada `429` que devuelve la propia API, y siempre es un número entero de segundos. Espera al menos ese tiempo y vuelve a enviar la misma petición, con el mismo cursor. Mientras esperas no se pierde nada: el feed te guarda todos los cambios.\n\n- Tras `rate_limited`, la espera suele ser de unos segundos, o de :api-const{name=\"AUTH_FAILURE_LIMITS.banMs\" divide=\"1000\"} segundos tras un [bloqueo por intentos fallidos](\u002Fdevelopers\u002Fes\u002Fauthentication#intentos-fallidos).\n- Tras `quota_exceeded`, la espera dura hasta las 00:00 UTC y puede ser de horas. No dejes un proceso dormido tanto tiempo: termina la ejecución y programa la siguiente para esa hora. El [cliente de referencia](\u002Fdevelopers\u002Fes\u002Fsync#cliente-de-referencia-probado) lo hace con su resultado `retry_later`.\n\nUn `429` del cortafuegos que protege la API no trae `Retry-After` ni cuerpo de error JSON: reintenta con espera exponencial. Un `5xx` tampoco lleva `Retry-After`: reinténtalo también con espera exponencial.\n\n## Estimación de la carga inicial\n\nLa tabla da el tiempo mínimo que el límite de frecuencia añade a una carga inicial, según los límites de esta página, para una sola clave sin más tráfico; durante la Beta es aproximado, como explica la nota del principio de esta página. Cuenta los registros de todos los tipos, un elemento cada uno: un lead con su atribución, su respuesta y tres actividades son seis registros. El tiempo de red, y el que Totem necesita para preparar un equipo recién añadido a una clave, se suman a esas cifras. Una copia que cabe en la ráfaga muestra *Menos de 1 minuto*: el límite de frecuencia no le añade nada, pero sigue llevando el tiempo de sus peticiones.\n\n::dev-initial-sync-table\n::\n\n## Buenas prácticas\n\n- Sincroniza cada combinación de clave y equipo desde un solo proceso. Varios procesos con la misma clave comparten los mismos límites, así que solo consiguen hacerse esperar unos a otros.\n- Pide páginas completas, de :api-const{name=\"PAGE_LIMIT.max\"} elementos, durante una carga inicial.\n- Consulta el feed de cambios cada 1 a 5 minutos. Una consulta que no encuentra nada nuevo cuesta un elemento del límite de frecuencia y nada de la cuota diaria.\n- Lee los miembros y los servicios reservables al empezar con un equipo, cuando encuentres un identificador que no conoces y una vez al día: no en cada ejecución, ni otra vez por un identificador que la última lectura no resolvió.\n- Nunca crees más integraciones ni claves para sortear los límites. Si se te quedan cortos, [avísanos](\u002Fdevelopers\u002Fes\u002Fsupport).\n","reference",{"title":6,"description":381},"developers\u002Fes\u002Frate-limits","rate-limits","GefNvlV0Obo1WSLMaKGLHlQ5y_a-DV2JsnMkWdPJvi0",[396,410,437,482],{"section":397,"items":398},"start",[399,403,407],{"path":400,"title":401,"description":402},"\u002Fdevelopers\u002Fes","Introducción","Lee desde tus propios sistemas los leads, las llamadas, las conversaciones y las citas de tus equipos de Totem, y mantén una copia sincronizada.",{"path":404,"title":405,"description":406},"\u002Fdevelopers\u002Fes\u002Fquickstart","Inicio rápido","Haz tus primeras peticiones a la API de Totem en unos minutos. Comprueba tu clave, busca tu equipo, lista leads e inicia una sincronización.",{"path":408,"title":233,"description":409},"\u002Fdevelopers\u002Fes\u002Fauthentication","Las claves secretas y dónde pueden guardarse, la cabecera Totem-Team de las claves con varios equipos, la lista de IP permitidas y cómo rotar o revocar una clave.",{"section":411,"items":412},"guides",[413,417,421,425,429,433],{"path":414,"title":415,"description":416},"\u002Fdevelopers\u002Fes\u002Ftypescript","SDK de TypeScript","Usa el cliente oficial de TypeScript para leer tus datos de Totem, paginar listas y gestionar errores de la API desde tu servidor.",{"path":418,"title":419,"description":420},"\u002Fdevelopers\u002Fes\u002Fsync","Sincroniza una copia","Copia un equipo con el feed de cambios y mantén la copia al día. Aplica las páginas sin riesgos, recupérate de los errores y parte de un cliente de referencia que Totem prueba.",{"path":422,"title":423,"description":424},"\u002Fdevelopers\u002Fes\u002Fpagination","Listas y paginación","Cómo devuelven los endpoints de lista los registros página a página, cómo leer todas las páginas y qué orden y qué filtros admite una lista.",{"path":426,"title":427,"description":428},"\u002Fdevelopers\u002Fes\u002Fcoverage","Cobertura de los datos","Qué registra Totem, desde cuándo y cómo distinguir un valor vacío de un dato que nunca se registró.",{"path":430,"title":431,"description":432},"\u002Fdevelopers\u002Fes\u002Ftesting","Pruebas y puesta en producción","Cómo construir y probar una integración con seguridad mientras la API no tiene entorno de pruebas, y qué comprobar antes de pasar a producción.",{"path":434,"title":435,"description":436},"\u002Fdevelopers\u002Fes\u002Fsecurity","Seguridad y datos personales","Cómo protege Totem las claves de la API y los datos que sirve, qué registra de cada clave, dónde funciona la API y qué hacer con los datos personales que copias.",{"section":390,"items":438},[439,443,447,448,453,458,463,468,473,478],{"path":440,"title":441,"description":442},"\u002Fdevelopers\u002Fes\u002Fconventions","Convenciones","La notación de esta documentación y las reglas que siguen todas las respuestas: identificadores, fechas, valores vacíos, importes, enumeraciones, versiones, estabilidad, errores y textos no fiables.",{"path":444,"title":445,"description":446},"\u002Fdevelopers\u002Fes\u002Ferrors","Errores","El formato de los errores, cómo debe tratar tu integración cada tipo de error y todos los códigos de error, con cuándo ocurren y qué hacer.",{"path":388,"title":6,"description":381},{"path":449,"title":450,"description":451,"apiTag":452},"\u002Fdevelopers\u002Fes\u002Freference-account","Cuenta, equipos y miembros","Comprueba que una clave funciona y qué puede leer, lista sus equipos con su zona horaria, lista los miembros de cada equipo y comprueba que la API está funcionando.","account",{"path":454,"title":455,"description":456,"apiTag":457},"\u002Fdevelopers\u002Fes\u002Freference-leads","Leads, tableros y actividades","Lista, obtén y busca los leads y los clientes de un equipo, lee las actividades de cada lead y lista los tableros y las etapas por los que pasan.","leads",{"path":459,"title":460,"description":461,"apiTag":462},"\u002Fdevelopers\u002Fes\u002Freference-calls","Llamadas","Lista y obtén las llamadas de un equipo, con su dirección, su horario y un resultado normalizado. Sin grabaciones ni transcripciones.","calls",{"path":464,"title":465,"description":466,"apiTag":467},"\u002Fdevelopers\u002Fes\u002Freference-conversations","Conversaciones","Lista y obtén las conversaciones de un equipo en todos los canales, con su estado, la persona asignada, si una persona ha tomado el control y cuándo llegaron y salieron los últimos mensajes. Nunca el contenido de los mensajes.","conversations",{"path":469,"title":470,"description":471,"apiTag":472},"\u002Fdevelopers\u002Fes\u002Freference-bookings","Citas y servicios","Lista y obtén las citas de un equipo, y lista los servicios que pueden reservar sus clientes.","bookings",{"path":474,"title":475,"description":476,"apiTag":477},"\u002Fdevelopers\u002Fes\u002Freference-sync","Feed de cambios","Un único endpoint que copia un equipo y, después, devuelve cada cambio, página a página.","sync",{"path":479,"title":480,"description":481},"\u002Fdevelopers\u002Fes\u002Fobjects","Todos los objetos","Todos los objetos que devuelve la API, campo a campo, con un ejemplo de cada uno.",{"section":483,"items":484},"resources",[485,489,492,496],{"path":486,"title":487,"description":488},"\u002Fdevelopers\u002Fes\u002Fchangelog","Registro de cambios","Los cambios de la API de Totem, del más reciente al más antiguo, cada uno bajo la fecha en que se publicó.",{"path":367,"title":490,"description":491},"Soporte","Cómo pedir ayuda con la API de Totem, qué incluir en una solicitud y qué hacer si se filtra una clave.",{"path":493,"title":494,"description":495},"\u002Fdevelopers\u002Fes\u002Fglossary","Glosario","Los términos de esta documentación, definidos en un solo lugar, cada uno con un enlace a la página que lo explica.",{"path":497,"title":498,"description":499},"\u002Fdevelopers\u002Fes\u002Ffaq","Preguntas frecuentes","Respuestas breves a las preguntas más habituales sobre la API de Totem, con enlaces a los detalles.","\u002Fdevelopers\u002Frate-limits",{"ACTIVATION_MARGIN_MS":502,"ADMIN_ACCESS_DISCLOSURE_VERSION":503,"AUDIT_RETENTION_DAYS":504,"AUTH_FAILURE_LIMITS":505,"CAPTURE_LAG_FLOOR_MS":509,"CAPTURE_LAG_P99_MS":7,"CURSOR_MAX_AGE_DAYS":510,"DIRTY_TTL_DAYS":510,"FAMILY_TEAM_SCOPE":511,"FAMILY_TEAM_SCOPE_OPTIONS":512,"FEED_SETTLE_LAG_MS":514,"GATE_REFRESH_MS":502,"INTEGRATION_NAME_LENGTH":515,"INTEGRATION_PURPOSE_LENGTH":517,"KEY_CACHE_TTL_MS":520,"KEY_STATS_RETENTION_DAYS":521,"LEAD_RESPONSE_READ_BUDGET":522,"LIST_SCAN_MAX":525,"MAX_FAMILY_INTEGRATION_TEAMS":510,"MAX_INTEGRATIONS_PER_FAMILY":526,"MAX_IP_ALLOWLIST":507,"PAGE_LIMIT":527,"PLATFORM_CONFIG_TTL_MS":530,"REMOVAL_RETENTION_DAYS":531,"REQUEST_BODY_MAX_BYTES":532,"ROLL_GRACE_DEFAULT_HOURS":533,"ROLL_GRACE_HOURS":534,"SEARCH_MAX_RESULTS":526,"SENSITIVE_SECTOR_POLICY":537,"SENSITIVE_SECTOR_POLICY_OPTIONS":538,"SYNC_DAILY_BUDGET":540,"SYNC_VELOCITY":542,"TEAM_CACHE_TTL_MS":544},60000,"2026-10-17",365,{"perIpPerMinute":506,"perLookupIdPerMinute":507,"banMs":508},60,20,600000,300000,30,"explicit_list",[511,513],"all_family_teams",10000,{"min":374,"max":516},80,{"min":518,"max":519},1,280,5000,90,{"conversations":507,"messageReads":523,"calls":524},200,50,1000,10,{"default":528,"max":529},25,100,15000,45,16384,24,[535,518,533,536],0,168,"exclude",[537,539],"allow",{"floor":541,"recordsMultiplier":371},250000,{"perMinute":543,"burst":514},2000,30000,"1.0a",{"operations":547,"schemas":548,"errors":549,"commonErrors":698,"defaultStability":699,"policy":501,"problemExample":700},[],[],[550,559,565,571,579,585,593,601,607,613,620,626,633,641,649,657,664,672,677,685,692],{"code":551,"status":552,"title":553,"wireTitle":554,"action":555,"description":556,"fix":557,"retryable":382,"retry":558},"invalid_request",400,"Petición no válida","Invalid request","fix_request","Algo de la petición no es válido: un parámetro de consulta desconocido, repetido o fuera de rango, una cadena de consulta o un cuerpo en un endpoint que no los admite, un cursor emitido para otro endpoint, otros filtros u otro equipo, una cabecera `Totem-Team` mal formada o un cuerpo que no es el JSON que espera el endpoint. `param` indica el parámetro, la cabecera o el campo que ha fallado. Un cursor de conversaciones también se rechaza cuando se suprime la conversación a la que apunta.","Corrige lo que indica `param` antes de reintentar: la misma petición falla igual. Si es un cursor, envía el `next_cursor` que recibiste del mismo endpoint, con los mismos filtros y el mismo equipo. Si se rechaza un cursor de conversaciones que no cambiaste, vuelve a empezar esa lista desde la primera página.","no",{"code":560,"status":552,"title":561,"wireTitle":562,"action":555,"description":563,"fix":564,"retryable":382,"retry":558},"team_required","Falta el equipo","Team required","La clave lee más de un equipo y este endpoint lee los datos de uno, pero la petición no indica cuál.","Envía el identificador del equipo (`team_…`, tal como aparece en `GET \u002Fv1\u002Fteams`) en la cabecera `Totem-Team`.",{"code":566,"status":552,"title":567,"wireTitle":568,"action":555,"description":569,"fix":570,"retryable":382,"retry":558},"secret_key_in_browser","Clave secreta enviada desde un navegador","Secret key sent from a browser","La petición llevaba una clave secreta junto con una cabecera `Origin`, lo que indica que salió de un navegador. Totem la rechaza sin leer nada.","Llama a la API solo desde tu servidor. Si la clave ha estado en una página web, una aplicación móvil o una extensión del navegador, dala por filtrada: rótala y márcala como comprometida para que la antigua deje de funcionar al instante.",{"code":572,"status":573,"title":574,"wireTitle":575,"action":576,"description":577,"fix":578,"retryable":382,"retry":558},"invalid_credentials",401,"Credenciales no válidas","Invalid credentials","check_credentials","Falta la cabecera `Authorization` o está mal formada, o la clave no existe, es incorrecta o está revocada, o su integración ya no está activa.","Envía `Authorization: Bearer \u003Cclave>` con una clave secreta vigente. No reintentes en bucle: muchos fallos desde la misma dirección IP, o con la misma clave, la bloquean durante un tiempo con `429 rate_limited`.",{"code":580,"status":573,"title":581,"wireTitle":582,"action":576,"description":583,"fix":584,"retryable":382,"retry":558},"key_expired","Clave caducada","Key expired","La clave se rotó y su periodo de gracia ha terminado.","Despliega la clave que la sustituyó: la antigua ya superó su periodo de gracia y no volverá a funcionar. Si no hay ninguna que la sustituya, crea una clave nueva en Ajustes → Desarrolladores.",{"code":586,"status":587,"title":588,"wireTitle":589,"action":590,"description":591,"fix":592,"retryable":382,"retry":558},"insufficient_scope",403,"Permisos insuficientes","Insufficient scope","contact_support","A la clave le falta un permiso que necesita este endpoint. Todas las claves de la versión 1.0a tienen el conjunto completo de lectura, así que no debería ocurrir.","Escribe a soporte e indica el `Totem-Request-Id` de la respuesta.",{"code":594,"status":587,"title":595,"wireTitle":596,"action":597,"description":598,"fix":599,"retryable":386,"retry":600},"plan_not_entitled","El plan no incluye la API","Plan not entitled","keep_and_retry","El plan de la organización no incluye ahora mismo la API de Totem.","Conserva tus datos y tus cursores y deja de llamar hasta que el cliente vuelva a tener un plan con acceso a la API; después, continúa donde lo dejaste. Mientras el acceso está denegado, el feed no entrega nada de los equipos de la clave, tampoco eliminaciones: si la denegación dura más de lo que permite tu política de conservación, borra tu copia.","restored",{"code":602,"status":587,"title":603,"wireTitle":604,"action":576,"description":605,"fix":606,"retryable":382,"retry":558},"ip_not_allowed","Dirección IP no permitida","IP address not allowed","La clave es válida, pero la petición salió de una dirección IP que no está en la lista de IP permitidas de la integración.","Llama desde una dirección permitida o pide a un administrador que añada la tuya a la lista en Ajustes → Desarrolladores.",{"code":608,"status":587,"title":609,"wireTitle":610,"action":597,"description":611,"fix":612,"retryable":386,"retry":600},"team_state_restricted","Equipo restringido","Team restricted","El equipo está restringido por ahora: está desactivado (por ejemplo, suspendido por impago), archivado o es solo de facturación, o tiene pausado el acceso a la API. `GET \u002Fv1\u002Fteams` lo sigue mostrando.","Conserva los datos y el cursor del equipo, omítelo en esta ejecución y vuelve a intentarlo más tarde. Los demás equipos de la clave no se ven afectados. Mientras el equipo está restringido, el feed no entrega nada de él, tampoco eliminaciones: si la restricción dura más de lo que permite tu política de conservación, borra la copia del equipo.",{"code":614,"status":587,"title":615,"wireTitle":616,"action":597,"description":617,"fix":618,"retryable":382,"retry":619},"sector_restricted","Sector restringido","Sector restricted","Totem no exporta los datos de este equipo por la API porque el equipo trabaja en un sector sensible, como el sanitario, en el que sus registros pueden revelar información de salud.","Omite el equipo: esperar no lo cambia. El feed no entrega nada de él, tampoco eliminaciones, así que conserva lo que ya tengas solo mientras lo permita tu política de conservación y después borra la copia del equipo. Si necesitas sus datos, habla con el cliente o con Totem.","blocked",{"code":621,"status":587,"title":622,"wireTitle":623,"action":597,"description":624,"fix":625,"retryable":386,"retry":600},"capability_disabled","Función desactivada","Capability disabled","Totem ha desactivado temporalmente este endpoint para todas las claves.","Conserva tus datos y tus cursores y vuelve a intentarlo más tarde; el resto de endpoints sigue funcionando.",{"code":627,"status":628,"title":629,"wireTitle":630,"action":555,"description":631,"fix":632,"retryable":382,"retry":558},"resource_missing",404,"Recurso no encontrado","Resource not found","El registro no existe, se eliminó, pertenece a un equipo que esta clave no lee o se creó hace tan poco que Totem aún no lo ha preparado. Un `GET` o un `POST` bajo `\u002Fv1\u002F` que no corresponde a ningún endpoint también recibe este código. Cualquier otro método, y cualquier ruta fuera de `\u002Fv1\u002F`, recibe un `404` simple del cortafuegos que protege la API, sin cuerpo de error ni `Totem-Request-Id`.","Comprueba el identificador y la ruta. Si el registro se acaba de crear, no reintentes en bucle: el feed de cambios lo entregará en cuanto esté listo.",{"code":634,"status":628,"title":635,"wireTitle":636,"action":637,"description":638,"fix":639,"retryable":382,"retry":640},"team_not_accessible","Equipo no accesible","Team not accessible","drop_team","La cabecera `Totem-Team` indica un equipo que esta clave no lee: uno que nunca incluyó, uno que se quitó de la clave o de la organización, o uno que se eliminó. Sin la cabecera, significa que la clave ya no lee ningún equipo.","Vuelve a leer `GET \u002Fv1\u002Fteams` antes de actuar. Si el equipo ya no aparece, borra su copia y su cursor; si sigue apareciendo, conserva todo y vuelve a intentarlo en la siguiente ejecución.","confirm",{"code":642,"status":643,"title":644,"wireTitle":645,"action":646,"description":647,"fix":648,"retryable":382,"retry":558},"resync_required",409,"Hay que volver a sincronizar","Resync required","resync","Totem no puede continuar el feed desde este cursor: los datos se restauraron desde una copia de seguridad o se detectó un hueco en los cambios del equipo.","Haz una resincronización completa: olvida las versiones que guardaste del equipo, vuelve a leer el feed sin cursor y, cuando estés al día, borra los registros locales del equipo que no hayan llegado. Hasta entonces, sigue usando tu copia actual.",{"code":650,"status":643,"title":651,"wireTitle":652,"action":653,"description":654,"fix":655,"retryable":386,"retry":656},"capture_not_ready","Los datos del equipo aún se están preparando","Team data is still being prepared","wait_capture","Totem aún está preparando los datos de este equipo para la API. Ocurre una sola vez por equipo, después de que se añada por primera vez a una clave; añadirlo después a otra clave no lo repite.","Conserva lo que tengas del equipo y vuelve a intentarlo dentro de unos minutos; mientras tanto, los demás equipos de la clave siguen sincronizándose.","later",{"code":658,"status":659,"title":660,"wireTitle":661,"action":646,"description":662,"fix":663,"retryable":382,"retry":558},"sync_cursor_expired",410,"Cursor de sincronización caducado","Sync cursor expired","El cursor tiene más de 30 días, contados desde el punto del feed al que llegó (o, mientras una carga inicial sigue en curso, desde que empezó).","Haz una resincronización completa, como con `resync_required`. Para evitarlo, guarda el `next_cursor` de cada página, también de las vacías: el cursor de un equipo que consultas con regularidad nunca caduca.",{"code":287,"status":665,"title":666,"wireTitle":667,"action":668,"description":669,"fix":670,"retryable":386,"retry":671},429,"Límite de frecuencia superado","Rate limited","retry_after","La clave ha superado su límite de frecuencia (elementos por minuto), o demasiados intentos de autenticación fallidos desde esta dirección IP o con esta clave la han bloqueado durante un tiempo.","Espera los segundos que indica `Retry-After` y repite la misma petición. Cada petición aparta su `limit` completo al empezar y devuelve lo que no usa, así que con un `limit` más pequeño avanzas aunque quede poco margen.","after",{"code":189,"status":665,"title":673,"wireTitle":674,"action":668,"description":675,"fix":676,"retryable":386,"retry":671},"Cuota diaria superada","Daily quota exceeded","La clave ha consumido su cuota diaria de elementos. Para la cuota cuenta cada elemento que devuelven el feed de cambios y todas las listas, incluidas `GET \u002Fv1\u002Fteams`, `GET \u002Fv1\u002Fmembers`, `GET \u002Fv1\u002Fbooking_services` y las actividades de un lead. La cuota se renueva a las 00:00 UTC.","Deja de sincronizar hasta las 00:00 UTC (`Retry-After` indica los segundos que faltan) y continúa entonces con el mismo cursor: no se pierde nada. Las peticiones de un solo registro, como `GET \u002Fv1\u002Fleads\u002F{id}`, la búsqueda y `GET \u002Fv1\u002Fme` no cuentan para la cuota y siguen funcionando.",{"code":678,"status":679,"title":680,"wireTitle":681,"action":682,"description":683,"fix":684,"retryable":386,"retry":682},"internal_error",500,"Error interno","Internal error","backoff","Algo ha fallado dentro de Totem al responder a esta petición.","Reintenta con una espera exponencial. Si sigue fallando, escribe a soporte e indica el `Totem-Request-Id`.",{"code":686,"status":687,"title":688,"wireTitle":689,"action":682,"description":690,"fix":691,"retryable":386,"retry":682},"api_disabled",503,"API desactivada","API disabled","Totem ha desactivado temporalmente la API para todas las claves.","Conserva tus datos y tus cursores y reintenta más tarde con una espera exponencial.",{"code":693,"status":687,"title":694,"wireTitle":695,"action":682,"description":696,"fix":697,"retryable":386,"retry":682},"service_unavailable","Servicio no disponible","Service unavailable","Reservado: la API no devuelve hoy este código. Un `503` del balanceador de carga o de la plataforma que aloja la API llega sin cuerpo de error; trátalo como este código.","Reintenta con una espera exponencial; tus datos y tus cursores siguen siendo válidos.",[551,566,572,580,586,594,602,621,287,678,686,693],"beta",{"type":701,"title":630,"status":628,"code":627,"request_id":702,"doc_url":701},"https:\u002F\u002Ftotemstudio.ai\u002Fdevelopers\u002Ferrors#resource_missing","req_0f6b2c1e-8d4a-4b7e-9c3f-5a2d1e7b9c40","guide",[705,706,707,708,709,710],{"id":44,"text":45,"depth":374},{"id":138,"text":64,"depth":371},{"id":237,"text":67,"depth":371},{"id":270,"text":271,"depth":374},{"id":327,"text":328,"depth":374},{"id":342,"text":343,"depth":374},{"path":444,"title":445,"section":390},{"path":449,"title":450,"section":390},[],1792502790811]