How to start?

SVP API is an interface for Schibsted Video Platform. It contains data for all Schibsted companies.

To distinguish the companies, it's required to use special URL parameter, called provider. So whenever you want to get data from VGTV company, you must replace provider parameter by vgtv in a URL. If you want to change a company that provides you data, you need to change provider parameter accordingly.

Second required parameter, called appName, you have to specify in a query string. This parameter should contain your application name, which in addition suppose to be unique.

An Accept header is not required. Although, Content-Type header is required for all HTTP methods except GET. Currently, the API accepts only application/json as a content type and always returns application/hal+json.

Authentication

At the moment authentication is enabled for all HTTP methods except GET!

To be able to authenticate correctly, it's required to send two additional headers: X-SvpApiAuth-PublicKey and X-SvpApiAuth-AccessToken.
The first one is a public key, which actually means your application name.
The second one in an access token, which needs to be generated that way:
$url = ''; // The whole URL, which you send your request to
/*
 * Remove the value of 'appName' query paramater using regular expression
 * Pattern: (\?|\&)(appName)\=([^&]+)
 * Replacement: $1$2
 * Example: http://domain.no/svp/api/end-point?appName=docs => http://domain.no/svp/api/end-point?appName
 */
$url = preg_replace('/(\?|\&)(appName)\=([^&]+)/', '$1$2', $url);
$method = 'POST'; // HTTP method
$privateKey = 'xxx'; // Your own private key
hash_hmac('sha256', $method . urldecode($url), $privateKey);
To avoid of generating the access token each time, you can use publicKey and privateKey fields (which are available on the top bar of this page).

Common Error Status Codes

HTTP Status Code Reason Solution
400 Query param :appName is empty or incorrect! Add a uuery param called :appName
401 Your public key is not permitted for specified provider! Change your public key, use proper provider or ask for permissions to another provider
403 Incorrect access token Check if your access token was generated in a proper way
403 Missing public key and/or access token To be able to use other methods than GET, you must specify public key and access token
405 Method Not Allowed Check if your URL is correct (especially if this is a resource or collection)
503 The request couldn't be serviced due to some failure within our stack. Try again later. An error occured on the system side, what should be fixed quickly

IMBO images

SVP API uses IMBO as a storage for images.

To use predefined transformations of images, which don't require an access token, supported key must be added to the end of the URL: e.g. http://imbo.vgtv.no/users/vgtv/images/7981319f96b70c84caaffc904f68839f?t[]=1280x720

List of currently supported dimensions:
KeyWidthHeightQuality
80q8080px80%
180q80180px80%
280q80280px80%
316q80316px80%
380q80380px80%
480q80480px80%
580q80580px80%
652q80652px80%
680q80680px80%
725q80725px80%
780q80780px80%
800q80800px80%
980q80980px80%
1024q801024px80%
1080q801080px80%
1205q801205px80%
1440q801440px80%
2048q802048px80%
KeyWidthHeightQuality
x50q8050px80%
x52q8052px80%
x75q8075px80%
x100q80100px80%
x104q50104px50%
x150q80150px80%
x360q80360px80%
KeyWidthHeightQuality
c900x52q8052px80%
c960x62q8062px80%
c930x1000q801000px80%
c960x1000q801000px80%
60x60q10060px60px100%
80x45q8080px45px80%
102x57q80102px57px80%
112x42q80112px42px80%
120x120q80120px120px80%
124x70q80124px70px80%
142x80q80142px80px80%
160x60q80160px60px80%
160x90q50160px90px50%
160x160q80160px160px80%
161x91q80161px91px80%
174x98q80174px98px80%
180x101q80180px101px80%
182x103q80182px103px80%
193x109q80193px109px80%
199x112q80199px112px80%
200x100q80200px100px80%
203x114q80203px114px80%
204x114q50204px114px50%
204x115q80204px115px80%
207x116q80207px116px80%
208x117q80208px117px80%
210x118q80210px118px80%
215x121q80215px121px80%
220x124q80220px124px80%
220x220q80220px220px80%
225x127q80225px127px80%
235x132q80235px132px80%
239x134q80239px134px80%
244x137q80244px137px80%
246x139q80246px139px80%
248x140q50248px140px50%
276x155q80276px155px80%
281x158q80281px158px80%
282x159q80282px159px80%
284x160q50284px160px50%
287x161q80287px161px80%
287x162q80287px162px80%
288x288q80288px288px80%
289x163q80289px163px80%
291x164q80291px164px80%
296x167q80296px167px80%
300x35q80300px35px80%
301x169q80301px169px80%
306x172q50306px172px50%
306x172q80306px172px80%
311x175q80311px175px80%
313x176q80313px176px80%
314x176q80314px176px80%
315x177q80315px177px80%
317x178q80317px178px80%
320x120q80320px120px80%
320x180q80320px180px80%
320x320q50320px320px50%
322x182q50322px182px50%
338x190q80338px190px80%
344x40q80344px40px80%
348x196q50348px196px50%
359x202q80359px202px80%
360x202q50360px202px50%
364x205q80364px205px80%
364x206q50364px206px50%
370x150q80370px150px80%
382x215q80382px215px80%
384x216q80384px216px80%
386x218q50386px218px50%
398x224q50398px224px50%
400x200q50400px200px50%
406x228q50406px228px50%
408x230q50408px230px50%
414x232q50414px232px50%
416x234q50416px234px50%
420x236q50420px236px50%
421x237q80421px237px80%
427x240q80427px240px80%
430x242q50430px242px50%
440x248q50440px248px50%
440x248q80440px248px80%
440x440q50440px440px50%
442x249q80442px249px80%
443x249q80443px249px80%
450x254q50450px254px50%
452x254q80452px254px80%
460x345q80460px345px80%
460x748q80460px748px80%
470x264q50470px264px50%
478x268q50478px268px50%
480x180q80480px180px80%
480x270q50480px270px50%
480x270q80480px270px80%
488x274q50488px274px50%
492x278q50492px278px50%
520x293q80520px293px80%
552x310q50552px310px50%
562x316q50562px316px50%
564x318q50564px318px50%
574x322q50574px322px50%
574x324q50574px324px50%
576x576q50576px576px50%
578x326q50578px326px50%
582x327q80582px327px80%
582x328q50582px328px50%
592x334q50592px334px50%
594x334q80594px334px80%
600x70q50600px70px50%
602x338q50602px338px50%
608x228q80608px228px80%
613x345q80613px345px80%
622x350q50622px350px50%
626x352q50626px352px50%
628x352q50628px352px50%
630x354q50630px354px50%
634x356q50634px356px50%
640x360q50640px360px50%
640x360q80640px360px80%
665x374q80665px374px80%
676x380q50676px380px50%
680x383q80680px383px80%
688x80q50688px80px50%
692x389q80692px389px80%
718x404q50718px404px50%
728x410q50728px410px50%
740x300q50740px300px50%
740x416q80740px416px80%
764x430q50764px430px50%
768x432q50768px432px50%
768x432q80768px432px80%
800x300q80800px300px80%
842x474q50842px474px50%
854x480q50854px480px50%
880x496q50880px496px50%
884x498q50884px498px50%
886x498q50886px498px50%
896x504q80896px504px80%
900x506q80900px506px80%
904x508q50904px508px50%
920x690q50920px690px50%
920x1496q50920px1496px50%
960x540q50960px540px50%
980x550q80980px550px80%
988x550q80988px550px80%
988x660q80988px660px80%
1024x384q801024px384px80%
1024x576q801024px576px80%
1024x768q801024px768px80%
1040x586q501040px586px50%
1152x648q501152px648px50%
1164x654q501164px654px50%
1188x668q501188px668px50%
1226x690q501226px690px50%
1280x480q801280px480px80%
1280x720q501280px720px50%
1280x720q801280px720px80%
1330x748q501330px748px50%
1360x766q501360px766px50%
1384x778q501384px778px50%
1400x1400q1001400px1400px100%
1480x832q501480px832px50%
1536x864q501536px864px50%
1792x1008q501792px1008px50%
1800x1012q501800px1012px50%
1920x720q801920px720px80%
1960x1100q501960px1100px50%
2048x1152q502048px1152px50%
2048x1536q502048px1536px50%

End-points