Kairoi NPM | npm.io

kairoi — opportune webhooks

"kairoi", plural of kairos (καιρός) is an Ancient Greek word meaning the right, critical, or opportune moment.

When do you want to schedule webhooks?

every second?

kairoi every 1 second for 12 weeks PATCH https://api.example.com/ticker-price-cache

every month?

kairoi every 1 month for 12 months post https://admin.example.com/payroll

one time?

kairoi every 1 hour for 1 hour POST https://marketing.example.com/reply-mail

nonsensically never?

kairoi every 1 hour for 1 minute head https://example.com/dev/null

Getting it

npm i -g kairoi

Some people need to use sudo with -g

Time-as-a-Service

Everything has a right time.
To every thing a season.
With kairoi that time is now.
Or whenever you want it to be.
To the ancient Greeks, kairoi meant "the right times", or "the fated times".
But to you, kairoi means "Time-as-a-Service".

So when are the right times?

Big things have small beginnings

kairoi every 1 second for 12 weeks \ 
  post https://app.io/new-customers \
  --body={"action":"greet", "allow":"push,email,sms"}

Everything that has a beginning
Has an end

kairoi end abracadabraidentifier

What's that?

Just something from a film I liked

Getting it (again)

npm i -g kairoi

Some people need to use sudo with -g

Free API keys :zap: :key: :surfer:

Yep really.

To try out kairoi you can use the following free API keys: chronos or phanes

If kairoi is still useful to you once those quotas are exhausted, buy a key.

Authing In

If you want to change the key you use, Auth in.

kairoi auth
> Open this link in your browser: https://api.pocketwatch.xyz/
> Enter API key:

What do you support?

You can specify times as second, minute, hour, day, week or month. We accept get, head, post, put, patch for HTTP methods.

What kind of times?

A time for GET:

kairoi every 3 second for 9 days \
  post https://news.host.com/api/rebuild-leaders

a time for JSON POST:

kairoi every 1 second for 2 weeks \
  post https://app.co/new-churners \
  --body={action:"survey", allow:"email"}

a time for anything:

kairoi every 1 day for 15 weeks put https://blog.me.com \ 
  --body='reminder=homework&reminder=exercise' \ 
  --contentType='application/x-www-form-urlencoded'

and a time to be quiet. Shhhh: