CloudState is a distributed state management system as a key-value store on HTTP.
This is the documentation for version 0.1.9
of the API. Last update on Jun 6, 2022.
https://c9db.io
CloudState is a distributed state management system as a key-value store on HTTP.
This is the documentation for version 0.1.9
of the API. Last update on Jun 6, 2022.
https://c9db.io
The verification token is sent to the e-mail address provided in the request.
The e-mail address is not verified at the time of the bucket creation. However, if you fail to verify the e-mail address within 14 days, the bucket data will be transitioned to archival state. To verify the e-mail address, please log in through usecloudstate.io, or use this API.
curl \
-X POST https://c9db.io/bucket_owner/verification_token_request \
-H "Content-Type: application/json" \
-d '{"email":"string"}'
{
"email": "string"
}
Using the token received, the e-mail address is verified.
The e-mail address is verified. The returned access_token is valid for 30 minutes.
curl \
-X POST https://c9db.io/bucket_owner/verification_token_verify \
-H "Content-Type: application/json" \
-d '{"email":"string","token":"string"}'
{
"email": "string",
"token": "string"
}
{
"access_token": "string"
}
curl \
-X GET https://c9db.io/bucket_owner/buckets \
-H "Authorization: string"
[
{
"bucket_id": "string",
"read_key": "string",
"write_key": "string",
"admin_key": "string"
}
]
The e-mail address is not verified at the time of the bucket creation. However, if you fail to verify the e-mail address within 14 days, the bucket data will be transitioned to archival state. To verify the e-mail address, please log in through usecloudstate.io.
curl \
-X POST https://c9db.io/buckets \
-H "Content-Type: application/json" \
-d '{"email":"string"}'
{
"email": "string"
}
{
"bucket_id": "string",
"read_key": "string",
"write_key": "string",
"admin_key": "string"
}
The value is read from the bucket for the key. If the key does not exist, the call will return a 404.
The read_key
is required to read a value from a bucket. If the read key is not provided, the call will be rejected.
curl \
-X GET https://c9db.io/buckets/{bucket_id}/keys/{id}
The value is stored in the bucket for the key. If the key already exists, the value is overwritten.
The write_key
` is required to write a value to a bucket. If the write key is not provided, the call will be rejected.
The consistency level of the write. Evenutal writes complete the HTTP requests faster, but may not be consistent with other writes. Strong writes are slower, but are guaranteed to be consistent with other writes. Default is strong
.
Values are eventual
or strong
.
curl \
-X POST https://c9db.io/buckets/{bucket_id}/keys/{id} \
-H "Content-Type: text/plain" \
-d '"string"'
"string"