Utilities

GET /version

Platform version.

Help us improve

Did you spot an error? Or maybe you just have a suggestion for how we can improve? Leave us a comment.

Request

GET /api/2/version

Example request

cURL
curl https://login.schibsted.com/api/2/version -G
Java
SpidOAuthToken token = spidClient.getServerToken();
String responseJSON = spidClient.
    GET(token, "/version").
    getResponseBody();

This example is an excerpt, see a full example

PHP
<?php
$client->auth();
echo var_dump($client->api("/version"));

This example is an excerpt, see a full example

Clojure
(ns example
  (:require [spid-client-clojure.core :as spid]))

(let [client (spid/create-client "[client-id]" "[secret]")
      token (spid/create-server-token client)]
  (spid/GET client token "/version"))

Response

This endpoint supports the JSON and JSON-P response formats.

Success: 200 OK

Returns a description of the currently deployed SPiD version

Version object

apiVersion

integer

API major version. 2

apiRevision

string

Always 0 in production

webVersion

string

Full API version, currently 2.14.0

webRevision

string

Always 0 in production

currentTime

datetime

timeZone

string

The check mark indicates that the field always contains a valid non-empty value.

Failure cases

Some HTTP response codes are used for multiple error situations. There is no consistent way to tell these apart, but the error object will contain a textual explanation of the reason for the error. For explanation on OAuth related failures and errors see OAuth authentication failures.

  • 401 Unauthorized You don't have administration rights for this client.
  • 401 Unauthorized Your client doesn't have administration rights for this client.
  • 403 Forbidden Client is not authorized to access this API endpoint. Contact SPiD to request access.
  • 403 Forbidden Requesting IP is not whitelisted
  • 404 Not Found Unknown client ID
  • 404 Not Found Client ID mismatch. The client making the request is no the owner of this resource, and does not have administrative privileges for it.
  • 420 Request Ratelimit exceeded

Sample response

JSON
{
  "apiVersion": 2,
  "apiRevision": "0",
  "webVersion": "2.14.0",
  "webRevision": "47d6ba5",
  "currentTime": "2014-04-15 13:33:39",
  "timeZone": "Europe/Oslo"
}
JSON-P
callback({
  "apiVersion": 2,
  "apiRevision": "0",
  "webVersion": "2.14.0",
  "webRevision": "47d6ba5",
  "currentTime": "2014-04-15 13:33:39",
  "timeZone": "Europe/Oslo"
});

Comments/feedback

Do you have questions, or just want to contribute some newly gained insight? Want to share an example? Please leave a comment. SPiD reads and responds to every question. Additionally, your experience can help others using SPiD, and it can help us continuously improve our documentation.