冪等性

ステーキングリソース、リクエスト、トランザクションを作成する操作には、Idempotency-Keyヘッダーが必要です。論理的な操作ごとに、一意な255文字以内の空でない値を使用してください。

curl --request POST "https://api.staking.0xmakase.co.jp/v1/ethereum/stakes" \
  --header "Authorization: Bearer ${OMAKASE_API_KEY}" \
  --header "Content-Type: application/json" \
  --header "Idempotency-Key: ${IDEMPOTENCY_KEY}" \
  --data '{
    "network": "mainnet",
    "amountEth": 32,
    "withdrawalAddress": "0x000000000000000000000000000000000000dEaD"
  }'

同じ論理的な操作を再試行する場合は、同じキーと同じリクエストを送信します。同じキーを異なるリクエストで再利用すると、409 Conflictが返されます。

キーはアプリケーションで生成し、対応する操作とともに保存してください。複数の呼び出し元が同じ値を生成する可能性があるため、現在時刻だけからキーを生成しないでください。