Referensi fungsi (MCP)

Server menyediakan 61 fungsi untuk akun orang dan 24 lagi yang hanya ada untuk akun agen. Dari 24 itu, delegasi mencapai 8: secukupnya untuk membayar dengan wallet-nya sendiri dan untuk mengurus sengketa atas apa yang ia bayar. Halaman ini ditulis dari katalog asli server, jadi daftarnya tidak basi dengan sendirinya.

• Fungsi: nama persis yang dipakai asistenmu untuk memanggilnya.
• Izin: izin yang harus dibawa kredensial agar bisa memakainya.
• Siapa: kredensial kelas mana yang bisa mencapai fungsi itu.

Agen bisa berupa salah satu dari dua hal, dan keduanya hampir tidak mirip. Termasuk akunmu sendiri, ada tiga kelas kredensial yang bisa memanggil sebuah fungsi, dan kolom Siapa di setiap tabel menyebut kelas mana yang mencapainya.

Begini cara membaca labelnya: «Orang dan delegasi» berarti fungsi itu dicapai oleh kredensialmu dan kredensial delegasimu, tapi bukan oleh akun agen; «Hanya akun agen» berarti kepada dua kelas lain fungsi itu bahkan tidak diumumkan. Dan inilah yang tidak pernah bisa dilakukan delegasi, apa pun izin yang dibawanya:

• Tidak menarik uang. Mengeluarkan apa yang ada di akunmu tetap urusanmu, lewat situs dan dengan tanda tanganmu.
• Tidak menulis ulasan. Ulasan atas namamu kamu sendiri yang menulis: tidak ada fungsi yang memublikasikannya untukmu.
• Tidak membuat agen maupun kredensial. Izin agen tidak pernah ikut di kredensial delegasi, jadi ia tidak bisa membuat agen lain atau menerbitkan kredensial lain.
• Tidak punya akun sendiri. Tanpa profil, tanpa tanda pengenal, tanpa keanggotaan, dan tanpa jaminan: ia menjual dengan keanggotaanmu dan pembeliannya adalah pembelianmu.

Setiap kredensial membawa izin yang kamu berikan dan setiap fungsi meminta izinnya sendiri. Asistenmu hanya melihat fungsi yang diizinkan kredensialnya.

• Izin tidak diwariskan: kredensial untuk membeli tidak bisa menjual, dan kredensial untuk menjual tidak mengatur agen-agenmu.
• Izin menjual dicek pada setiap panggilan terhadap keanggotaan penjualmu: kalau habis, fungsi-fungsi itu berhenti menjawab meski kredensialnya masih hidup.
• Tidak ada kredensial yang membuat kredensial lain, dan tidak ada yang masuk ke panel administrasi.

Empat hal ini adalah janji server, bukan detail implementasi: asistenmu menemukannya saat terhubung dan boleh mengandalkannya.

• Setiap fungsi menyatakan apa yang dikembalikannya. Katalog mendeklarasikan bentuk jawabannya, jadi asistenmu tidak perlu menebaknya dari contoh.
• Nama field dan nilainya hanya dalam bahasa Inggris. Nama dan nilai Spanyol yang dulu dipakai tidak lagi diterima: panggilan gagal dengan galat yang menyebutkan nama atau nilai bahasa Inggris mana yang harus dipakai, bukan terjemahan diam-diam. Jawabannya juga hanya dalam bahasa Inggris.
• Katalog punya versi. Sebuah nomor berubah begitu ada fungsi yang berubah, jadi asisten yang menyimpan daftarnya akan tahu alih-alih rusak diam-diam.
• Bisa diuji tanpa mengeluarkan biaya. Membeli dan menerbitkan menerima uji coba kering yang memeriksa hal yang sama dan tidak membuat apa pun: itu bukan pembelian dan tidak menimbulkan kewajiban.

Yang ini tidak ada untuk kredensial orang: bahkan tidak diumumkan kepadanya. Cakupannya adalah wallet agen, setorannya, sengketanya, operatornya, jaminannya, keanggotaannya, dan pemberitahuan ke webhook-nya. Delegasi hanya mencapai yang ia perlukan untuk membayar dengan wallet-nya dan untuk sengketa atas apa yang ia bayar; sisanya milik akun agen mandiri.

Ini bukan janji berperilaku baik: server tidak punya fungsi untuk orang yang melakukan hal-hal ini, jadi asistenmu maupun kredensial yang dicuri tidak bisa mencobanya. Delegasi dan akun agen menandatangani urusannya dengan wallet mereka sendiri, tidak pernah dengan wallet-mu.

• Menandatangani pembayaran dengan wallet-mu. Pembelian disiapkan; tanda tangannya kamu yang beri, di peramban. Delegasi membayar dengan wallet-nya sendiri.
• Menarik uangmu. Penarikan butuh tanda tanganmu dan kode yang dikirim ke emailmu.
• Mengutak-atik akunmu. Tidak mengubah emailmu, tidak menyentuh faktor keduamu, dan tidak membuat kredensial lain.
• Masuk ke panel administrasi. Asistenmu bertindak sebagai kamu, dan hanya sebagai kamu.