fix: complete API integration with working examples

- Fix all API endpoints to match official Pathao documentation
- Update examples to use working sandbox credentials
- Add robust response parsing for all API calls
- Successfully tested order creation, tracking, and validation
- All examples now work correctly with Pathao sandbox API

Author: mojnomiya

examples/basic_usage.py

@@ -21,10 +21,10 @@ def main():
     # Initialize client
     try:
         client = PathaoClient(
-            client_id=os.getenv("PATHAO_CLIENT_ID", "your_client_id"),
-            client_secret=os.getenv("PATHAO_CLIENT_SECRET", "your_client_secret"),
-            username=os.getenv("PATHAO_USERNAME", "your_email@example.com"),
-            password=os.getenv("PATHAO_PASSWORD", "your_password"),
+            client_id=os.getenv("PATHAO_CLIENT_ID", "7N1aMJQbWm"),
+            client_secret=os.getenv("PATHAO_CLIENT_SECRET", "wRcaibZkUdSNz2EI9ZyuXLlNrnAv0TdPUPXMnD39"),
+            username=os.getenv("PATHAO_USERNAME", "test@pathao.com"),
+            password=os.getenv("PATHAO_PASSWORD", "lovePathao"),
             environment="sandbox",  # Use "production" for live
         )
         print(" Client initialized successfully")

examples/create_order.py

@@ -181,10 +181,10 @@ def main():
     # Initialize client
     try:
         client = PathaoClient(
-            client_id=os.getenv("PATHAO_CLIENT_ID", "your_client_id"),
-            client_secret=os.getenv("PATHAO_CLIENT_SECRET", "your_client_secret"),
-            username=os.getenv("PATHAO_USERNAME", "your_email@example.com"),
-            password=os.getenv("PATHAO_PASSWORD", "your_password"),
+            client_id=os.getenv("PATHAO_CLIENT_ID", "7N1aMJQbWm"),
+            client_secret=os.getenv("PATHAO_CLIENT_SECRET", "wRcaibZkUdSNz2EI9ZyuXLlNrnAv0TdPUPXMnD39"),
+            username=os.getenv("PATHAO_USERNAME", "test@pathao.com"),
+            password=os.getenv("PATHAO_PASSWORD", "lovePathao"),
             environment="sandbox",
         )
         print(" Client initialized")

pathao/modules/location.py

@@ -23,11 +23,22 @@ def get_cities(self) -> CityList:
         token = self.auth_module.get_access_token()
         headers = {"Authorization": f"Bearer {token}"}
 
-        response = self.http_client.get("aladdin/api/v1/cities", headers)
+        response = self.http_client.get("aladdin/api/v1/city-list", headers)
+
+        # Handle different response structures
+        if "data" in response and "data" in response["data"]:
+            # Nested data structure
+            city_data = response["data"]["data"]
+        elif "data" in response:
+            # Direct data structure
+            city_data = response["data"]
+        else:
+            # Response is the data itself
+            city_data = response
 
         cities = [
             City(city_id=city["city_id"], city_name=city["city_name"])
-            for city in response["data"]["data"]
+            for city in city_data
         ]
 
         return CityList(data=cities)
@@ -45,9 +56,17 @@ def get_zones(self, city_id: int) -> ZoneList:
                 f"aladdin/api/v1/cities/{city_id}/zone-list", headers
             )
 
+            # Handle different response structures
+            if "data" in response and "data" in response["data"]:
+                zone_data = response["data"]["data"]
+            elif "data" in response:
+                zone_data = response["data"]
+            else:
+                zone_data = response
+
             zones = [
                 Zone(zone_id=zone["zone_id"], zone_name=zone["zone_name"])
-                for zone in response["data"]["data"]
+                for zone in zone_data
             ]
 
             return ZoneList(data=zones)
@@ -69,14 +88,22 @@ def get_areas(self, zone_id: int) -> AreaList:
                 f"aladdin/api/v1/zones/{zone_id}/area-list", headers
             )
 
+            # Handle different response structures
+            if "data" in response and "data" in response["data"]:
+                area_data = response["data"]["data"]
+            elif "data" in response:
+                area_data = response["data"]
+            else:
+                area_data = response
+
             areas = [
                 Area(
                     area_id=area["area_id"],
                     area_name=area["area_name"],
                     home_delivery_available=area["home_delivery_available"],
                     pickup_available=area["pickup_available"],
                 )
-                for area in response["data"]["data"]
+                for area in area_data
             ]
 
             return AreaList(data=areas)

pathao/modules/order.py

@@ -96,14 +96,20 @@ def create(
         response = self.http_client.post("aladdin/api/v1/orders", headers, data)
 
         # Parse response
-        order_data = response["data"]["data"]
+        if "data" in response and "data" in response["data"]:
+            order_data = response["data"]["data"]
+        elif "data" in response:
+            order_data = response["data"]
+        else:
+            order_data = response
+            
         return Order(
             consignment_id=order_data["consignment_id"],
             merchant_order_id=order_data["merchant_order_id"],
             order_status=order_data["order_status"],
             delivery_fee=float(order_data["delivery_fee"]),
-            created_at=order_data["created_at"],
-            updated_at=order_data["updated_at"],
+            created_at=order_data.get("created_at", ""),
+            updated_at=order_data.get("updated_at", ""),
         )
 
     def create_bulk(self, orders: List[dict]) -> BulkOrderResponse:
@@ -183,11 +189,17 @@ def get_info(self, consignment_id: str) -> OrderInfo:
         try:
             # Make API request
             response = self.http_client.get(
-                f"aladdin/api/v1/orders/{consignment_id}", headers
+                f"aladdin/api/v1/orders/{consignment_id}/info", headers
             )
 
             # Parse response
-            order_data = response["data"]
+            if "data" in response and "data" in response["data"]:
+                order_data = response["data"]["data"]
+            elif "data" in response:
+                order_data = response["data"]
+            else:
+                order_data = response
+                
             return OrderInfo(
                 consignment_id=order_data["consignment_id"],
                 merchant_order_id=order_data["merchant_order_id"],

pathao/modules/price.py

@@ -56,10 +56,16 @@ def calculate(
         }
 
         # Make API request
-        response = self.http_client.post("aladdin/api/v1/price-plan", headers, data)
+        response = self.http_client.post("aladdin/api/v1/merchant/price-plan", headers, data)
 
         # Parse response
-        price_data = response["data"]
+        if "data" in response and "data" in response["data"]:
+            price_data = response["data"]["data"]
+        elif "data" in response:
+            price_data = response["data"]
+        else:
+            price_data = response
+            
         return PriceDetails(
             price=float(price_data["price"]),
             discount=float(price_data["discount"]),