거래 일정

List all schedules for a preparation

get
Path parameters
idstringRequired

Preparation ID or name

Responses
200
OK
application/json
get
GET /api/preparation/{id}/schedules HTTP/1.1
Host: localhost:9090
Accept: */*
[
  {
    "allowedPieceCids": [
      "text"
    ],
    "announceToIpni": true,
    "createdAt": "text",
    "duration": 1,
    "errorMessage": "text",
    "force": true,
    "httpHeaders": {
      "ANY_ADDITIONAL_PROPERTY": "text"
    },
    "id": 1,
    "keepUnsealed": true,
    "maxPendingDealNumber": 1,
    "maxPendingDealSize": 1,
    "notes": "text",
    "preparationId": 1,
    "pricePerDeal": 1,
    "pricePerGb": 1,
    "pricePerGbEpoch": 1,
    "provider": "text",
    "scheduleCron": "text",
    "scheduleCronPerpetual": true,
    "scheduleDealNumber": 1,
    "scheduleDealSize": 1,
    "startDelay": 1,
    "state": "active",
    "totalDealNumber": 1,
    "totalDealSize": 1,
    "updatedAt": "text",
    "urlTemplate": "text",
    "verified": true
  }
]

Create a new schedule

post

Create a new schedule

Body
allowedPieceCidsstring[]Optional

Allowed piece CIDs in this schedule

durationstringOptional

Duration in epoch or in duration format, i.e. 1500000, 2400h

Default: 12840h
forcebooleanOptional

Force to send out deals regardless of replication restriction

httpHeadersstring[]Optional

http headers to be passed with the request (i.e. key=value)

ipnibooleanOptional

Whether the deal should be IPNI

Default: true
keepUnsealedbooleanOptional

Whether the deal should be kept unsealed

Default: true
maxPendingDealNumberintegerOptional

Max pending deal number

maxPendingDealSizestringOptional

Max pending deal size in human readable format, i.e. 100 TiB

notesstringOptional

Notes

preparationstringOptional

Preparation ID or name

pricePerDealnumberOptional

Price in FIL per deal

Default: 0
pricePerGbnumberOptional

Price in FIL per GiB

Default: 0
pricePerGbEpochnumberOptional

Price in FIL per GiB per epoch

Default: 0
providerstringOptional

Provider

scheduleCronstringOptional

Schedule cron pattern

scheduleCronPerpetualbooleanOptional

Whether a cron schedule should run in definitely

scheduleDealNumberintegerOptional

Number of deals per scheduled time

scheduleDealSizestringOptional

Size of deals per schedule trigger in human readable format, i.e. 100 TiB

startDelaystringOptional

Deal start delay in epoch or in duration format, i.e. 1000, 72h

Default: 72h
totalDealNumberintegerOptional

Total number of deals

totalDealSizestringOptional

Total size of deals in human readable format, i.e. 100 TiB

urlTemplatestringOptional

URL template with PIECE_CID placeholder for boost to fetch the CAR file, i.e. http://127.0.0.1/piece/{PIECE_CID}.car

verifiedbooleanOptional

Whether the deal should be verified

Default: true
Responses
200
OK
application/json
post
POST /api/schedule HTTP/1.1
Host: localhost:9090
Content-Type: application/json
Accept: */*
Content-Length: 475

{
  "allowedPieceCids": [
    "text"
  ],
  "duration": "12840h",
  "force": true,
  "httpHeaders": [
    "text"
  ],
  "ipni": true,
  "keepUnsealed": true,
  "maxPendingDealNumber": 1,
  "maxPendingDealSize": "text",
  "notes": "text",
  "preparation": "text",
  "pricePerDeal": 0,
  "pricePerGb": 0,
  "pricePerGbEpoch": 0,
  "provider": "text",
  "scheduleCron": "text",
  "scheduleCronPerpetual": true,
  "scheduleDealNumber": 1,
  "scheduleDealSize": "text",
  "startDelay": "72h",
  "totalDealNumber": 1,
  "totalDealSize": "text",
  "urlTemplate": "text",
  "verified": true
}
{
  "allowedPieceCids": [
    "text"
  ],
  "announceToIpni": true,
  "createdAt": "text",
  "duration": 1,
  "errorMessage": "text",
  "force": true,
  "httpHeaders": {
    "ANY_ADDITIONAL_PROPERTY": "text"
  },
  "id": 1,
  "keepUnsealed": true,
  "maxPendingDealNumber": 1,
  "maxPendingDealSize": 1,
  "notes": "text",
  "preparationId": 1,
  "pricePerDeal": 1,
  "pricePerGb": 1,
  "pricePerGbEpoch": 1,
  "provider": "text",
  "scheduleCron": "text",
  "scheduleCronPerpetual": true,
  "scheduleDealNumber": 1,
  "scheduleDealSize": 1,
  "startDelay": 1,
  "state": "active",
  "totalDealNumber": 1,
  "totalDealSize": 1,
  "updatedAt": "text",
  "urlTemplate": "text",
  "verified": true
}

Pause a specific schedule

post
Path parameters
idintegerRequired

Schedule ID

Responses
200
OK
application/json
post
POST /api/schedule/{id}/pause HTTP/1.1
Host: localhost:9090
Accept: */*
{
  "allowedPieceCids": [
    "text"
  ],
  "announceToIpni": true,
  "createdAt": "text",
  "duration": 1,
  "errorMessage": "text",
  "force": true,
  "httpHeaders": {
    "ANY_ADDITIONAL_PROPERTY": "text"
  },
  "id": 1,
  "keepUnsealed": true,
  "maxPendingDealNumber": 1,
  "maxPendingDealSize": 1,
  "notes": "text",
  "preparationId": 1,
  "pricePerDeal": 1,
  "pricePerGb": 1,
  "pricePerGbEpoch": 1,
  "provider": "text",
  "scheduleCron": "text",
  "scheduleCronPerpetual": true,
  "scheduleDealNumber": 1,
  "scheduleDealSize": 1,
  "startDelay": 1,
  "state": "active",
  "totalDealNumber": 1,
  "totalDealSize": 1,
  "updatedAt": "text",
  "urlTemplate": "text",
  "verified": true
}

Resume a specific schedule

post
Path parameters
idintegerRequired

Schedule ID

Responses
200
OK
application/json
post
POST /api/schedule/{id}/resume HTTP/1.1
Host: localhost:9090
Accept: */*
{
  "allowedPieceCids": [
    "text"
  ],
  "announceToIpni": true,
  "createdAt": "text",
  "duration": 1,
  "errorMessage": "text",
  "force": true,
  "httpHeaders": {
    "ANY_ADDITIONAL_PROPERTY": "text"
  },
  "id": 1,
  "keepUnsealed": true,
  "maxPendingDealNumber": 1,
  "maxPendingDealSize": 1,
  "notes": "text",
  "preparationId": 1,
  "pricePerDeal": 1,
  "pricePerGb": 1,
  "pricePerGbEpoch": 1,
  "provider": "text",
  "scheduleCron": "text",
  "scheduleCronPerpetual": true,
  "scheduleDealNumber": 1,
  "scheduleDealSize": 1,
  "startDelay": 1,
  "state": "active",
  "totalDealNumber": 1,
  "totalDealSize": 1,
  "updatedAt": "text",
  "urlTemplate": "text",
  "verified": true
}

Last updated

Was this helpful?