KV

Returns the value and last update timestamp for a specific key

get/api/kv/{ns}/{id}/{key}

Request

  • Base URL: https://brewpage.app
  • URL: https://brewpage.app/api/kv/{ns}/{id}/{key}
  • Auth: one of:
    • none
    • API key in header X-Owner-Token
    • API key in header X-Password

Path parameters

nsstring required
idstring required
keystring required

Query parameters

pstring

Legacy-only query password; ignored for NEW publications. Programmatic access uses X-Password or the owner token.

Headers

X-Passwordstring

Access password via header

User-Agentstring
X-Owner-Tokenstring

Owner token to bypass password protection when no password supplied

Response

Key value

valuestring required
updatedAtstring date-time required

When the value was last written or updated

expiresAtstring date-time required

When the value expires

viewsinteger required

Total number of reads for this key (post-increment)

Changes

    • breaking

      removed the media type */* for the response with the status

    • breaking

      removed the media type */* for the response with the status

    • breaking

      removed the media type */* for the response with the status

    • info

      the endpoint scheme security OwnerToken was added to the API

    • info

      the endpoint scheme security Password was added to the API

    • info

      added the media type application/json for the response with the status

    • info

      added the media type application/json for the response with the status

    • info

      added the media type application/json for the response with the status