पिछले कुछ हफ्तों से हम PHP के लिए एक SDK विकसित कर रहे हैं, ताकि PHP डेवलपर्स Hapio का उपयोग आसानी से शुरू कर सकें। हमें यह घोषणा करते हुए खुशी हो रही है कि इसे सार्वजनिक रूप से जारी कर दिया गया है।

PHP के लिए Hapio SDK को PHP अनुप्रयोगों में Hapio की मजबूत बुकिंग और शेड्यूलिंग क्षमताओं के एकीकरण को सुव्यवस्थित करने के लिए डिज़ाइन किया गया है, जो डेवलपर्स को अपने प्रोजेक्ट की कार्यक्षमता को बढ़ाने के लिए एक शक्तिशाली उपकरण प्रदान करता है।

सिस्टम आवश्यकताएं

PHP के लिए Hapio SDK का उपयोग शुरू करने से पहले, डेवलपर्स को यह सुनिश्चित करना चाहिए कि उनका वातावरण निम्नलिखित आवश्यकताओं को पूरा करता है:
PHP 8.2 या बाद का संस्करण।

शुरू करना

किसी PHP प्रोजेक्ट में Hapio SDK को एकीकृत करना एक सरल प्रक्रिया है। डेवलपर लोकप्रिय PHP डिपेंडेंसी मैनेजर Composer का उपयोग करके SDK को अपने प्रोजेक्ट में शामिल कर सकते हैं। शुरुआत करने का तरीका यहाँ दिया गया है:

अपने प्रोजेक्ट का टर्मिनल या कमांड प्रॉम्प्ट खोलें।
निम्नलिखित कंपोज़र कमांड चलाएँ:

composer require hapio/hapio-sdk-php

एक बार SDK सफलतापूर्वक इंस्टॉल हो जाने के बाद, डेवलपर इसे अपने प्रोजेक्ट में उपयोग करना शुरू कर सकते हैं।

एसडी के साथ काम करना

PHP के लिए Hapio SDK का उपयोग करना API क्लाइंट को स्थापित करने और काम शुरू करने जितना ही सरल है। SDK के साथ शुरुआत करने का एक उदाहरण नीचे दिया गया है:

// Require the Composer autoloader
require __DIR__ . '/vendor/autoload.php';

use Hapio\Sdk\ApiClient;

// Instantiate a Hapio API client
$apiClient = new ApiClient('your-api-token');

// Get a list of all bookings this week
$response = $apiClient->bookings()->list([
    'from' => new DateTime('monday this week 00:00:00'),
    'to' => new DateTime('friday this week 23:59:59'),
]);

while ($response) {
    foreach ($response->getItems() as $booking) {
        var_dump($booking);
    }

    if ($response->hasMoreItems()) {
        $response = $response->getNextPage();
    } else {
        $response = null;
    }
}

प्रलेखन और मॉडल

PHP के लिए Hapio SDK व्यापक दस्तावेज़ीकरण प्रदान करता है और Hapio API के साथ कुशलतापूर्वक इंटरैक्ट करने के लिए विभिन्न मॉडल शामिल करता है। उपलब्ध मॉडलों में से कुछ इस प्रकार हैं:

• परियोजना
• जगह
• संसाधन
• सेवा
• अनुसूची ब्लॉक
• आवर्ती अनुसूची
• आवर्ती अनुसूची ब्लॉक
• बुकिंग
• बुक करने योग्य स्लॉट
• समय अवधि
• संसाधन सेवा संघ

ये मॉडल Hapio एंटिटीज़ के साथ इंटरैक्शन को सरल बनाते हैं, जिससे डेटा बनाना, अपडेट करना और प्राप्त करना आसान हो जाता है। डेवलपर प्रॉपर्टी सेट कर सकते हैं और मॉडल के साथ इंटरैक्ट करने के लिए snake_case या camelCase नामकरण नियमों का उपयोग कर सकते हैं।

डेटा संग्रह स्थान

API के साथ संचार को सुगम बनाने के लिए, PHP के लिए Hapio SDK, Hapio में उपलब्ध प्रत्येक प्रकार की इकाई के लिए रिपॉजिटरी क्लास प्रदान करता है। ये रिपॉजिटरी डेटा भेजने और प्राप्त करने के लिए गेटवे के रूप में कार्य करती हैं और ApiClient क्लास के तरीकों के माध्यम से सुलभ होती हैं।

उपलब्ध रिपॉजिटरी में से कुछ इस प्रकार हैं:

• प्रोजेक्ट रिपॉजिटरी
• स्थान भंडार
• संसाधन भंडार
• सेवा भंडार
• शेड्यूलब्लॉकरिपॉजिटरी
• आवर्ती अनुसूची भंडार
• आवर्ती अनुसूची ब्लॉक रिपॉजिटरी
• बुकिंग रिपॉजिटरी

प्रत्येक रिपॉजिटरी उन विधियों का एक सेट प्रदान करती है जो संबंधित इकाई प्रकार के लिए उपलब्ध एपीआई एंडपॉइंट्स के अनुरूप होती हैं।

पृष्ठबद्ध प्रतिक्रियाएँ

पेज में विभाजित डेटा सूचियाँ लौटाने वाले API एंडपॉइंट्स के लिए, Hapio SDK एक PaginatedResponse क्लास प्रदान करता है जिसमें इन प्रतिक्रियाओं को संभालने को सरल बनाने के लिए विभिन्न विधियाँ मौजूद हैं। डेवलपर्स आसानी से पेज में विभाजित डेटा को नेविगेट कर सकते हैं, आइटम प्राप्त कर सकते हैं और यह निर्धारित कर सकते हैं कि क्या और पेज उपलब्ध हैं।

एक्सेप्शन हेंडलिंग

PHP के लिए Hapio SDK में मजबूत एक्सेप्शन हैंडलिंग शामिल है, जिससे डेवलपर्स त्रुटियों को प्रभावी ढंग से प्रबंधित कर सकते हैं। जब API 4XX या 5XX स्टेटस कोड के साथ प्रतिक्रिया करता है, तो उपयुक्त एक्सेप्शन उत्पन्न होते हैं। 422 स्टेटस कोड वाली सत्यापन त्रुटियां ValidationException को ट्रिगर करेंगी, जबकि अन्य 4XX और 5XX स्टेटस कोड के परिणामस्वरूप ErrorException उत्पन्न होगा। ये एक्सेप्शन त्रुटि संदेशों, स्टेटस कोड और लागू होने पर सत्यापन त्रुटियों तक पहुंच प्रदान करते हैं।

PHP के लिए Hapio SDK के जारी होने के साथ, डेवलपर्स अब Hapio की बुकिंग और शेड्यूलिंग क्षमताओं को अपने PHP प्रोजेक्ट्स में आसानी से एकीकृत कर सकते हैं, जिससे उनके अनुप्रयोगों की दक्षता और कार्यक्षमता में वृद्धि होती है।

SDK Packagist.org पर उपलब्ध है और इसे Composer के माध्यम से इंस्टॉल किया जा सकता है। आप GitHub पर इसका सोर्स कोड भी देख सकते हैं।