Crediti per sviluppatori

Gli utenti a pagamento ricevono 1.000 crediti al mese interno. I crediti non vengono trasferiti.

Gli abbonamenti trimestrali e semestrali ricevono comunque 1.000 crediti un mese interno alla volta.

Le classifiche costano 1 credito per 20 articoli effettivi; outlier la ricerca costa 2; il dettaglio del video trovato costa 1; verificare e bilanciare il costo 0.

Il server convalida, riserva il costo massimo, esegue e liquida una volta utilizzando il valore maggiore tra all_data.items.length e filter_data.items.length; i due set non vengono mai sommati per la fatturazione. La differenza viene rimborsata atomicamente.

Risultati vuoti, non trovati, 304, richieste non valide, errori di autenticazione, limiti di velocità ed errori del server costano 0.

Queste sono le regole di fatturazione attuali per ogni endpoint REST della piattaforma per sviluppatori pubblica V1. Gli endpoint di classificazione e ricerca vengono stabiliti una volta utilizzando il conteggio effettivo degli articoli maggiore da all_data e filter_data; i due conteggi non vengono sommati e la fatturazione non utilizza direttamente lo limit richiesto.

Il valore predefinito limit è 20, con un minimo di 1 e un massimo di 50. Il conteggio effettivo degli articoli è max(all_data.items.length, filter_data.items.length). Le classifiche cinesi e quelle calde di oggi utilizzano ceil(actual items ÷ 20) × 1; La ricerca outlier utilizza ceil(actual items ÷ 20) × 2.

Ad esempio, se limit=50 restituisce solo 3 elementi della classifica cinese, il costo finale è 1; se la ricerca outlier restituisce 3, il costo è 2. Prima viene prenotato il massimo, poi viene saldato il risultato effettivo e la differenza rimborsata atomicamente.

REST API e MCP utilizzano lo stesso conto di credito e le stesse regole di liquidazione.

I controlli dello stato, le ricerche sulla fatturazione e la gestione delle chiavi nella console web non consumano crediti per sviluppatori. /control/v1/* è un'interfaccia interna firmata tra il sito Web ShortsMonkey e Core API e non deve essere chiamata direttamente dai normali sviluppatori.

Un riscontro nella cache non è automaticamente gratuito: hot today viene comunque fatturato in base agli effettivi articoli restituiti quando viene utilizzata la cache del server. Solo i casi seguenti si stabilizzano a 0.

Ogni risposta API pubblica riuscita restituisce il costo corrente, il saldo rimanente e la fine del periodo di credito tramite X-Credits-Cost, X-Credits-Remaining e X-Credits-Period-End.

I campi JSON credits.cost, credits.remaining e credits.period_ends_at forniscono le stesse informazioni. Utilizza l'effettivo cost della risposta.