Ajouter à l’historique

Ajouter à l'historique

curl --request POST \
  --url https://dejavu.plus/api/v1/history \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "type": "movie",
  "id": 550,
  "watchedAt": "2026-09-27T12:00:00Z"
}
'

import requests

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

payload = {
    "type": "movie",
    "id": 550,
    "watchedAt": "2026-09-27T12:00:00Z"
}
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, watchedAt: '2026-09-27T12:00:00Z'})
};

fetch('https://dejavu.plus/api/v1/history', 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/history",
  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,
    'watchedAt' => '2026-09-27T12:00:00Z'
  ]),
  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/history"

	payload := strings.NewReader("{\n  \"type\": \"movie\",\n  \"id\": 550,\n  \"watchedAt\": \"2026-09-27T12:00:00Z\"\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/history")
  .header("x-api-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"type\": \"movie\",\n  \"id\": 550,\n  \"watchedAt\": \"2026-09-27T12:00:00Z\"\n}")
  .asString();

require 'uri'
require 'net/http'

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

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  \"watchedAt\": \"2026-09-27T12:00:00Z\"\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

history

Ajouter à l'historique

curl --request POST \
  --url https://dejavu.plus/api/v1/history \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "type": "movie",
  "id": 550,
  "watchedAt": "2026-09-27T12:00:00Z"
}
'

import requests

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

payload = {
    "type": "movie",
    "id": 550,
    "watchedAt": "2026-09-27T12:00:00Z"
}
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, watchedAt: '2026-09-27T12:00:00Z'})
};

fetch('https://dejavu.plus/api/v1/history', 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/history",
  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,
    'watchedAt' => '2026-09-27T12:00:00Z'
  ]),
  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/history"

	payload := strings.NewReader("{\n  \"type\": \"movie\",\n  \"id\": 550,\n  \"watchedAt\": \"2026-09-27T12:00:00Z\"\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/history")
  .header("x-api-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"type\": \"movie\",\n  \"id\": 550,\n  \"watchedAt\": \"2026-09-27T12:00:00Z\"\n}")
  .asString();

require 'uri'
require 'net/http'

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

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  \"watchedAt\": \"2026-09-27T12:00:00Z\"\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

Ajoute un visionnage à l’historique de l’utilisateur authentifié. 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/history"

Paramètres et réponse

Le corps JSON et les réponses sont définis par la spécification OpenAPI affichée sur cette page.

Erreurs

Consultez Responses pour les codes et formats d’erreur propres à l’opération.

Notes

Pour un épisode, renseignez le contexte de série, saison et épisode lorsque requis. La date de visionnage peut être transmise selon le schéma de requête.

Autorisations

x-api-key

string

header

requis

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

Corps

application/json

Ajoute un film ou un épisode à l'historique. Les séries TV ne constituent pas une entrée d'historique autonome : utilisez type=episode.

type

enum<string>

requis

Options disponibles:

movie,

tv,

episode

integer

ID TMDB du film ou de l'épisode. Pour un épisode, peut être remplacé par tvShowId + seasonNumber + episodeNumber.

count

integer

défaut:1

Nombre de visionnages à enregistrer

watchedAt

string<date-time>

Date et heure du visionnage (défaut: maintenant)

tmdbId

integer

Alias du TMDB ID de la série pour résoudre un épisode par contexte.

tvShowId

integer

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

seasonNumber

integer

Numéro de saison pour la résolution d'un épisode.

Plage requise: x >= 0

episodeNumber

integer

Numéro d'épisode pour la résolution d'un épisode.

Plage requise: x >= 1

Réponse

Visionnage enregistré

success

boolean

défaut:true

Introduction

Auth

Collection

History

Favorites

Ratings

Watchlist

Scrobble

Up Next

Dashboard

Lists

User

Media

Channels

Connectors

Kodi

Ajouter à l’historique

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