API key हरू

परिचय

API key ले तपाईंलाई Goji REST API प्रोग्रामेटिक रूपमा कल गर्न दिन्छ। तपाईं key बनाउन (एक पटक देखिने), प्रतिलिपि वा revoke गर्न, छुट्टाछुट्टै key enable/disable गर्न, plan विरुद्ध प्रति-मिनेट/दिन/महिना प्रयोग हेर्न, IP द्वारा पहुँच सीमित गर्न, र webhook URL सेट गर्न सक्नुहुन्छ।

चरणबद्ध मार्गदर्शन

1. Dashboard → API keys खोल्नुहोस्।
2. Create a new key क्लिक गरी नाम दिनुहोस्, र key तुरुन्तै प्रतिलिपि गर्नुहोस् — पूरा मान एक पटक मात्र देखिन्छ।
3. key लाई Bearer token का रूपमा प्रयोग गर्नुहोस्: Authorization: Bearer gk_…, /api/v1/… मा।
4. Usage कार्ड हेर्नुहोस् — plan सीमाविरुद्ध यस मिनेट/दिन/महिनाका अनुरोध; सीमा नजिकिँदा चेतावनी देखिन्छ।
5. key रोक्न Enable/Disable, हटाउन Revoke/Delete प्रयोग गर्नुहोस्।
6. वैकल्पिक रूपमा API Security मा IP whitelist र webhook URL ("Send test webhook" सहित) सेट गर्नुहोस्।
7. endpoint, उदाहरण र तपाईंको लाइभ rate-limit तालिकाका लागि View API docs हेर्नुहोस्।

सामान्य गल्तीहरू

• key पछि नभेट्टिने ठाउँमा टाँस्नु — बनाएलगत्तै secret manager मा राख्नुहोस्।
• key लाई source control मा राख्नु वा chat मा साझा गर्नु।
• 429 error आएपछि कसिलो loop मा पुनः प्रयास गर्नु — Retry-After हेडर र plan सीमालाई सम्मान गर्नुहोस्।

उत्कृष्ट अभ्यासहरू

• प्रति integration एउटा key प्रयोग गर्नुहोस् ताकि आवश्यक भए त्यही मात्र revoke गर्न सकियोस्।
• कल गर्नेको ठेगाना स्थिर हुँदा IP whitelist ले key सीमित गर्नुहोस्।
• key समय-समयमा र कुनै उजागर भएको आशंका हुँदा तुरुन्तै rotate गर्नुहोस्।