Pembangun

Bina di atas Mastura tanpa mengubahnya, dan terbitkan apa yang anda buat untuk syarikat lain. Pilih cara paling ringan yang memenuhi keperluan anda.

Empat cara membina di atasnya

CaraApa ituMenjalankan kod dalam pelayan?Lesen kerja anda
Pek sambunganFail data: peraturan aliran kerja, laporan, templat dokumen, tetapan borang input, penomboran dan susun atur papan pemukaTidakPilihan anda
TemaFail warna dan bentuk sudutTidakPilihan anda
Aplikasi luarProgram anda sendiri yang menggunakan API dan webhookTidak, ia berjalan di tempat lainPilihan anda
Sumbangan terasKod Go yang ditambah ke dalam sistem itu sendiriYa, selepas semakanAGPL v3

Pek, tema dan aplikasi luar tidak boleh menjalankan kod dalam pemasangan orang lain, jadi memasangnya tidak boleh merosakkannya atau membaca data yang tidak diberikan. Peraturan aliran kerja dalam pek tiba dalam keadaan dimatikan, dan pemasang menyemak apa yang ditambah sebelum bersetuju. Aplikasi luar hanya mendapat apa yang dibenarkan untuk pengguna kunci API-nya.

API dan webhook

  • Kunci API bertindak sebagai pengguna, dengan kebenaran pengguna itu, baca sahaja atau baca dan tulis. Hanya cincangan kunci disimpan, dan kunci ditunjukkan sekali.
  • Titik akhir di bawah /api/v1/ untuk akaun, kenalan, item, catatan jurnal, invois, petunjuk dan CRM, mengembalikan JSON.
  • Webhook menghantar hantaran JSON bertandatangan (X-Signature: sha256=…) bagi setiap rekod yang disimpan pada halaman pilihan anda, dicuba semula sekali jika gagal.

Format fail

Setiap fail menamakan format dan versionnya, dan sistem menolak versi yang tidak dikenalinya. Versi kemudian hanya menambah medan; perubahan yang merosakkan fail lama mendapat nombor versi baharu.

FailFormatVersi
Pek sambungannbs-pack1
Temanbs-theme1
Dokumen perdagangan antara rakan niaganbs-trade1

Menerbitkan dalam Pasaran

Setiap pemasangan mempunyai Pasaran tempat pentadbir menghidupkan dan mematikan modul serta memasang pek dan tema. Setiap pek dan tema diterbitkan di bawah penerbit, sama ada syarikat atau individu, yang namanya disertakan. Katalog bersama pek dan tema daripada pembangun lain dirancang, bersama akaun penerbit dan senarai berbayar.

Dokumentasi

Dokumentasi pembangun meliputi seni bina, pek, tema, fail perdagangan, API dengan rujukan yang dijana daripada kod, webhook dan penerbitan. Ia di bawah Apache License 2.0, jadi anda boleh menggunakan contohnya dalam kerja anda sendiri. Lihat lesen.