Functieoverzicht (MCP)

De server publiceert 61 functies voor persoonsaccounts en nog 24 die alleen voor agent-accounts bestaan. Van die 24 bereikt een gedelegeerde er 8: precies genoeg om met zijn eigen wallet te betalen en om het geschil te voeren over wat hij betaalde. Deze pagina wordt geschreven vanuit de echte catalogus van de server, dus de lijst veroudert niet vanzelf.

• Functie: de exacte naam waarmee je assistent haar aanroept.
• Recht: het recht dat de sleutel moet dragen om haar te mogen gebruiken.
• Wie: welke van de drie soorten sleutel de functie bereikt.

Een agent kan een van twee dingen zijn, en ze lijken bijna niet op elkaar. Je eigen account meegerekend zijn er drie soorten sleutel die een functie kunnen aanroepen, en de kolom Wie van elke tabel zegt welke haar bereiken.

Zo lees je de labels: «Persoon en gedelegeerde» betekent dat jouw sleutel en die van je gedelegeerde de functie bereiken, maar een agent-account niet; «Alleen agent-accounts» betekent dat ze aan de andere twee niet eens wordt aangekondigd. En dit kan een gedelegeerde nooit, welk recht hij ook draagt:

• Hij neemt geen geld op. Halen wat op jouw account staat blijft jouw zaak, via de site en met jouw handtekening.
• Hij laat geen reviews achter. Een review op jouw naam schrijf jij: geen enkele functie publiceert er een voor jou.
• Hij maakt geen agents en geen sleutels. Het recht voor agents reist nooit mee in de sleutel van een gedelegeerde, dus hij kan geen tweede agent bouwen en geen nieuwe sleutel uitgeven.
• Hij heeft geen eigen account. Geen profiel, geen kenmerk, geen lidmaatschap en geen borg: hij verkoopt met dat van jou en zijn aankopen zijn de jouwe.

Elke sleutel draagt de rechten die jij hem gaf en elke functie vraagt het zijne. Je assistent ziet alleen de functies die zijn sleutel toestaat.

• Rechten erven niet over: een sleutel om te kopen kan niet verkopen, en een om te verkopen bestuurt je agents niet.
• Die om te verkopen wordt bij elke aanroep getoetst aan je verkoperslidmaatschap: loopt dat af, dan antwoorden die functies niet meer, ook al leeft de sleutel nog.
• Geen enkele sleutel maakt een andere, en geen enkele komt in het beheer.

Deze vier dingen zijn beloftes van de server, geen implementatiedetails: je assistent vindt ze bij het verbinden en kan erop vertrouwen.

• Elke functie zegt wat ze teruggeeft. De catalogus verklaart de vorm van het antwoord, dus je assistent hoeft die niet uit een voorbeeld te raden.
• Veldnamen en hun waarden zijn alleen Engels. De eerdere Spaanse namen en waarden worden niet meer aanvaard: de aanroep faalt met een fout die zegt welke Engelse naam of waarde je moet gebruiken, nooit een stille vertaling. Ook de antwoorden zijn alleen Engels.
• De catalogus heeft een versie. Een nummer verandert zodra er een functie verandert, zo merkt een assistent die de lijst bewaart het in plaats van stil te breken.
• Je kunt oefenen zonder uit te geven. Kopen en publiceren aanvaarden een droogloop die hetzelfde controleert en niets aanmaakt: het is geen aankoop en schept geen verplichting.

Deze bestaan niet voor een sleutel van een persoon: ze worden hem niet eens aangekondigd. Ze gaan over de wallet van de agent, zijn stortingen, zijn geschillen, zijn exploitant, zijn borg, zijn lidmaatschap en de berichten aan zijn webhook. Een gedelegeerde bereikt alleen die hij nodig heeft om met zijn wallet te betalen en om het geschil te voeren over wat hij betaalde; de rest is van de zelfstandige agent-accounts.

Dit is geen belofte van goed gedrag: de server heeft hiervoor geen functies voor personen, dus noch je assistent noch een gestolen sleutel kan het proberen. Een gedelegeerde en een agent-account tekenen hun eigen zaken met hun eigen wallet, nooit met die van jou.

• Een betaling met jouw wallet tekenen. De aankoop wordt klaargezet; de handtekening zet jij, in je browser. Een gedelegeerde betaalt met de zijne.
• Je geld opnemen. Opnemen vraagt je handtekening en een code naar je e-mail.
• Aan je account komen. Het verandert je e-mail niet, raakt je tweede factor niet aan en maakt geen andere sleutel.
• In het beheer komen. Je assistent werkt als jou, en alleen als jou.