Webhook
ãã®ããŒãžã®å 容
Settings â Developers â WebhooksïŒèšå® â éçºè â WebhookïŒã§ãšã³ããã€ã³ãã远å ããŸãïŒãªãŒããŒãšç®¡çè ïŒãå ¬éãããŠãã HTTPS ã¢ãã¬ã¹ã§ããå¿ èŠããããŸããåãåãã€ãã³ããéžã³ãŸããAll events ããªã³ã®ãŸãŸã«ããïŒä»åŸ Pellio ã«è¿œå ãããã€ãã³ããå«ã¿ãŸãïŒãããªãã«ããŠå¿ èŠãªã€ãã³ããéžã³ãŸãããšã³ããã€ã³ãã®çœ²åã·ãŒã¯ã¬ããã¯äžåºŠã ã衚瀺ãããŸãã
åãšã³ããã€ã³ãã«ã¯ãåãåãã€ãã³ããšæ¬¡ã®æäœã衚瀺ãããŸãã
- Edit eventsïŒåãåãã€ãã³ãã倿ŽããŸããSave events ã§å€æŽãããã«é©çšãããŸãã
- Send testïŒåãåãã€ãã³ãã«é¢ä¿ãªãããã®ãšã³ããã€ã³ãã«
webhook.testã€ãã³ããéä¿¡ããŸãã - DeliveriesïŒçŽè¿50åã®éä¿¡ïŒä¿çäžãé ä¿¡æžã¿ã倱æïŒãšãã®ã¬ã¹ãã³ã¹ã衚瀺ããŸãã
- Rotate secretïŒçœ²åã·ãŒã¯ã¬ãããæ°ããããŸããæ°ããã·ãŒã¯ã¬ããã¯äžåºŠã ã衚瀺ãããå€ããã®ã¯ããã«äœ¿ããªããªãããããšã³ããã€ã³ããããã«æŽæ°ããŠãã ããã
- RemoveïŒãšã³ããã€ã³ããžã®éä¿¡ã忢ããŸãã
API ã®å ŽåïŒPOST /v1/webhooks 㯠url ãš eventsïŒç©ºã®ãªã¹ãã¯ãã¹ãŠã®ã€ãã³ãïŒãåãåããPATCH /v1/webhooks/{id} 㯠events ã倿ŽããPOST /v1/webhooks/{id}/rotate-secret ã¯æ°ãã secret ãè¿ããŸãã
ã€ãã³ã
ãªã¯ãšã¹ãããã£ã¯ãã¹ãŠ { "id", "event", "createdAt", "data" } ã§ãã
| ã€ãã³ã | ã¿ã€ãã³ã° | data |
|---|---|---|
video.created |
ã¢ããããŒããé²ç»ãURL ããã®ã€ã³ããŒãã§åç»ãäœæããããšãã | idãtitle |
video.ready |
åç»ã®åŠçãçµãã£ããšãïŒå·®ãæ¿ããããªãã³ã°ã®åŸãå«ãïŒã | idãtitleãstatusãversionãdurationSecondsãwidthãheightãerrorMessage |
video.failed |
æ°ããåç»ãåŠçã§ããªãã£ããšãã | video.ready ãšåã |
video.deleted |
åç»ããŽãç®±ã«ç§»åããããšãïŒtrashed: trueïŒããŸãã¯å®å
šã«åé€ããããšãã |
idãtitleãtrashed |
video.watched |
è奿žã¿ã®èŠèŽè
ïŒã¡ãŒã«ãã©ãŒã ã?email= ãªã³ã¯ããŸã㯠WordPress ãµã€ãããïŒãåç»ã®åçãéå§ãããšãã25ïŒ
ã50ïŒ
ã75ïŒ
ãè¶
ãããšããèŠèŽãå®äºãããšãïŒèšªåããŸããã§90ïŒ
èŠèŽïŒãèŠèŽè
ãåç»ããã€ã«ã¹ããŒã³ããšã«1åã |
videoïŒidãtitleïŒãviewerïŒemailãnameïŒãprogressïŒ0ã25ã50ã75ã100ïŒãmilestoneïŒstartedã25%ã50%ã75%ãcompletedïŒãcompleted |
lead.captured |
誰ããã¡ãŒã«ãã©ãŒã ãéä¿¡ãããšãã | idãemailãnameãfieldsãvideoïŒidãtitleïŒãcreatedAt |
é ä¿¡
Pellio 㯠User-Agent: Pellio-Webhooks/1 ããããŒä»ãã§ POST ãéä¿¡ããæå€§10ç§åŸ
ã¡ãŸãã2xx ã®ã¬ã¹ãã³ã¹ã¯ãã¹ãŠé
ä¿¡æåãšã¿ãªããŸãããªãã€ã¬ã¯ãã¯ãã©ããªãããã3xx ã¯å€±æã«ãªããŸãã倱æããé
ä¿¡ã¯åèš6å詊è¡ãããæåã®å詊è¡ãŸã§ã¯20ç§åŸ
ã¡ããã®åŸã¯åŸ
ã¡æéãåã«ããŠæå€§320ç§ãŸã§å»¶ã°ããŸãã
眲åã®æ€èšŒ
åãªã¯ãšã¹ãã«ã¯ Pellio-Signature ããããŒãä»ããŸãã圢åŒã¯ t=<unix time>,v1=<hex HMAC-SHA256 of "t.body"> ã§ããšã³ããã€ã³ãã®ã·ãŒã¯ã¬ããã䜿ããŸããçã®ãªã¯ãšã¹ãããã£ã«å¯ŸããŠæ€èšŒããŠãã ããã
import { createHmac, timingSafeEqual } from 'node:crypto';
function verify(header, rawBody, secret) {
const { t, v1 } = Object.fromEntries(header.split(',').map((p) => p.split('=')));
if (Math.abs(Date.now() / 1000 - Number(t)) > 300) return false; // 5-minute tolerance
const expected = createHmac('sha256', secret).update(`${t}.${rawBody}`).digest('hex');
return timingSafeEqual(Buffer.from(expected), Buffer.from(v1));
}
ãã®èšäºã¯åœ¹ã«ç«ã¡ãŸãããïŒ
é¢é£èšäº
- API keys and the REST APIAuthenticate, upload and manage videos from your own code.
- ãã¬ãŒã€ãŒAPIpostMessageãŸã㯠Webã³ã³ããŒãã³ãã§ããã¬ãŒã€ãŒãæäœããã€ãã³ããåãåããŸãã
- AIã¢ã·ã¹ã¿ã³ãïŒMCPïŒPellioã®MCPãµãŒããŒã§ãClaudeãChatGPTãCursorãClaude CodeãPellioã«æ¥ç¶ããŸãã
- WordPress pluginA fast, private video player for any WordPress site, and Pellio hosting when you connect an account.