Skip to main content
POST
スケジュール作成

承認

Authorization
string
header
必須

Bearer認証ヘッダーの形式はBearer で、はあなたの認証トークンです。

ボディ

application/json
method
enum<string>
必須

スケジュールされた API コールの HTTP メソッド。GET または POST のいずれかでなければなりません。

利用可能なオプション:
GET,
POST
endpoint
string
必須

スケジュールが実行されるときに呼び出されるエンドポイント URL。Olostep エンドポイントを使用した POST リクエストの場合、短縮形(例: 'v1/scrapes', 'v1/batches', 'v1/crawls', 'v1/maps', 'v1/answers')を使用することができ、自動的に 'https://api.olostep.com/' がプレフィックスされます。他のエンドポイントの場合は、完全な URL を提供してください。

payload
object

API コールと共に送信するペイロード。必要な任意の JSON 構造を含めることができます。GET リクエストの場合、通常は空です。POST リクエストの場合、エンドポイントに送信したいデータを含める必要があります。

cron_expression
string

定期的なスケジュールのための 6 フィールド形式(分 時間 日 月 曜日 年)の cron 式。定期的なスケジュールには必須です。execute_at および text とは相互排他的です。

execute_at
string<date-time>

一度きりのスケジュール実行のための ISO 8601 日時文字列。有効な未来の日時でなければなりません。一度きりのスケジュールには必須です。cron_expression とは相互排他的です。

expression_timezone
string

スケジュールのための IANA タイムゾーン識別子(例: 'UTC', 'America/New_York', 'Europe/London')。定期的なスケジュールには必須で、一度きりのスケジュールにはオプションです。自然言語テキストを使用する場合、デフォルトは 'UTC' です。

text
string

自動的に cron 式を生成するための自然言語テキスト。システムはあなたのテキストを有効な cron 式に変換します。例: 'every 3 minutes', 'every day at 10am', 'every Monday at 9am'。cron_expression および execute_at とは相互排他的です。使用する場合、expression_timezone のデフォルトは 'UTC' です。

レスポンス

スケジュールが正常に作成されました。

id
string

ユニークなスケジュール識別子

type
enum<string>

スケジュールのタイプ: cron ベースのスケジュールには 'recurring'、単一実行スケジュールには 'onetime'

利用可能なオプション:
recurring,
onetime
method
enum<string>

スケジュールされたコールの HTTP メソッド

利用可能なオプション:
GET,
POST
endpoint
string

呼び出されるエンドポイント URL

cron_expression
string

Cron 式(定期的なスケジュールの場合のみ存在)

execute_at
string<date-time>

実行日時(一度きりのスケジュールの場合のみ存在)

expression_timezone
string

スケジュールのタイムゾーン

created
string<date-time>

スケジュールが作成された ISO 8601 日時