Douyin Live Room Detail
Le dirette di Douyin sono sessioni di trasmissione pubbliche con titolo, stato attuale, identità del conduttore, media e conteggi visibili di spettatori e Mi piace. Questi campi supportano l’arricchimento del catalogo delle dirette, il monitoraggio dello stato delle sessioni e il confronto in un preciso momento.
Funzionalità della Douyin Live Room Detail API
- Ricerca dei dettagli di una diretta notaTrasforma un room_id numerico noto in al massimo un record live_room normalizzato con una sola richiesta alla fonte, senza paginazione della fonte.
- Contesto della diretta e del conduttoreMantiene insieme, in un’unica struttura coerente, titolo, stato, identità del conduttore, URL di origine e orario di raccolta disponibili.
- Istantanea visibile della sessioneAcquisisce i conteggi disponibili di spettatori e Mi piace insieme ai media pubblici, per una vista della diretta con data e ora.
Parametri della Douyin Live Room Detail API
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
room_id | Obbligatorio | Identificatore obbligatorio di una diretta di Douyin, composto da sole cifre. Invialo come stringa, così gli identificatori lunghi non vengono arrotondati da un client. |
Come usare la Douyin Live Room Detail API
Parti da un ID numerico noto di una diretta, invia l’attività asincrona di dettaglio e leggi il relativo risultato normalizzato salvato.
- Ricava room_id da un contesto di diretta che espone l’identificatore numerico; questo endpoint non individua gli ID delle dirette.
- Invia con POST l’identificatore come stringa non vuota di sole cifre a /v1/douyin/live-room-detail.
- Interroga /v1/tasks/{task_id} finché status diventa succeeded o failed.
- Leggi data.results.items da /v1/tasks/{task_id}?limit=50; una diretta risolta produce al massimo un elemento, mentre next_cursor riguarda solo la paginazione dei risultati salvati da SocQ.
# Set DOUYIN_ROOM_ID to a known numeric room_id before sending.
curl -X POST "https://api.socq.ai/v1/douyin/live-room-detail" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d "{\"room_id\":\"${DOUYIN_ROOM_ID}\"}"
# Poll GET /v1/tasks/{task_id}, then read data.results.items from /v1/tasks/{task_id}?limit=50.Casi d’uso della Douyin Live Room Detail API
- Arricchimento del catalogo delle dirette: Aggiungi titolo, stato, conduttore, media, metriche visibili e orario di raccolta disponibili a un catalogo che conserva già l’ID della diretta.
- Monitoraggio delle istantanee dello stato della sessione: Conserva i record raccolti separatamente con collected_at per distinguere le osservazioni dello stato della diretta e del pubblico in momenti diversi.
- Verifica del contesto conduttore e diretta: Esamina l’identità disponibile del conduttore accanto a titolo, stato, media e conteggi visibili della sessione in un unico record normalizzato.
Consigli degli esperti per la Douyin Live Room Detail API
- Invia room_id come stringa tra virgolette di sole cifre, non come numero JavaScript, così un identificatore lungo mantiene tutte le cifre.
- Ottieni un room_id noto prima di chiamare l’endpoint, perché la richiesta recupera dettagli e non individua dirette.
- Conserva il room_id inviato nel tuo record; il risultato canonico della diretta non garantisce che la fonte lo restituisca come id.
- Tratta titolo, stato, autore, metriche, media, URL e timestamp come nullable, perché la fonte può omettere singoli campi pubblici.
- Non inviare results_limit né un cursore di origine; next_cursor, quando presente, pagina gli elementi di risultato salvati da SocQ e non la richiesta al provider.
API correlate
Oltre alla Douyin Live Room Detail API, usa queste API quando ti serve un altro tipo di dati pubblici di Douyin.