Een white-labelendpoint is een endpoint dat een wederverkoper toevoegt aan de API die hij onder eigen naam verkoopt. Het is geen nieuwe mogelijkheid — het is een paar van de operaties die die API al heeft, op volgorde, achter één adres en één naam die de wederverkoper koos. Zijn klanten roepen het aan zoals ze al het andere aanroepen, en hun assistenten zien het in de lijst met tools naast de operaties waaruit het is opgebouwd.
Waarom een wederverkoper er een wil
Omdat het product dat hij verkoopt meestal geen operatie is. “We warmen een lijst voor je op” is een zoekopdracht, dan een reactie op elk resultaat, dan een uitnodiging aan de mensen die ze schreven — vier aanroepen die de assistenten van zijn klanten steeds goed en in de juiste volgorde moeten doen. Eén endpoint is hetzelfde werk, één keer benoemd en beschreven in de eigen woorden van de wederverkoper.
Waaruit het wel en niet kan bestaan
Alleen uit operaties die het eigen plan van de wederverkoper bevat. Een eigen endpoint is een kortere weg door de API die hij heeft gekocht, nooit een manier eromheen: een stap die iets buiten zijn plan noemt, wordt geweigerd wanneer het endpoint wordt geschreven, niet wanneer het draait.
Voorwaarden en lussen zijn toegestaan; een expressietaal niet. Een waarde is gewone JSON of een pad dat wordt uitgelezen uit wat de uitvoering tot nu toe heeft opgeleverd, en een voorwaarde is een vergelijking. Er wordt niets geëvalueerd, omdat het endpoint door een klant wordt geschreven, opgeslagen en daarna op de server van de aanbieder wordt uitgevoerd tegen een echt account.
Wat één aanroep mag verbruiken
Een lus betekent dat een endpoint om meer werk kan vragen dan iemand ooit bedoelde te vragen, dus één uitvoering heeft plafonds: een aantal operaties, een aantal iteraties en een tijdslimiet. Eentje bereiken is een antwoord en geen fout — het zegt wat er al gedaan was, want een bericht dat is verstuurd, kun je niet terughalen.
Elke stap wordt als een nieuw verzoek geautoriseerd, dus een id die de eerste stap heeft opgeleverd, moet zich opnieuw bewijzen voordat de tweede hem mag gebruiken. Een samengesteld endpoint is geen manier om de controles over te slaan die de operaties erbinnen meebrengen, en het verbruikt hetzelfde tempobudget als zij.
De andere helft: het onze wegnemen
Een wederverkoper kan ook operaties verbergen die hij niet wil aanbieden. Verbergen haalt een operatie uit de lijst met tools, het manifest en de referentie; de route antwoordt nog steeds, dus een klant die de route al aanroept, gaat niet kapot door een wijziging die in één zin is gemaakt. Een wederverkoper die een heel gebied weg wil, stopt in plaats daarvan met het aanbieden van dat gebied.
Veelgestelde vragen
Kan een AI-agent er een voor me schrijven?
Zo gaat het meestal. Beschrijf wat het endpoint moet doen en welke van je operaties het moet gebruiken, en de assistent schrijft de stappen en slaat het op. Grijpt het naar een operatie die je plan niet bevat, dan wordt het geweigerd met de naam van die operatie erbij, zodat een verkeerde gok wordt rechtgezet in plaats van opgeslagen.
Kost een eigen endpoint meer om uit te voeren?
Het kost wat de operaties erin kosten. Eén aanroep die vier acties uitvoert, verbruikt hetzelfde tempobudget als vier aanroepen die ze uitvoeren, omdat elke stap als eigen verzoek wordt geautoriseerd en op tempo wordt gezet.