REST API

cron ジョブを JSON でプログラムから管理。

認証

アカウント › API キーでキーを作成し、Authorization: Bearer ヘッダー(または X-API-Key)で送信してください。

curl -H "Authorization: Bearer 7c_xxxxxxxx…" https://7cron.com/api/v1/me

上限:毎分 120 リクエスト。日時は UTC(ISO 8601)。プランによっては API アクセスがオプションです。

エンドポイント

GET /meアカウントと上限
GET /jobsジョブ一覧
POST /jobsジョブを作成(HTTP またはハートビート)
GET /jobs/{id}ジョブの詳細
PATCH /jobs/{id}ジョブを編集(送信したフィールドのみ)
DELETE /jobs/{id}ジョブと履歴を削除
POST /jobs/{id}/runHTTP ジョブを今すぐ実行
POST /jobs/{id}/pauseジョブを一時停止
POST /jobs/{id}/resumeジョブを再開
GET /jobs/{id}/logs?limit=50最近の実行(最大 500 件)

Base URL : https://7cron.com/api/v1

例とフィールド

Web フォームと同じフィールドとルール:

curl -X POST https://7cron.com/api/v1/jobs \
  -H "Authorization: Bearer 7c_xxxxxxxx…" -H "Content-Type: application/json" \
  -d '{"name":"Nightly backup","url":"https://example.com/cron/backup",
       "method":"POST","cron_expr":"0 3 * * *","timezone":"Europe/Zurich",
       "timeout":30,"retries":1,"alert_threshold":3,"success_keyword":"OK"}'

# Heartbeat
curl -X POST https://7cron.com/api/v1/jobs -H "Authorization: Bearer 7c_…" -H "Content-Type: application/json" \
  -d '{"type":"heartbeat","name":"Backup script","hb_period_min":1440,"hb_grace_min":30}'

type, name, url, method, headers, body, cron_expr, timezone, timeout, enabled, notify_on_failure, notify_chat, alert_threshold, webhook_url, success_keyword, keyword_mode (contains|absent), retries, hb_period_min, hb_grace_min, on_status_page

エラー

{"error": {"code": 422, "message": "Validation failed.", "fields": {"cron_expr": "…"}}}

コード:400 JSON 不正、401 キーなし、403 権限なし、404 見つからない、405 メソッド、422 検証エラー、429 レート制限。