Public API

Base URL: https://your-domain.com

Public endpoints that do not require authentication.

---

Get Public Settings

Retrieve public system settings including ISP branding, payment gateway status, and app configuration.

Property	Value
Endpoint	Get Public Settings
Method	GET
URL	/api/v1/public/settings
Authentication	Not Required

Request Headers:

Header	Value	Required
Accept	application/json	Yes

Request Body: None

Success Response (200 OK):

{
    "success": true,
    "data": {
        "app_name": "Zal Ultra",
        "app_logo": "https://your-domain.com/logo.png",
        "currency": "BDT",
        "currency_symbol": "৳",
        "timezone": "Asia/Dhaka",
        "bkash_enabled": true,
        "nagad_enabled": false,
        "online_payment_enabled": true
    }
}

Error Response (500 Internal Server Error):

{
    "success": false,
    "message": "Failed to retrieve settings"
}

Code Examples:

cURL

curl -X GET "https://your-domain.com/api/v1/public/settings" \
  -H "Accept: application/json"

PHP

<?php

require 'vendor/autoload.php';

use GuzzleHttp\Client;

$client = new Client(['base_uri' => 'https://your-domain.com']);

$response = $client->request('GET', '/api/v1/public/settings', [
    'headers' => [
        'Accept'        => 'application/json',
    ],
]);

$data = json_decode($response->getBody(), true);
print_r($data);

JavaScript

const BASE_URL = 'https://your-domain.com';

const response = await fetch(`${BASE_URL}/api/v1/public/settings`, {
  method: 'GET',
  headers: {
    Accept: 'application/json',
  },
});

const data = await response.json();
console.log(data);

Python

import requests

BASE_URL = "https://your-domain.com"

response = requests.get(
    f"{BASE_URL}/api/v1/public/settings",
    headers={
        "Accept": "application/json",
    },
)

data = response.json()
print(data)

Go

package main

import (
	"fmt"
	"io"
	"net/http"
)

const baseURL = "https://your-domain.com"

func main() {
	endpoint := baseURL + "/api/v1/public/settings"

	req, _ := http.NewRequest("GET", endpoint, nil)
	req.Header.Set("Accept", "application/json")

	resp, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()

	body, _ := io.ReadAll(resp.Body)
	fmt.Println(resp.StatusCode, string(body))
}

Rust

use reqwest::Client;

const BASE_URL: &str = "https://your-domain.com";

#[tokio::main]
async fn main() -> Result<(), reqwest::Error> {
    let client = Client::new();

    let response = client
        .get(format!("{BASE_URL}/api/v1/public/settings"))
        .header("Accept", "application/json")
        .send()
        .await?;

    let data: serde_json::Value = response.json().await?;
    println!("{data:#}");
    Ok(())
}