Other operations

Operations

GET

/{yourBaseUrl}/{key}

When a cache-miss for this key + record-type occurs, TCS makes a HTTP GET request to your backing-store to retrieve the said key.

⚠️ Any other response status (e.g. 400) will be treated as an unexpected error, map to a 500 status-code returned to TCS clients. Our 5xx alert thresholds are high (service-descriptor.sd.yml, but may eventually fire. We expect backing store providers to monitor their TCS endpoints.

Request

This request has no parameters.

Responses

(OK) - Content exists for <key>, JSON returned in body should be cached. The JSON object that will be returned in the body of the response.


1
2
3
4
5
6
7
8
HTTP/1.1 200 OK
Last-Modified: Tue, 15 Nov 1994 12:45:26 GMT
Content-Type: application/json
version: 101

{
  "some-json": "value"
}

Headers

Content-Type

string

Last-Modified

string

version

integer

application/json

any

GET/yourBaseUrl/<key>

curl

Node.js

Java

Python

PHP

1
2
3

curl --request GET \
  --url '/v2/yourBaseUrl/<key>' \
  --header 'Accept: application/json'

200Response

1
2
3

{
  "some-json": "value"
}