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

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

Usage

Adds a watch entry to the authenticated user’s history. 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}' "https://dejavu.plus/api/v1/history"

Parameters and response

The JSON 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

For an episode, provide the series, season, and episode context when required.

Authorizations

x-api-key

string

header

required

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

Body

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>

required

Available options:

movie,

tv,

episode

integer

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

count

integer

default: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.

Required range: x >= 0

episodeNumber

integer

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

Required range: x >= 1

Response

Visionnage enregistré

success

boolean

default:true

Introduction

Auth

Collection

History

Favorites

Ratings

Watchlist

Scrobble

Up Next

Dashboard

Lists

User

Media

Channels

Connectors

Kodi

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