Autentificare
Fiecare cerere amodb poartă o cheie: 32 de caractere hex minuscule. Trimite-o ca api_key în interogare sau ca antet Authorization: Bearer pentru apelurile în stil TMDB, și ca apikey pentru cele în stil OMDb. Imaginile nu cer cheie. O cheie greșită întoarce 401 cu status_code 7, una suspendată 401 cu status_code 10.
Formatul cheii
O cheie are 32 de caractere hex minuscule, de exemplu 0123456789abcdef0123456789abcdef. Are aceeași formă ca o cheie TMDB v3, deci câmpurile și validatoarele construite pentru chei TMDB o acceptă.
amodb stochează doar un hash SHA-256 al fiecărei chei. Cheia completă se afișează o singură dată, la creare. Dacă o pierzi, șterge-o și creează una nouă.
Apeluri în stil TMDB
Trimite cheia într-unul din două moduri. Ambele funcționează pe fiecare endpoint de sub https:/.
| Metodă | Exemplu |
|---|---|
| Parametru de interogare | ?api_key=YOUR_KEY |
| Antet | Authorization: Bearer YOUR_ |
curl "https://api.amodb.dev/3/configuration" \
-H "Authorization: Bearer $AMODB_KEY"const res = await fetch("https://api.amodb.dev/3/configuration", {
headers: { Authorization: `Bearer ${process.env.AMODB_KEY}` },
});import os
import requests
res = requests.get(
"https://api.amodb.dev/3/configuration",
headers={"Authorization": f"Bearer {os.environ['AMODB_KEY']}"},
timeout=10,
)<?php
$url = "https://api.amodb.dev/3/configuration?api_key=" . urlencode(getenv("AMODB_KEY"));
$config = json_decode(file_get_contents($url), true);req, _ := http.NewRequest("GET", "https://api.amodb.dev/3/configuration", nil)
req.Header.Set("Authorization", "Bearer "+os.Getenv("AMODB_KEY"))
res, err := http.DefaultClient.Do(req)Apeluri în stil OMDb
Endpoint-ul compatibil OMDb primește cheia ca apikey, ca în OMDb. Este aceeași cheie pe care o folosești pentru apelurile în stil TMDB.
curl "https://api.amodb.dev/omdb/?t=Inception&y=2010&apikey=$AMODB_KEY"Imaginile nu cer cheie
URL-urile de imagini de pe img.amodb.dev sunt publice. Nu adăuga cheia în ele: un tag <img> ar expune-o fiecărui vizitator.
Păstrează cheile pe server
O cheie dintr-un bundle de browser, dintr-o aplicație mobilă sau dintr-un depozit public este publică. Oricine o copiază îți consumă rata de cereri. Apelează amodb de pe serverul tău, dintr-o funcție serverless sau dintr-un pas de build și trimite clienților doar datele.
- Stochează cheia într-o variabilă de mediu sau într-un manager de secrete.
- Folosește o cheie pentru fiecare aplicație sau mediu, cu o etichetă precum
productionsaustaging. - Șterge o cheie în clipa în care a fost expusă. Apelurile făcute cu ea eșuează imediat.
Erori
| HTTP | status_code | Semnificație |
|---|---|---|
| 401 | 7 | Cheia lipsește, este malformată sau necunoscută. |
| 401 | 10 | Cheia este suspendată. Scrie la support@amodb.dev. |
| 402 | 36 | Planul tău a expirat. Plătește o perioadă nouă pe pagina de prețuri. |
Vezi erorile pentru toate codurile.