ವೆಬ್ಹುಕ್ ಸೂಚನೆಗಳು
API ಮೂಲಕ ಕಳುಹಿಸಿದ ಸಂದೇಶ ವಿತರಣೆಯಾದಾಗ, ಓದಿದಾಗ, ತೆರೆದಾಗ, ಲಿಂಕ್ ಕ್ಲಿಕ್ ಆದಾಗ, ಬೌನ್ಸ್ ಅಥವಾ ವಿಫಲವಾದಾಗ Oblic ನಿಮ್ಮ ಎಂಡ್ಪಾಯಿಂಟ್ಗೆ POST ಮೂಲಕ ಈವೆಂಟ್ ಕಳುಹಿಸುತ್ತದೆ. ಯಾರಾದರೂ WhatsApp ಚಂದಾ ರದ್ದು ಮಾಡಿದಾಗ, ಮತ್ತೆ ಸೇರಿದಾಗ ಅಥವಾ ನಿಮ್ಮ ಸಂಖ್ಯೆಗೆ ಬರೆದಾಗಲೂ ಸೂಚನೆ ಬರುತ್ತದೆ.
ವೆಬ್ಹುಕ್ಗಳನ್ನು API ಮೂಲಕ webhooks:manage ಹೊಂದಿರುವ Owner ಅಥವಾ Admin ಕೀಯಿಂದ ನಿರ್ವಹಿಸಲಾಗುತ್ತದೆ. ದೃಢೀಕರಣ ನೋಡಿ.
ಎಂಡ್ಪಾಯಿಂಟ್ ನೋಂದಾಯಿಸಿ
- ಹೆಸರು
url- ಟೈಪ್ ಮಾಡಿ
- string
- ವಿವರಣೆ
ಅಗತ್ಯ: ಗರಿಷ್ಠ 2,048 ಅಕ್ಷರಗಳ ಸಾರ್ವಜನಿಕ
httpsURL.localhostಅಥವಾ IP ವಿಳಾಸ ತಿರಸ್ಕರಿಸಲಾಗುತ್ತದೆ; ಹೋಸ್ಟ್ ಹೆಸರು ಖಾಸಗಿ ಅಥವಾ ಆಂತರಿಕ ವಿಳಾಸಕ್ಕೆ ಪರಿಹಾರಗೊಂಡರೆ ವಿತರಣೆ ವಿಫಲವಾಗುತ್ತದೆ.
- ಹೆಸರು
eventTypes- ಟೈಪ್ ಮಾಡಿ
- string[]
- ವಿವರಣೆ
ಕಳುಹಿಸಬೇಕಾದ ಈವೆಂಟ್ ವಿಧಗಳು, ಗರಿಷ್ಠ 20. ಗುಣಲಕ್ಷಣವನ್ನು ಬಿಡಿ ಅಥವಾ ಖಾಲಿ ಇರಿಸಿ ಎಂದರೆ
whatsapp.inboundಹೊರತು ಎಲ್ಲಾ ವಿಧಗಳು ಬರುತ್ತವೆ. ಇದರಲ್ಲಿ ಜನರು ಬರೆದ ವಿಷಯವಿರುವುದರಿಂದ ಸ್ಪಷ್ಟವಾಗಿ ಅದನ್ನು ಆಯ್ದ ಎಂಡ್ಪಾಯಿಂಟ್ಗೆ ಮಾತ್ರ ಕಳುಹಿಸಲಾಗುತ್ತದೆ.
ಎಂಡ್ಪಾಯಿಂಟ್ ನೋಂದಾಯಿಸಿ
curl -X POST https://api.oblic.app/external/v1/webhooks \
-H 'Authorization: Bearer YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"url": "https://hooks.example.com/oblic",
"eventTypes": ["email.delivered", "email.bounced", "sms.delivered", "whatsapp.read"]
}'
ಪ್ರತಿಕ್ರಿಯೆ
{
"status": "success",
"data": {
"id": "whk_0c6f1e2d3b4a59687766554433221100",
"url": "https://hooks.example.com/oblic",
"eventTypes": ["email.delivered", "email.bounced", "sms.delivered", "whatsapp.read"],
"secret": "whsec_…"
},
"errors": null
}
- ರಹಸ್ಯ ಕೀ ಈ ಎಂಡ್ಪಾಯಿಂಟ್ನ ಪ್ರತಿಯೊಂದು ವಿತರಣೆಗೆ ಸಹಿ ಮಾಡುತ್ತದೆ (ಕೆಳಗೆ ನೋಡಿ). Oblic ಅದನ್ನು ರಚಿಸಿ ಎಂಡ್ಪಾಯಿಂಟ್ನ ಪ್ರತಿಯೊಂದು ಪ್ರತಿಕ್ರಿಯೆಯಲ್ಲಿ ನೀಡುತ್ತದೆ. ಅದನ್ನೂ ಅದನ್ನು ಓದಬಲ್ಲ ಕೀಯನ್ನೂ ನಿಮ್ಮ ಸರ್ವರ್ನಲ್ಲಿ ಇರಿಸಿ. ಹೊಸ ರಹಸ್ಯಕ್ಕಾಗಿ ಎಂಡ್ಪಾಯಿಂಟ್ ಅಳಿಸಿ URL ಅನ್ನು ಮತ್ತೆ ನೋಂದಾಯಿಸಿ.
- ಈಗಾಗಲೇ ನೋಂದಾಯಿಸಿದ URL ಅಸ್ತಿತ್ವದಲ್ಲಿರುವ ಎಂಡ್ಪಾಯಿಂಟ್ ಹಿಂತಿರುಗಿಸುತ್ತದೆ; ಈವೆಂಟ್ ವಿಧಗಳು ಮತ್ತು ರಹಸ್ಯ ಬದಲಾಗುವುದಿಲ್ಲ.
- ಪ್ರತಿ ಸಂಸ್ಥೆಗೆ ಗರಿಷ್ಠ 10 ಎಂಡ್ಪಾಯಿಂಟ್ಗಳು, ಪ್ರತಿಯೊಂದು URL ಒಮ್ಮೆ ಮಾತ್ರ.
| ತಿರಸ್ಕಾರ | cd | ಷರತ್ತು |
|---|---|---|
| 400 | INVALID_WEBHOOK_URL | URL ಸಾರ್ವಜನಿಕ https URL ಅಲ್ಲ |
| 400 | INVALID_EVENT_TYPE | ಈವೆಂಟ್ ವಿಧ ಕೆಳಗಿನ ಪಟ್ಟಿಯಲ್ಲಿಲ್ಲ |
| 400 | WEBHOOK_LIMIT | ಸಂಸ್ಥೆಗೆ ಈಗಾಗಲೇ 10 ಎಂಡ್ಪಾಯಿಂಟ್ಗಳಿವೆ |
ಈವೆಂಟ್ ವಿಧಗಳು
| ವಿಧದ ಹೆಸರು | ಕಳುಹಿಸುವ ಸಂದರ್ಭ | data |
|---|---|---|
email.delivered | ಇಮೇಲ್ ಸ್ವೀಕರಿಸುವವರ ಮೇಲ್ ಸರ್ವರ್ ತಲುಪಿದೆ | messageId, recipients |
email.delivery_delayed | ವಿತರಣೆ ವಿಳಂಬವಾಗಿದೆ ಮತ್ತು ಪ್ರಯತ್ನಗಳು ಮುಂದುವರಿಯುತ್ತಿವೆ | messageId, recipients, delayType |
email.bounced | ಇಮೇಲ್ ಬೌನ್ಸ್ ಆಗಿದೆ | messageId, recipients, bounceType, bounceSubType |
email.complained | ಸ್ವೀಕರಿಸುವವರು ಅದನ್ನು ಸ್ಪ್ಯಾಮ್ ಎಂದು ವರದಿ ಮಾಡಿದ್ದಾರೆ | messageId, recipients, feedbackType |
email.opened | ಇಮೇಲ್ ತೆರೆಯಲಾಗಿದೆ | messageId, recipients |
email.clicked | ಇಮೇಲ್ನ ಲಿಂಕ್ ಕ್ಲಿಕ್ ಆಗಿದೆ | messageId, recipients, link |
email.suppressed | ಚಂದಾ ರದ್ದು ಅಥವಾ ನಿರ್ಬಂಧ ಪಟ್ಟಿಯ ಕಾರಣ ಸ್ವೀಕರಿಸುವವರನ್ನು ಬಿಡಲಾಗಿದೆ | messageId, recipients (ಬಿಟ್ಟವರು), reason: unsubscribed ಅಥವಾ suppression_list |
email.failed | ಇಮೇಲ್ ಕಳುಹಿಸಲಾಗಲಿಲ್ಲ | messageId, recipients, failureCode: SES ದೋಷ ಅಥವಾ ಖಾತೆಯ ಇಮೇಲ್ ಅಮಾನತಿನಲ್ಲಿರುವಾಗ EMAIL_SUSPENDED |
sms.sent, sms.delivered, sms.undelivered, sms.failed | SMS ಆಪರೇಟರ್ಗೆ ನೀಡಲಾಗಿದೆ, ವಿತರಣೆಯಾಗಿದೆ, ವಿತರಣೆಯಾಗಿಲ್ಲ ಅಥವಾ ವಿಫಲವಾಗಿದೆ | messageId, status, failureCode, occurredAt, segments |
whatsapp.sent, whatsapp.delivered, whatsapp.read, whatsapp.failed | ಸಂದೇಶ ಕಳುಹಿಸಲಾಗಿದೆ, ವಿತರಣೆಯಾಗಿದೆ, ಓದಲಾಗಿದೆ ಅಥವಾ ವಿಫಲವಾಗಿದೆ | messageId, status, failureCode, occurredAt |
whatsapp.opted_out | ಸಂಖ್ಯೆಯು ನಿಮ್ಮ ಮಾರ್ಕೆಟಿಂಗ್ ಸಂದೇಶಗಳ ಚಂದಾ ರದ್ದು ಮಾಡಿದೆ | number, source: keyword, button ಅಥವಾ meta_131050, occurredAt |
whatsapp.opted_in | ಸಂಖ್ಯೆಯು ಮತ್ತೆ ಚಂದಾದಾರವಾಗಿದೆ | number, source: keyword ಅಥವಾ community_opt_in, occurredAt |
whatsapp.inbound | ಯಾರಾದರೂ ನಿಮ್ಮ ಸಂಖ್ಯೆಗೆ ಬರೆದಿದ್ದಾರೆ | from, messageId (WhatsAppನ ಸ್ವಂತ ಗುರುತು), type, text, receivedAt |
messageIdಕಳುಹಿಸುವ ಪ್ರತಿಕ್ರಿಯೆಯmsg_…ಗುರುತು;whatsapp.inboundಹೊರತು ಈವೆಂಟ್ ಅನ್ನು ಅದರ ಸಂದೇಶಕ್ಕೆ ಜೋಡಿಸಲು ಬಳಸಿ.metadataಪ್ರತಿ ಇಮೇಲ್, SMS ಮತ್ತು WhatsApp ಸಂದೇಶ ಈವೆಂಟ್ನಲ್ಲಿ ಕಳುಹಿಸುವಾಗ ನೀಡಿದ ಡೇಟಾ ಅಥವಾ{}ಆಗಿರುತ್ತದೆ: ಮೆಟಾಡೇಟಾ ನೋಡಿ. ಚಂದಾ ರದ್ದು, ಮರುಚಂದಾ ಮತ್ತುwhatsapp.inboundಇದನ್ನು ಹೊಂದಿರುವುದಿಲ್ಲ.- ಇಮೇಲ್ ಈವೆಂಟ್ಗಳು API ಮೂಲಕ ಕಳುಹಿಸಿದ ಇಮೇಲ್ಗಳಿಗೆ ಮಾತ್ರ, ಅಭಿಯಾನಗಳಿಗೆ ಅಲ್ಲ.
- ಇಮೇಲ್ನ
recipientsಈವೆಂಟ್ಗೆ ಸಂಬಂಧಿಸಿದ ಸ್ವೀಕರಿಸುವವರು; ಆದರೆemail.openedಮತ್ತುemail.clickedಎಲ್ಲಾ ವಿಳಾಸಗಳನ್ನು ಪಟ್ಟಿಮಾಡುತ್ತವೆ. ಯಾರು ತೆರೆದರು ಎಂದು ಇಮೇಲ್ ತಿಳಿಸುವುದಿಲ್ಲ. textಫೋಟೋ, ದಸ್ತಾವೇಜು ಅಥವಾ ಇತರ ಮಾಧ್ಯಮದwhatsapp.inboundನಲ್ಲಿ ಬಿಡಲಾಗುತ್ತದೆ.
ಈವೆಂಟ್ ರಚನೆ
ಪ್ರತಿ ವಿತರಣೆಯು JSON ಬಾಡಿಯಲ್ಲಿ ಒಂದು ಈವೆಂಟ್ ಹೊಂದಿರುವ POST ವಿನಂತಿಯಾಗಿದೆ.
ಈವೆಂಟ್ ಉದಾಹರಣೆ
{
"id": "evt_5d0b8e2f9c1a4d7e8b6f3a2c1d0e9f87",
"type": "email.bounced",
"createdAt": "2026-10-24T10:15:30.123456Z",
"account": { "id": "ORG000R7ZM4Q2VXH00" },
"data": {
"messageId": "msg_4f9c2a1e8b7d4c3f9e0a1b2c3d4e5f60",
"recipients": ["asha@example.org"],
"bounceType": "Permanent",
"bounceSubType": "General",
"metadata": { "orderId": "1042" }
}
}
idಈವೆಂಟ್ನ ಗುರುತು; ಅದರ ಎಲ್ಲ ವಿತರಣೆಗಳಲ್ಲಿ ಒಂದೇ ಆಗಿರುತ್ತದೆ. ಪುನರಾವರ್ತನೆ ನಿವಾರಣೆಗೆ ಇದನ್ನು ಬಳಸಿ.accountಸಂದೇಶದ ಸಂಸ್ಥೆ: ಅದರidಮತ್ತು ಉಪಖಾತೆಗಾಗಿ ನೀವು ನೀಡಿದexternalId.- ಮೌಲ್ಯವಿಲ್ಲದ ಕ್ಷೇತ್ರವನ್ನು ಬಿಡಲಾಗುತ್ತದೆ.
ವಿತರಣೆ ಪರಿಶೀಲಿಸಿ
ಪ್ರತಿ ವಿತರಣೆಯು ಸಹಿ ಮತ್ತು ಸಮಯಮಿತಿಯನ್ನು ಪರೀಕ್ಷಿಸಲು Oblic-Signature ಹೆಡರ್ ಹೊಂದಿದೆ. ಈವೆಂಟ್ನ id ಮೂಲಕವೂ ಪುನರಾವರ್ತನೆ ತಡೆಯಿರಿ: ಮಾನ್ಯ ಸಹಿ ವಿತರಣೆಯನ್ನು ಅನನ್ಯಗೊಳಿಸುವುದಿಲ್ಲ.
Oblic-Signature: t=1761300930,v1=5b3f…
tUnix ಸೆಕೆಂಡುಗಳಲ್ಲಿ ಸಹಿ ಮಾಡಿದ ಸಮಯ.v1ಎಂದರೆt, ಒಂದು ಚುಕ್ಕೆ ಮತ್ತು ಕಚ್ಚಾ ವಿನಂತಿ ಬಾಡಿಯ HMAC-SHA256. ಕೀಯಾಗಿ ಸಂಪೂರ್ಣ ಎಂಡ್ಪಾಯಿಂಟ್ ರಹಸ್ಯವನ್ನುwhsec_ಸಹಿತ ಬಳಸಿ, ಫಲಿತಾಂಶವನ್ನು ಸಣ್ಣಕ್ಷರದ ಹೆಕ್ಸಾಡೆಸಿಮಲ್ನಲ್ಲಿ ನೀಡಲಾಗುತ್ತದೆ.
JSON ಪಾರ್ಸ್ ಮಾಡುವ ಮೊದಲು ಸ್ವೀಕರಿಸಿದಂತೆಯೇ ಇರುವ ಬಾಡಿಯಿಂದ ಸಹಿ ಲೆಕ್ಕಿಸಿ, ಸ್ಥಿರ ಸಮಯದಲ್ಲಿ ಹೋಲಿಸಿ ಮತ್ತು ಈಗಿನ ಸಮಯದಿಂದ ಬಹಳ ದೂರದ t ತಿರಸ್ಕರಿಸಿ. ಹೆಡರ್ ಇಲ್ಲದಿದ್ದರೆ ಅಥವಾ ತಪ್ಪಾಗಿದ್ದರೆ ಪರಿಶೀಲನೆ ವಿಫಲವೆಂದು ಪರಿಗಣಿಸಿ. ಪ್ರತಿ ಪ್ರಯತ್ನ ತನ್ನದೇ t ಜೊತೆಗೆ ಮತ್ತೆ ಸಹಿಯಾಗುತ್ತದೆ; ಹೀಗಾಗಿ ಐದು ನಿಮಿಷದ ಮಿತಿ ಮರುಪ್ರಯತ್ನಕ್ಕೂ ಅನ್ವಯಿಸುತ್ತದೆ.
ಸಹಿ ಪರಿಶೀಲಿಸಿ
import crypto from 'node:crypto'
// header: the Oblic-Signature header; body: the raw body as a string.
export function verified(header, body, secret) {
if (typeof header !== 'string') return false
const pairs = header.split(',').map((field) => field.split('='))
if (pairs.some(([name, ...value]) => !name || value.length !== 1)) return false
const fields = Object.fromEntries(pairs)
if (Object.keys(fields).length !== pairs.length) return false
const t = fields.t
const signature = fields.v1
if (!t || /[^0-9]/.test(t)) return false
if (signature?.length !== 64 || /[^0-9a-f]/.test(signature)) return false
if (Math.abs(Date.now() / 1000 - Number(t)) > 300) return false
const expected = crypto
.createHmac('sha256', secret)
.update(`${t}.${body}`)
.digest()
return crypto.timingSafeEqual(expected, Buffer.from(signature, 'hex'))
}
ಕೋಡ್ ಪರೀಕ್ಷಿಸಲು: ರಹಸ್ಯ whsec_test, t ಮೌಲ್ಯ 1700000000 ಮತ್ತು ಬಾಡಿ {"a":1} ಆಗಿದ್ದರೆ v1 ಮೌಲ್ಯ 38877139021993b830af32feea6e18a8da83eb2f6e49ee50bd9e4cf4ca4d3789 ಆಗಿದೆ.
ವಿತರಣೆಯು Content-Type: application/json; charset=utf-8 ಮತ್ತು User-Agent: Oblic-Webhooks/1 ಕೂಡ ಹೊಂದಿದೆ.
ವಿತರಣೆ ಮತ್ತು ಮರುಪ್ರಯತ್ನಗಳು
- 10 ಸೆಕೆಂಡುಗಳೊಳಗೆ ಯಾವುದೇ
2xxಪ್ರತಿಕ್ರಿಯೆ ನೀಡಿ, ನಂತರ ಕೆಲಸ ಮಾಡಿ. ಬೇರೆ ಉತ್ತರ, ಅನುಸರಿಸದ ಮರುನಿರ್ದೇಶನ ಅಥವಾ ಸಕಾಲದ ಉತ್ತರ ಇಲ್ಲದಿರುವುದು ಪ್ರಯತ್ನದ ವಿಫಲತೆ. - ವಿಫಲ ಪ್ರಯತ್ನ ಮತ್ತೆ ನಡೆಯುತ್ತದೆ: 30 ಸೆಕೆಂಡುಗಳ ಬಳಿಕ, ನಂತರ 1, 2, 4, 8, 16 ಮತ್ತು 32 ನಿಮಿಷಗಳ ಬಳಿಕ, ಬಳಿಕ ಪ್ರತಿ ಗಂಟೆಗೆ; ಸುಮಾರು ಎಂಟು ಗಂಟೆಗಳಲ್ಲಿ 15 ಪ್ರಯತ್ನಗಳು. ಕೊನೆಯದಾದ ಮೇಲೆ ವಿತರಣೆ ವಿಫಲವೆಂದು ಗುರುತಿಸಿ, ಮೊದಲ ಬಾರಿ ಸರದಿಗೆ ಸೇರಿಸಿದಾಗಿನಿಂದ ಒಂದು ವಾರ ಮತ್ತೆ ಕಳುಹಿಸಲು ಉಳಿಸಲಾಗುತ್ತದೆ.
- ಒಂದೇ ಈವೆಂಟ್ ಹಲವು ಬಾರಿ ಬರಬಹುದು, ಮರುಕಳುಹಿಕೆ ಅಥವಾ ಉತ್ತರ ಕಳೆದುಹೋದಾಗ; ಬರುವ ಕ್ರಮವೂ ಬದಲಾಗಬಹುದು.
idಮೂಲಕ ಪುನರಾವರ್ತನೆ ತಡೆಯಿರಿ ಮತ್ತು ಕ್ರಮಕ್ಕೆoccurredAtಅಥವಾcreatedAtಬಳಸಿ. - ಉಪಖಾತೆಯ ಈವೆಂಟ್ಗಳು ಅದರ ಸ್ವಂತ ಎಂಡ್ಪಾಯಿಂಟ್ ಇದ್ದರೆ ಅವಕ್ಕೆ, ಇಲ್ಲದಿದ್ದರೆ ಪೋಷಕ ಖಾತೆಗೆ ಹೋಗುತ್ತವೆ. ಒಂದನ್ನು ನೋಂದಾಯಿಸಿದ ತಕ್ಷಣ ಎಲ್ಲ ಈವೆಂಟ್ಗಳು ಅದರ ಸ್ವಂತ ಎಂಡ್ಪಾಯಿಂಟ್ಗಳಿಗೆ ಮಾತ್ರ ಹೋಗುತ್ತವೆ, ಆಯ್ದ ವಿಧಗಳು ಯಾವುದಾದರೂ ಇರಲಿ.
ಇವು ನಿಗದಿತ ವಿಳಂಬಗಳು, ಖಚಿತ ವಿತರಣಾ ಗಡುವುಗಳಲ್ಲ. ವಿತರಣಾ ವರ್ಕರ್ ಸಕ್ರಿಯವಾಗಿರಬೇಕು; ಸರದಿ ಅಥವಾ ನಿಧಾನ ಎಂಡ್ಪಾಯಿಂಟ್ ಒಂದು ಸುತ್ತನ್ನು ವಿಳಂಬಗೊಳಿಸಬಹುದು. ಮರುಕಳುಹಿಕೆ ಮೊದಲ ಸರದಿ ಪ್ರವೇಶದಿಂದ ಲೆಕ್ಕಿಸುವ ಏಳು ದಿನಗಳ ಉಳಿಕೆಯನ್ನು ವಿಸ್ತರಿಸುವುದಿಲ್ಲ.
ವಿಫಲ ವಿತರಣೆಗಳು
ವಿಫಲ ವಿತರಣೆಗಳು, ಇತ್ತೀಚಿನ ವೈಫಲ್ಯ ಮೊದಲು, ಒಂದೊಂದು ಪುಟವಾಗಿ.
- ಹೆಸರು
webhookId- ಟೈಪ್ ಮಾಡಿ
- string
- ವಿವರಣೆ
ಈ ಎಂಡ್ಪಾಯಿಂಟ್ನ ವಿತರಣೆಗಳು ಮಾತ್ರ.
- ಹೆಸರು
limit- ಟೈಪ್ ಮಾಡಿ
- integer
- ವಿವರಣೆ
ಸಂಖ್ಯೆ 1 ರಿಂದ 100; ಪೂರ್ವನಿಯೋಜಿತ 25.
- ಹೆಸರು
cursor- ಟೈಪ್ ಮಾಡಿ
- string
- ವಿವರಣೆ
ಹಿಂದಿನ ಪುಟದ
next. ಪುಟವಿಂಗಡಣೆ ನೋಡಿ.
ಪ್ರತಿಕ್ರಿಯೆ
{
"status": "success",
"data": {
"deliveries": [
{
"id": 48213,
"webhookId": "whk_0c6f1e2d3b4a59687766554433221100",
"status": "failed",
"attempts": 15,
"lastError": "HTTP 503",
"createdAt": "2026-10-23T22:01:04Z",
"deliveredAt": null,
"failedAt": "2026-10-24T06:09:51Z",
"event": { "id": "evt_5d0b8e2f9c1a4d7e8b6f3a2c1d0e9f87", "type": "email.bounced", "createdAt": "2026-10-23T22:01:04.512310Z", "account": { "id": "ORG000R7ZM4Q2VXH00" }, "data": { "messageId": "msg_4f9c2a1e8b7d4c3f9e0a1b2c3d4e5f60", "recipients": ["asha@example.org"], "bounceType": "Permanent", "bounceSubType": "General" } }
}
],
"next": null
},
"errors": null
}
lastError ಕೊನೆಯ ವೈಫಲ್ಯ ಹೇಳುತ್ತದೆ: HTTP ಮತ್ತು ಪ್ರತಿಕ್ರಿಯೆಯ ಸ್ಥಿತಿ, ಸಾರ್ವಜನಿಕವಲ್ಲದ ವಿಳಾಸಕ್ಕೆ refused url, ಅಥವಾ ಸಂಪರ್ಕ ನಿಲ್ಲಿಸಿದ ದೋಷ.
ವಿತರಣೆಯನ್ನು ಮತ್ತೆ ಕಳುಹಿಸಿ
ವಿಫಲ ವಿತರಣೆಯನ್ನು ಮತ್ತೆ ಸರದಿಗೆ ಸೇರಿಸುತ್ತದೆ: 202, ಸ್ಥಿತಿ pending. ಅದೇ ಈವೆಂಟ್ ಮತ್ತು ಅದರ id ಸುಮಾರು ಒಂದು ನಿಮಿಷದಲ್ಲಿ ಹೊಸ ಸಹಿಯೊಂದಿಗೆ POST ಆಗುತ್ತವೆ ಮತ್ತು ಪ್ರಯತ್ನಗಳ ಎಣಿಕೆ ಮತ್ತೆ ಆರಂಭವಾಗುತ್ತದೆ.
| ತಿರಸ್ಕಾರ | cd | ಷರತ್ತು |
|---|---|---|
| 404 | DELIVERY_NOT_FOUND | ಸಂಸ್ಥೆಗೆ ಇಂತಹ ವಿತರಣೆ ಇಲ್ಲ |
| 409 | DELIVERY_NOT_FAILED | ವಿತರಣೆ ಬಾಕಿ ಇದೆ ಅಥವಾ ಈಗಾಗಲೇ ವಿತರಣೆಯಾಗಿದೆ |
| 409 | WEBHOOK_NOT_FOUND | ಎಂಡ್ಪಾಯಿಂಟ್ ಅಳಿಸಲಾಗಿದೆ; ಗುರಿ ಇಲ್ಲ |
ಎಂಡ್ಪಾಯಿಂಟ್ಗಳನ್ನು ನಿರ್ವಹಿಸಿ
| ವಿಧಾನ | ಮಾರ್ಗ | ಕಾರ್ಯ |
|---|---|---|
GET | /external/v1/webhooks | ಸಂಸ್ಥೆಯ ಎಂಡ್ಪಾಯಿಂಟ್ಗಳು ಮತ್ತು ಅವುಗಳ ರಹಸ್ಯಗಳು |
GET | /external/v1/webhooks/{webhookId} | ಒಂದು ಎಂಡ್ಪಾಯಿಂಟ್ |
PUT | /external/v1/webhooks/{webhookId} | ನೋಂದಣಿಯಂತೆ ನೀಡಿದ url ಮತ್ತು eventTypes ಬದಲಿಸುತ್ತದೆ; ರಹಸ್ಯ ಹಾಗೆಯೇ ಉಳಿಯುತ್ತದೆ |
DELETE | /external/v1/webhooks/{webhookId} | ಅದರ ವಿತರಣೆಗಳನ್ನು ನಿಲ್ಲಿಸುತ್ತದೆ |
ಸಂಸ್ಥೆಗೆ ಸೇರದ ಎಂಡ್ಪಾಯಿಂಟ್ 404 WEBHOOK_NOT_FOUND ನೀಡುತ್ತದೆ; ಇನ್ನೊಂದರ URL ಬಳಸಿದರೆ 400 WEBHOOK_EXISTS ಸಿಗುತ್ತದೆ.