Webhook रजिस्टर करें
एक public URL को supported events में subscribe करता है। हर endpoint को अपना HMAC-SHA256 secret मिलता है, जो बनाते समय एक बार दिखता है। खो जाने पर endpoint हटाकर दोबारा जोड़ें।
https://notpanel.com/api/v3action=webhook.addapplication/x-www-form-urlencodedपैरामीटर
| नाम | टाइप | विवरण |
|---|---|---|
| keyआवश्यक | string | आपकी API की। |
| actionआवश्यक | string | लिटरल स्ट्रिंग "webhook.add" होना चाहिए। |
| urlआवश्यक | string (URL) | सार्वजनिक HTTPS एंडपॉइंट जो POSTs प्राप्त करेगा। सार्वजनिक इंटरनेट से पहुंच योग्य होना चाहिए। |
| events | string (CSV) | नीचे दिए छह supported events का comma-separated subset। सभी छह subscribe करने के लिए इसे छोड़ दें। |
उदाहरण रिक्वेस्ट
YOUR_API_KEY को अपने डैशबोर्ड के API पेज के तहत जनरेट की गई की से बदलें।
curl -X POST https://notpanel.com/api/v3 \
-H "Content-Type: application/x-www-form-urlencoded" \
-d "key=YOUR_API_KEY&action=webhook.add&url=https://your-server.example.com/notpanel-webhook&events=order.completed,order.refunded"const res = await fetch("https://notpanel.com/api/v3", {
method: "POST",
headers: { "Content-Type": "application/x-www-form-urlencoded" },
body: new URLSearchParams({
key: "YOUR_API_KEY",
action: "webhook.add",
url: "https://your-server.example.com/notpanel-webhook",
events: "order.completed,order.refunded",
}),
});
const data = await res.json();
console.log(data);import requests
res = requests.post(
"https://notpanel.com/api/v3",
data={
"key": "YOUR_API_KEY",
"action": "webhook.add",
"url": "https://your-server.example.com/notpanel-webhook",
"events": "order.completed,order.refunded",
},
)
print(res.json())<?php
$body = http_build_query([
'key' => 'YOUR_API_KEY',
'action' => 'webhook.add',
'url' => 'https://your-server.example.com/notpanel-webhook',
'events' => 'order.completed,order.refunded',
]);
$response = file_get_contents('https://notpanel.com/api/v3', false, stream_context_create([
'http' => [
'method' => 'POST',
'header' => "Content-Type: application/x-www-form-urlencoded\r\n",
'content' => $body,
'ignore_errors' => true,
],
]));
print_r(json_decode($response, true));
उदाहरण रिस्पॉन्स
{
"webhook_id": "3f2504e0-4f89-41d3-9a0c-0305e82c3301",
"url": "https://your-server.example.com/notpanel-webhook",
"secret": "0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef",
"events": [
"order.completed",
"order.refunded"
]
}सामान्य एरर
| स्टेटस | बॉडी | कारण |
|---|---|---|
| 400 | {"error":"Maximum 5 webhook endpoints per API key"} | मौजूदा एंडपॉइंट ने कैप ख़त्म कर दिया। पहले action=webhook.remove के साथ एक अप्रयुक्त एंडपॉइंट हटाएं। |
| 400 | {"error":"Webhook URL must be a publicly reachable HTTPS URL"} | URL वैध HTTPS नहीं था, parse नहीं हुआ, या private/loopback IP पर resolve हुआ। |
| 400 | {"error":"Webhook event is invalid","error_code":"INVALID_WEBHOOK_EVENT"} | इवेंट नाम allow-list पर नहीं है। स्पेलिंग दोबारा जांचें — नाम "order.<status>" रूप का इस्तेमाल करते हैं। |