jsonapi - Manual Penggunaan

Pendahuluan

jsonapi adalah paket Go yang menyediakan fungsi untuk melakukan HTTP request dengan JSON payload dan autentikasi menggunakan token. Paket ini mendukung metode GET dan POST dengan opsi untuk menambahkan token otorisasi.

Instalasi

Tambahkan paket ini ke proyek Go Anda:

 go get github.com/gocroot/jsonapi

Fungsi-Fungsi

1. PostStructWithToken

Mengirim data dalam bentuk struct ke endpoint dengan metode POST dan menambahkan token otorisasi ke dalam header.

Parameter:

• tokenkey (string): Nama header token.
• tokenvalue (string): Nilai token.
• structname (interface{}): Data yang akan dikirim dalam format JSON.
• urltarget (string): URL tujuan.

Contoh Penggunaan:

var response map[string]interface{}
data := map[string]string{"key": "value"}
status, result, err := jsonapi.PostStructWithToken("Authorization", "Bearer mytoken", data, "https://example.com/api")

2. Get

Melakukan request GET ke endpoint yang diberikan dan mengembalikan hasil JSON.

Parameter:

• urltarget (string): URL tujuan.

Contoh Penggunaan:

var response map[string]interface{}
status, result, err := jsonapi.Get("https://example.com/api")

3. GetWithBearer

Melakukan request GET dengan menambahkan token bearer ke dalam header.

Parameter:

• tokenbearer (string): Token otorisasi.
• urltarget (string): URL tujuan.

Contoh Penggunaan:

var response map[string]interface{}
status, result, err := jsonapi.GetWithBearer("mytoken", "https://example.com/api")

4. GetStructWithToken

Melakukan request GET dengan menambahkan token kustom ke dalam header.

Parameter:

• tokenkey (string): Nama header token.
• tokenvalue (string): Nilai token.
• urltarget (string): URL tujuan.

Contoh Penggunaan:

var response map[string]interface{}
status, result, err := jsonapi.GetStructWithToken("X-API-KEY", "myapikey", "https://example.com/api")

Error Handling

Jika response bukan JSON yang valid, fungsi akan mengembalikan error dengan informasi tambahan tentang konten yang diterima.

Lisensi

Paket ini tersedia dengan lisensi open-source. Silakan gunakan sesuai kebutuhan Anda.

Release Version

go get -u all
go mod tidy
git tag v0.0.1
git push origin --tags
go list -m github.com/gocroot/jsonapi@v0.0.1