Nexa SDK
Nexa SDK adalah sebuah SDK PHP yang dirancang untuk mempermudah
penanganan permintaan API. SDK ini mendukung dua versi implementasi
API (V1 dan V2) dengan mekanisme autentikasi dan penanganan permintaan
yang berbeda.
Autentikasi
Autentikasi V1
API V1 menggunakan autentikasi berbasis token sederhana:
// Sertakan API Key di header
API-Key: kunci_api_anda
Autentikasi V2
API V2 memerlukan API Key dan API Secret:
// Sertakan di header HTTP
API-Key: kunci_api_anda
API-Secret: secret_api_anda
API V1
Cara Membuat Permintaan V1
API V1 mendukung penanganan permintaan sederhana dengan autentikasi
berbasis token.
Format Permintaan:
POST /api/v1/endpoint
Content-Type: application/json
API-Key: kunci_api_anda
{
"parameter1": "nilai1",
"parameter2": "nilai2"
}
API V2
Autentikasi V2
API V2 memerlukan API Key dan API Secret:
// Sertakan di header HTTP
API-Key: kunci_api_anda
API-Secret: secret_api_anda
Endpoint RESTful
API V2 mengikuti standar RESTful dengan metode HTTP standar:
| Metode HTTP |
Pola Endpoint |
Nama Metode |
Keterangan |
| GET |
/v2/resource |
getResource() |
Mengambil data |
| POST |
/v2/resource |
createResource() |
Membuat data baru |
| PUT |
/v2/resource |
updateResource() |
Memperbarui data |
| DELETE |
/v2/resource |
deleteResource() |
Menghapus data |
Penanganan Error
SDK akan mengeluarkan exception untuk berbagai kondisi error:
| Kode Error |
Keterangan |
| 401 |
Autentikasi gagal (API key atau secret tidak valid) |
| 403 |
Akses langsung dari browser tidak diizinkan |
| 404 |
Endpoint tidak ditemukan |
| 405 |
Metode tidak diizinkan |
