Awesome

Fistorage

Visitor

JSON storage with API.

Fistorage adalah projek open source yang digunakan untuk menyimpan data seperti JSON yang dilakukan lewat permintaan API dilengkapi otentikasi.

Dibuat dengan ❤ dan Node.Js oleh Feri Irawan

Memulai Cepat

Ikuti langkah berikut untuk langsung membuat akun, membuat storage dan mengambil konten storage.

Membuat Akun

curl -X POST 'https://fistorage.glitch.me/users/signup' \
-H 'Content-Type: application/json' \
-d '{
    "name":"<YOUR NAME>",
    "username":"<YOUR USERNAME>",
    "password":"<YOUR PASSWORD>"
}'

Membuat Storage

curl -X POST 'https://fistorage.glitch.me/storages/create' \
-H 'Authorization: token <YOUR TOKEN>' \
-H 'Content-Type: application/json' \
-d '{
    "title": "My First Storage",
    "description": "Lorem ipsum dolor sit amet consectetur adipisicing elit.",
    "contents": "Hello world!"
}'

Mendapatkan Konten Storage

curl -X GET 'https://fistorage.glitch.me/storages/contents/<STORAGE ID>' \
-H 'Authorization: token <YOUR TOKEN>'

Untuk panduan lengkapnya, kamu bisa membaca-baca penjelasan di bawah ini.

Users

Langkah awal untuk menggunakan Fistorage adalah membuat sebuah akun. Akun ini akan digunakan untuk otentikasi pada storage, misalnya mengambil konten, mengubah, dan menghapus storage.

Membuat Akun Baru

Parameter	Tipe	Di	Deskripsi
`Content-Type`	string	Header	Untuk memberitahu server kalau data yang dikirim adalah JSON
`name`	string	body	Nama akun baru
`username`	string	body	Username akun baru (unik), ini akan digunakan untuk login, otentikasi lainnya.
`password`	string	body	Password akun baru, ini akan digunakan untuk login, otentikasi lainnya.

Rute:

POST /users/signup

Contoh:

curl -X POST 'https://fistorage.glitch.me/users/signup' \
-H 'Content-Type: application/json' \
-d '{
    "name":"<YOUR NAME>",
    "username":"<YOUR USERNAME>",
    "password":"<YOUR PASSWORD>"
}'

Masuk ke Akun

Parameter	Tipe	Di	Deskripsi
`Content-Type`	string	Header	Untuk memberitahu server kalau data yang dikirim adalah JSON
`username`	string	body	Username akun milikmu
`password`	string	body	Password akun milikmu

Rute:

POST /users/login

Contoh:

curl -X POST 'https://fistorage.glitch.me/users/login' \
-H 'Content-Type: application/json' \
-d '{
    "username":"<YOUR USERNAME>",
    "password":"<YOUR PASSWORD>"
}'

Update Akun

Parameter	Tipe	Di	Deskripsi
`Content-Type`	string	Header	Untuk memberitahu server kalau data yang dikirim adalah JSON
`username`	string	body	Username akun milikmu
`password`	string	body	Password akun milikmu
`data`	object	body	Data akun yang akan diubah (username, password, token)
`username`	string	body `data`	Username baru (opsional), jika diisi maka username akan diupdate sesuai dengan username baru yang dimasukkan
`password`	string	body `data`	Password baru (opsional), jika diisi maka password akan diupdate sesuai dengan password baru yang dimasukkan
`token`	boolean	body `data`	(Opsional), jika diisi `true` maka token baru akan dihasilkan dan menggantikan token sebelumnnya

Rute:

PUT /users/update

Contoh (hanya update password):

curl -X PUT 'https://fistorage.glitch.me/users/update' \
-H 'Content-Type: application/json' \
-d '{
    "username":"<YOUR USERNAME>",
    "password":"<YOUR PASSWORD>"
    "data":{
        "password":"<NEW PASSWORD>"
    }
}'

Storages

Berikut ini panduan untuk mengelola storage.

Membuat Storage Baru

Parameter	Tipe	Di	Deskripsi
`Content-Type`	string	Header	Untuk memberitahu server kalau data yang dikirim adalah JSON
`Authorization`	string	Header	Token untuk keperluan otentikasi
`title`	string	body	Judul storage (opsional)
`description`	string	body	Deskripsi storage (opsional)
`contents`	semua, kecuali `undefined`	body	Konten storage (opsional)

Rute:

POST /storages/create

Contoh:

curl -X POST 'https://fistorage.glitch.me/storages/create' \
-H 'Content-Type: application/json' \
-H 'Authorization: token <YOUR TOKEN>' \
-d '{
    "title":"My Blog Post",
    "description":"Storage for my blog post",
    "contents":[]
}'

Mengambil Konten Storage

Parameter	Tipe	Di	Deskripsi
`Authorization`	string	Header	Token untuk keperluan otentikasi
`id`	string	URL	Id storage milikmu

Rute:

GET /storages/contents/{id}

Contoh:

curl -X GET 'https://fistorage.glitch.me/storages/contents/76a998d1-26e5-4fd0-8db5-95b309387fe6' \
-H 'Authorization: token <YOUR TOKEN>'

Memperbarui Storage

Parameter	Tipe	Di	Deskripsi
`Content-Type`	string	Header	Untuk memberitahu server kalau data yang dikirim adalah JSON
`Authorization`	string	Header	Token untuk keperluan otentikasi
`id`	string	URL	Id storage milikmu
`title`	string	body	Judul storage (opsional)
`description`	string	body	Deskripsi storage (opsional)
`contents`	semua, kecuali `undefined`	body	Konten storage (opsional)

Rute:

PUT /storages/update/{id}

Contoh:

curl -X POST 'https://fistorage.glitch.me/storages/update/76a998d1-26e5-4fd0-8db5-95b309387fe6' \
-H 'Authorization: token <YOUR TOKEN>' \
-H 'Content-Type: application/json' \
-d '{
    "title":"My Blog Post",
    "description":"Storage for my blog post",
    "contents":[
        {
            "title":"My First Post",
            "contents":"Lorem ipsum, dolor sit amet consectetur adipisicing elit. Doloribus, hic.",
            "created_at":"2021-12-29T14:25:54.158Z"
        }
    ]
}'

Menghapus Storage

Parameter	Tipe	Di	Deskripsi
`Authorization`	string	Header	Token untuk keperluan otentikasi
`id`	string	URL	Id storage milikmu

Rute:

DELETE /storages/delete/{id}

Contoh:

curl -X DELETE 'https://fistorage.glitch.me/storages/delete/76a998d1-26e5-4fd0-8db5-95b309387fe6' \
-H 'Authorization: token <YOUR TOKEN>'

Seperti itulah panduan permintaan untuk mengelola akun dan storage milikmu. Bagaimana mudah bukan?

Jika punya pertanyaan, masukan, atau permintaan lainnya tentang projek ini, silakan kirimkan di issue