Indicatori de atmosferă

Obține indicatorii de atmosferă ai unui film

GET /3/movie/{movie_id}/moods întoarce indicatorii de atmosferă ai unui film. Un indicator de atmosferă este un nume și o medie pe o scară de la 0 la 10. Răspunsul conține id-ul filmului, un source și un array results. Fiecare rezultat are name, avg și values.

Exemplul încarcă indicatorii pentru The Dark Knight (ID 155) și îi afișează de la cel mai puternic la cel mai slab.

curl -sf "https://api.amodb.dev/3/movie/155/moods" \
  -H "Authorization: Bearer $AMODB_KEY"

const res = await fetch('https://api.amodb.dev/3/movie/155/moods', {
  headers: { Authorization: `Bearer ${process.env.AMODB_KEY}` },
});
if (!res.ok) throw new Error(`amodb returned ${res.status}`);
const { source, results } = await res.json();
console.log('source:', source);
for (const m of [...results].sort((a, b) => b.avg - a.avg)) {
  console.log(m.name.padEnd(10), m.avg);
}

import os
import requests

r = requests.get(
    "https://api.amodb.dev/3/movie/155/moods",
    headers={"Authorization": f"Bearer {os.environ['AMODB_KEY']}"},
    timeout=10,
)
r.raise_for_status()
data = r.json()
print("source:", data.get("source"))
for m in sorted(data["results"], key=lambda m: m["avg"], reverse=True):
    print(f"{m['name']:<10} {m['avg']}")

<?php
$ch = curl_init('https://api.amodb.dev/3/movie/155/moods');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 10,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . getenv('AMODB_KEY')],
]);
$body = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
if ($status !== 200) {
    throw new RuntimeException("amodb returned $status");
}
$data = json_decode($body, true);
echo 'source: ', $data['source'] ?? 'none', PHP_EOL;
$results = $data['results'];
usort($results, fn ($a, $b) => $b['avg'] <=> $a['avg']);
foreach ($results as $m) {
    printf("%-10s %.1f\n", $m['name'], $m['avg']);
}

package main

import (
	"encoding/json"
	"fmt"
	"net/http"
	"os"
	"sort"
	"time"
)

type Mood struct {
	Name   string    `json:"name"`
	Avg    float64   `json:"avg"`
	Values []float64 `json:"values"`
}

func main() {
	req, _ := http.NewRequest("GET", "https://api.amodb.dev/3/movie/155/moods", nil)
	req.Header.Set("Authorization", "Bearer "+os.Getenv("AMODB_KEY"))
	client := &http.Client{Timeout: 10 * time.Second}
	res, err := client.Do(req)
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()
	if res.StatusCode != http.StatusOK {
		panic(res.Status)
	}
	var body struct {
		Source  string `json:"source"`
		Results []Mood `json:"results"`
	}
	if err := json.NewDecoder(res.Body).Decode(&body); err != nil {
		panic(err)
	}
	fmt.Println("source:", body.Source)
	sort.Slice(body.Results, func(i, j int) bool { return body.Results[i].Avg > body.Results[j].Avg })
	for _, m := range body.Results {
		fmt.Printf("%-10s %.1f\n", m.Name, m.Avg)
	}
}

Parametri

• movie_idcaleobligatoriu
  ID numeric de film, de exemplu 155.
• api_keyinterogareuna dintre cele două
  Cheia ta. Folosește-o pe aceasta sau antetul Authorization: Bearer.

Câmpurile răspunsului

Numele văzute azi sunt action, fear, humor, pace, profanity, romance, sadness, sex și violence. Nu orice titlu le are pe toate nouă, deci afișează numele din date și nu dintr-o listă fixă.

Exemplu de răspuns

{
  "id": 155,
  "source": "measured",
  "results": [
    { "name": "action", "avg": 3.9, "values": [3.6, 3.4, 4.2, 4.2, 4.8, 3] },
    { "name": "fear", "avg": 5.2, "values": [3.6, 6, 4.8, 6.4, 6.4, 3.8] },
    { "name": "humor", "avg": 0.9, "values": [2.4, 1.8, 0.4, 0.4, 0, 0.5] }
  ]
}

Lista este tăiată la 3 din cele 9 rezultate.

Titluri măsurate și estimate

Fight Club (ID 550) nu are încă date de la spectatori, deci indicatorii lui sunt derivați din genuri. Fiecare avg este un număr întreg, iar values are 5 intrări.

{
  "id": 550,
  "source": "estimated",
  "results": [
    { "name": "action", "avg": 4, "values": [3, 4, 5, 4, 3] },
    { "name": "fear", "avg": 7, "values": [6, 7, 8, 7, 6] }
  ]
}

Verifică source dacă vrei să tratezi indicatorii estimați altfel decât pe cei măsurați.

Obține indicatorii de atmosferă ai unui serial

GET /3/tv/{tv_id}/moods are aceeași structură de răspuns, cu ID-ul serialului în id. Pentru Breaking Bad folosește 1396.

curl -sf "https://api.amodb.dev/3/tv/1396?append_to_response=moods" -H "Authorization: Bearer $AMODB_KEY"

Când atașezi moods la un apel de detalii, cheia moods stă la nivelul superior al înregistrării, lângă title sau name. Conține source și results și nu are un id propriu. Asta costă o cerere, în timp ce două apeluri separate costă două.

Cum citești scala

Câmpul avg este o intensitate de la 0 la 10. Un număr mai mare înseamnă că atmosfera este mai puternică în titlu.

Intervalele sunt o sugestie pentru interfața ta, nu un câmp din răspuns. Array-ul values conține citirile din spatele mediei, pe aceeași scară.

Construiește insigne și filtre

Atmosferele se potrivesc cu trei tipare obișnuite de interfață. Alege praguri potrivite catalogului tău și ajustează-le.

function topMoods(results, min = 6, limit = 3) {
  return results
    .filter((m) => m.avg >= min)
    .sort((a, b) => b.avg - a.avg)
    .slice(0, limit)
    .map((m) => m.name);
}

function matchesMood(results, name, min = 7) {
  return results.some((m) => m.name === name && m.avg >= min);
}

Un array results gol ar trebui afișat ca lipsă de insigne, nu ca eroare.

Erori

Corpul de eroare are success, status_code și status_message, aceleași câmpuri pe care le folosește TMDB.

Endpoint-ul moods nu răspunde 404 pentru un ID necunoscut. Răspunde 200 cu un array results gol, iar source este null sau lipsește. Atașat la detalii, un ID necunoscut este un 404 de la apelul de detalii. Lista completă este la erori, iar limitele sunt la limite de cereri.

Note practice

• Ca alte date de detalii, indicatorii de atmosferă sunt ținuți în cache la margine 6 ore. Preluarea lor mai des întoarce același corp.
• O listă de 20 de titluri cere 20 de cereri de atmosferă. Dacă apelezi deja detaliile fiecărui titlu, atașează moods și economisești al doilea apel.
• Verifică source înainte să compari titlurile. Indicatorii măsurați și cei estimați folosesc aceeași scară, dar nu aceeași precizie.
• Stochează name și avg împreună cu ID-ul titlului în propria bază de date dacă filtrezi des. Un filtru local bate o cerere pe titlu.
• Combină indicatorii cu evaluări pentru un scor și cu coloane sonore pentru muzica aceluiași titlu.