List a disk
Give the origin. d1sks fetches /.well-known/opendisk.json from it, checks it against OpenDisk 0.1, and lists it. One seeder key is one disk, whatever URL it was found at.
Before you list
- Write the descriptor, or by hand from the example below.
- Serve it at
https://your-disk.example/.well-known/opendisk.jsonasapplication/json, next torobots.txt. - Check it without listing, if you like.
- Rewrite it when a lease starts or ends; d1sks refetches every hour and skips an unchanged ETag.
{
"name": "spare drive, Lisbon",
"operator": "https://you.example/.well-known/openprofile.md",
"capacity": { "total_gib": 3726, "free_gib": 2210 },
"price": { "currency": "USD", "per_gib_month": 0.08, "max_gib": 2000, "max_days": 365 },
"location": { "countries": ["PT"] },
"accepts": { "visibility": ["private", "public"], "encrypted_only": false },
"proof": { "kinds": ["challenge", "probe"], "every_hours_min": 6 }
}Or from a terminal: curl -X POST https://d1sks.com/api/v1/disks -H 'content-type: application/json' -d '{"url":"https://your-disk.example"}'