mirror of https://github.com/perkeep/perkeep.git
65 lines
1.8 KiB
Markdown
65 lines
1.8 KiB
Markdown
# Discovery
|
|
|
|
Discovery is the process of asking the server for its configuration.
|
|
|
|
You send the discovery HTTP request to the URL the user has
|
|
configured. If the user hasn't specified a path, use "/".
|
|
|
|
Then make a GET request to that URL with either Accept header set to
|
|
"text/x-camli-configuration" or the the URL query parameter
|
|
"camli.mode" set to "config":
|
|
|
|
GET /some/user/?camli.mode=config HTTP/1.1
|
|
Host: camlihost.example.com
|
|
|
|
Or:
|
|
|
|
GET / HTTP1.1
|
|
Host: 127.0.0.1
|
|
Accept: text/x-camli-configuration
|
|
|
|
The response is a JSON document:
|
|
|
|
{
|
|
"blobHashFuncs": [
|
|
"sha1"
|
|
],
|
|
"blobRoot": "/bs-and-maybe-also-index/",
|
|
"directoryHelper": "/ui/tree/",
|
|
"downloadHelper": "/ui/download/",
|
|
"helpRoot": "/help/",
|
|
"importerRoot": "/importer/",
|
|
"jsonSignRoot": "/sighelper/",
|
|
"ownerName": "The User Name",
|
|
"publishRoots": {},
|
|
"searchRoot": "/my-search/",
|
|
"signing": {
|
|
"publicKey": "/sighelper/camli/sha1-f72d9090b61b70ee6501cceacc9d81a0801d32f6",
|
|
"publicKeyBlobRef": "sha1-f72d9090b61b70ee6501cceacc9d81a0801d32f6",
|
|
"publicKeyId": "94DE83C46401800C",
|
|
"signHandler": "/sighelper/camli/sig/sign",
|
|
"verifyHandler": "/sighelper/camli/sig/verify"
|
|
},
|
|
"statusRoot": "/status/",
|
|
"storageGeneration": "231ceff7a04a77cdf881b0422ea733334eee3b8f",
|
|
"storageInitTime": "2012-11-30T03:34:47Z",
|
|
"syncHandlers": [
|
|
{
|
|
"from": "/bs/",
|
|
"to": "/index-mysql/",
|
|
"toIndex": true
|
|
},
|
|
{
|
|
"from": "/bs/",
|
|
"to": "/sto-s3/",
|
|
"toIndex": false
|
|
}
|
|
],
|
|
"thumbVersion": "2",
|
|
"uiRoot": "/ui/",
|
|
"uploadHelper": "/ui/?camli.mode=uploadhelper",
|
|
"wsAuthToken": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
|
|
}
|
|
|
|
TODO: document these more
|