Un endpoint de marca blanca es el que un revendedor añade a la API que vende con su propio nombre. No es una capacidad nueva — son unas pocas de las operaciones que esa API ya tiene, en orden, detrás de una sola dirección y un solo nombre que eligió el revendedor. Sus clientes lo llaman igual que llaman a cualquier otra cosa, y sus asistentes lo ven en la lista de herramientas junto a las operaciones con las que está construido.
Por qué un revendedor quiere uno
Porque el producto que vende normalmente no es una operación. «Calentamos una lista por ti» es una búsqueda, luego una reacción a cada resultado, luego una invitación a las personas que los escribieron — cuatro llamadas que los asistentes de sus clientes tienen que acertar, y en orden, cada vez. Un endpoint es el mismo trabajo, nombrado una sola vez y descrito con las palabras del propio revendedor.
De qué puede y de qué no puede estar hecho
Solo de operaciones que el plan del propio revendedor incluye. Un endpoint propio es un atajo dentro de la API que compró, nunca una manera de saltársela: un paso que nombra algo fuera de su plan se rechaza cuando se escribe el endpoint, no cuando se ejecuta.
Se permiten condiciones y bucles; un lenguaje de expresiones no. Un valor es JSON corriente o una ruta leída de lo que la ejecución lleva hecho hasta ese momento, y una condición es una comparación. No se evalúa nada, porque el endpoint lo escribe un cliente, se guarda y luego se ejecuta en el servidor del proveedor contra una cuenta real.
Qué puede gastar una llamada
Un bucle significa que un endpoint puede pedir más trabajo del que nadie quiso pedir, así que cada ejecución tiene topes: un número de operaciones, un número de iteraciones y un tiempo límite. Llegar a uno es una respuesta, no un error — dice qué se había hecho ya, porque un mensaje que ya se envió no se puede retirar.
Cada paso se autoriza como una petición nueva, así que un id que produjo el primer paso tiene que acreditarse de nuevo antes de que el segundo pueda usarlo. Un endpoint compuesto no es una manera de saltarse las comprobaciones que llevan las operaciones de su interior, y gasta el mismo presupuesto de ritmo que ellas.
La otra mitad: quitar lo nuestro
Un revendedor también puede ocultar operaciones que no quiere ofrecer. Ocultar una operación la saca de la lista de herramientas, del manifiesto y de la referencia; la ruta sigue respondiendo, así que un cliente que ya la llama no se rompe por un cambio hecho con una sola frase. Un revendedor que quiere que desaparezca un área entera deja de ofrecer esa área.
Preguntas frecuentes
¿Puede un agente de IA escribir uno de estos por mí?
Es lo habitual. Describe qué debe hacer el endpoint y cuáles de tus operaciones debe usar, y el asistente escribe los pasos y lo guarda. Se rechaza, señalando la operación por su nombre, si echa mano de una que tu plan no incluye, así que una suposición equivocada se corrige en lugar de guardarse.
¿Un endpoint propio cuesta más de ejecutar?
Cuesta lo que cuestan las operaciones que lleva dentro. Una llamada que hace cuatro acciones gasta el mismo presupuesto de ritmo que cuatro llamadas que las hacen, porque cada paso se autoriza y se espacia como una petición propia.