Update Playback Progress

Mettre à jour la progression de lecture

curl --request POST \
  --url https://dejavu.plus/api/v1/scrobble \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "type": "movie",
  "id": 550,
  "progress": 42,
  "duration": 120
}
'

import requests

url = "https://dejavu.plus/api/v1/scrobble"

payload = {
    "type": "movie",
    "id": 550,
    "progress": 42,
    "duration": 120
}
headers = {
    "x-api-key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({type: 'movie', id: 550, progress: 42, duration: 120})
};

fetch('https://dejavu.plus/api/v1/scrobble', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://dejavu.plus/api/v1/scrobble",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'type' => 'movie',
    'id' => 550,
    'progress' => 42,
    'duration' => 120
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://dejavu.plus/api/v1/scrobble"

	payload := strings.NewReader("{\n  \"type\": \"movie\",\n  \"id\": 550,\n  \"progress\": 42,\n  \"duration\": 120\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("x-api-key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://dejavu.plus/api/v1/scrobble")
  .header("x-api-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"type\": \"movie\",\n  \"id\": 550,\n  \"progress\": 42,\n  \"duration\": 120\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://dejavu.plus/api/v1/scrobble")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"type\": \"movie\",\n  \"id\": 550,\n  \"progress\": 42,\n  \"duration\": 120\n}"

response = http.request(request)
puts response.read_body

{
  "success": true
}

{
  "error": "VALIDATION_ERROR",
  "message": "The field 'rating' must be between 1 and 10."
}

{
  "error": "UNAUTHORIZED",
  "message": "API key is missing or invalid."
}

{
  "error": "FORBIDDEN",
  "message": "A secret key (sk_...) is required for write operations."
}

POST

scrobble

Mettre à jour la progression de lecture

curl --request POST \
  --url https://dejavu.plus/api/v1/scrobble \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "type": "movie",
  "id": 550,
  "progress": 42,
  "duration": 120
}
'

import requests

url = "https://dejavu.plus/api/v1/scrobble"

payload = {
    "type": "movie",
    "id": 550,
    "progress": 42,
    "duration": 120
}
headers = {
    "x-api-key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({type: 'movie', id: 550, progress: 42, duration: 120})
};

fetch('https://dejavu.plus/api/v1/scrobble', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://dejavu.plus/api/v1/scrobble",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'type' => 'movie',
    'id' => 550,
    'progress' => 42,
    'duration' => 120
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://dejavu.plus/api/v1/scrobble"

	payload := strings.NewReader("{\n  \"type\": \"movie\",\n  \"id\": 550,\n  \"progress\": 42,\n  \"duration\": 120\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("x-api-key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://dejavu.plus/api/v1/scrobble")
  .header("x-api-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"type\": \"movie\",\n  \"id\": 550,\n  \"progress\": 42,\n  \"duration\": 120\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://dejavu.plus/api/v1/scrobble")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"type\": \"movie\",\n  \"id\": 550,\n  \"progress\": 42,\n  \"duration\": 120\n}"

response = http.request(request)
puts response.read_body

{
  "success": true
}

{
  "error": "VALIDATION_ERROR",
  "message": "The field 'rating' must be between 1 and 10."
}

{
  "error": "UNAUTHORIZED",
  "message": "API key is missing or invalid."
}

{
  "error": "FORBIDDEN",
  "message": "A secret key (sk_...) is required for write operations."
}

Usage

Creates or updates a playback session and its progress. Authentication is required via x-api-key or Authorization: Bearer. Write access requires the permissions associated with a secret key (sk_).

Example

curl -X POST -H "x-api-key: $DEJAVU_API_KEY" -H "Content-Type: application/json" \
  -d '{"type":"movie","id":550,"progress":50}' "https://dejavu.plus/api/v1/scrobble"

Parameters and response

The request body and responses are defined by the OpenAPI specification displayed on this page.

Errors

See Responses for the operation-specific error codes and formats.

Notes

At a playback progress of at least 90%, dejaVu applies the completion behavior documented by the API.

Authorizations

x-api-key

string

header

required

Clé API dejaVu. pk_* = lecture seule ; sk_* = lecture et écriture.

Body

application/json

Met à jour la progression d'un film ou d'un épisode. À 90 % ou plus, le contenu est automatiquement marqué comme vu.

type

enum<string>

required

Available options:

movie,

episode

progress

integer

required

Secondes déjà lues

duration

integer

required

Durée totale du contenu en secondes

integer

ID TMDB du film ou de l'épisode, facultatif si tmdbId ou le contexte d'épisode est fourni.

tmdbId

integer

ID TMDB du film ou ID TMDB de la série pour résoudre un épisode.

Required range: x >= 1

tvShowId

integer

ID TMDB de la série pour résoudre un épisode.

Required range: x >= 1

seasonNumber

integer

Numéro de saison pour résoudre un épisode.

Required range: x >= 0

episodeNumber

integer

Numéro d'épisode pour résoudre un épisode.

Required range: x >= 1

Response

Progression mise à jour. Si > 90%, marqué comme vu automatiquement.

success

boolean

default:true

Introduction

Auth

Collection

History

Favorites

Ratings

Watchlist

Scrobble

Up Next

Dashboard

Lists

User

Media

Channels

Connectors

Kodi

Update Playback Progress

Usage

Example

Parameters and response

Errors

Notes

Authorizations

Body

Response

​Usage

​Example

​Parameters and response

​Errors

​Notes

Authorizations

Body

Response

Usage

Example

Parameters and response

Errors

Notes