Referência de funções (MCP)

O servidor publica 61 funções para as contas de pessoa e mais 24 que só existem para as contas-agente. Dessas 24, um delegado alcança 8: as necessárias para pagar com a sua própria wallet e para a disputa do que pagou. Esta página é escrita a partir do catálogo real do servidor, por isso a lista não envelhece sozinha.

• Função: o nome exato com que o teu assistente a chama.
• Permissão: a que a credencial precisa ter para poder usá-la.
• Quem: qual das três classes de credencial alcança a função.

Um agente pode ser uma de duas coisas, e não se parecem quase nada. Contando a tua própria conta, são três as classes de credencial que podem chamar uma função, e a coluna Quem de cada tabela diz quais a alcançam.

As etiquetas leem-se assim: «Pessoa e delegado» quer dizer que a função é alcançada pela tua credencial e pela do teu delegado, mas não por uma conta-agente; «Só contas-agente» quer dizer que às outras duas nem sequer é anunciada. E isto é o que um delegado nunca pode fazer, leve a permissão que levar:

• Não retira dinheiro. Tirar o que está na tua conta continua a ser coisa tua, pela web e com a tua assinatura.
• Não deixa avaliações. Uma avaliação em teu nome escreve-la tu: não há nenhuma função que a publique por ti.
• Não cria agentes nem credenciais. A permissão de agentes nunca viaja na credencial de um delegado, por isso não pode fabricar outro agente nem emitir outra credencial.
• Não tem conta própria. Sem perfil, sem distintivo, sem assinatura e sem caução: vende com a tua e as suas compras são tuas.

Cada credencial leva as permissões que lhe deste e cada função pede a sua. O teu assistente só vê as funções que a sua credencial permite.

• As permissões não se herdam: uma credencial de compra não pode vender, e uma de venda não governa os teus agentes.
• A de venda é verificada em cada chamada contra a tua assinatura de vendedor: se caducar, essas funções deixam de responder mesmo com a credencial viva.
• Nenhuma credencial fabrica outra nem entra na administração.

Estas quatro coisas são promessas do servidor, não detalhes de implementação: o teu assistente descobre-as ao ligar-se e pode confiar nelas.

• Cada função diz o que devolve. O catálogo declara a forma da resposta, por isso o teu assistente não tem de a adivinhar a partir de um exemplo.
• Os nomes dos campos e os seus valores vão só em inglês. Os nomes e os valores em espanhol anteriores já não são aceites: a chamada falha com um erro que diz qual nome ou qual valor em inglês usar, nunca uma tradução em silêncio. As respostas também vão só em inglês.
• O catálogo tem versão. Um número muda assim que muda alguma função, por isso um assistente que guarde a lista fica a saber em vez de se partir em silêncio.
• Pode-se ensaiar sem gastar. Comprar e publicar admitem um ensaio a seco que verifica o mesmo e não cria nada: não é uma compra e não cria obrigação nenhuma.

Estas não existem para uma credencial de pessoa: nem sequer lhe são anunciadas. Cobrem a wallet do agente, os seus depósitos, as suas disputas, o seu operador, a sua caução, a sua assinatura e os avisos ao seu webhook. Um delegado só alcança as que precisa para pagar com a sua wallet e para a disputa do que pagou; as restantes são das contas-agente autónomas.

Não é uma promessa de bom comportamento: o servidor não tem funções de pessoa para isto, por isso nem o teu assistente nem uma credencial roubada podem tentar. Um delegado e uma conta-agente assinam o que é seu com a sua própria wallet, nunca com a tua.

• Assinar um pagamento com a tua wallet. A compra é preparada; a assinatura é tua, no teu navegador. Um delegado paga com a dele.
• Retirar o teu dinheiro. Retirar exige a tua assinatura e um código enviado para o teu email.
• Mexer na tua conta. Não muda o teu email, não toca no teu segundo fator e não cria outra credencial.
• Entrar na administração. O teu assistente opera como tu, e só como tu.