Mettre à jour la progression

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."
}

Utilisation

Crée ou met à jour une session de lecture et sa progression. L’authentification est requise via x-api-key ou Authorization: Bearer.

Exemple

curl -X POST -H "x-api-key: $DEJAVU_API_KEY" -H "Content-Type: application/json" "https://dejavu.plus/api/v1/scrobble"

Paramètres et réponse

Les paramètres, schémas de requête et réponses sont définis par la spécification OpenAPI affichée sur cette page. Utilisez les champs du schéma pour construire la requête.

Erreurs

Consultez Responses pour les codes et formats d’erreur propres à l’opération. Une réponse 401 indique une authentification absente ou invalide.

Notes

À partir d’une progression d’au moins 90 %, dejaVu applique le comportement de complétion documenté par l’API.

Autorisations

x-api-key

string

header

requis

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

Corps

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>

requis

Options disponibles:

movie,

episode

progress

integer

requis

Secondes déjà lues

duration

integer

requis

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.

Plage requise: x >= 1

tvShowId

integer

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

Plage requise: x >= 1

seasonNumber

integer

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

Plage requise: x >= 0

episodeNumber

integer

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

Plage requise: x >= 1

Réponse

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

success

boolean

défaut:true

Introduction

Auth

Collection

History

Favorites

Ratings

Watchlist

Scrobble

Up Next

Dashboard

Lists

User

Media

Channels

Connectors

Kodi

Mettre à jour la progression

Utilisation

Exemple

Paramètres et réponse

Erreurs

Notes

Autorisations

Corps

Réponse

​Utilisation

​Exemple

​Paramètres et réponse

​Erreurs

​Notes

Autorisations

Corps

Réponse

Utilisation

Exemple

Paramètres et réponse

Erreurs

Notes