Guida all'integrazione
Autenticati, cerca e leggi i risultati.
1. Autenticazione
Chiama dal tuo server con chiave API e intestazioni Content-Type: application/json. Mantieni la tua chiave privata.
Apri le chiavi API2. Richiedi parametri
Le richieste supportano solo query, conteggio e search_lang. la query accetta una domanda o parole chiave in linguaggio naturale.
| Campo | Tipo | Necessario | Descrizione |
|---|---|---|---|
| query | string | SÌ | Una domanda di ricerca o parole chiave. Non deve essere vuoto. |
| count | integer | NO | Conteggio dei risultati desiderati. Omettere o passare 0 per utilizzare l'impostazione predefinita del servizio. |
| search_lang | string | NO | Cerca la lingua, ad esempio zh-hans. Il servizio normalizza zh in zh-hans. Fare clic su questa riga per l'elenco supportato. |
3. Chiama la ricerca API
https://api.starsg.ai/api/product/websearch/searchSostituisci YOUR_API_KEY e imposta la query sul testo di ricerca. conteggio e search_lang sono opzionali.
curl -X POST 'https://api.starsg.ai/api/product/websearch/search' \
-H 'api-key: YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"query": "北京今天的天气",
"count": 5,
"search_lang": "zh-hans"
}'Invia direttamente un oggetto JSON, senza body wrapper o /v1. aggiuntivo
4. Leggi il risultato
Controlla prima il successo. In caso di successo, leggere data.references e data.data; in caso di errore, controllare errorCode e errorMsg. Il contenuto web riportato di seguito è illustrativo.
{
"success": true,
"data": {
"references": [
{
"website": "example.com",
"logo": "https://example.com/favicon.ico",
"title": "Esempio di notizie sulla casa intelligente",
"url": "https://example.com/article",
"summary": "Il riepilogo dei risultati della ricerca va qui.",
"published": "",
"extra": {}
}
],
"data": [
"Il riepilogo dei risultati della ricerca va qui."
]
},
"errorCode": null,
"errorMsg": null
}data.references | Riferimenti web con titoli, collegamenti e riepiloghi. |
data.data | Elenco di testi dei risultati, nidificato all'interno dell'oggetto dati esterno. |
references[].website / logo | Nome del sito web o dominio e logo URL. |
references[].title / url / summary | Titolo del risultato, pagina originale URL e riepilogo. |
references[].published / extra | Data di pubblicazione e informazioni aggiuntive. Potrebbe essere vuoto. |
success=true con riferimenti e array di dati vuoti significa che non sono stati trovati risultati validi. Prova parole chiave diverse o una lingua di ricerca diversa; non trattarlo come un guasto API.
{
"success": false,
"data": null,
"errorCode": "PARAM_INVALID",
"errorMsg": "query is required"
}Errori comuni e passaggi successivi
PARAM_INVALIDO | Controllare JSON e interrogare. Correggere i parametri prima di riprovare. |
RICERCA_FAILED | La ricerca è fallita. Riprova più tardi con un limite di tentativi. Per gli errori persistenti, risparmia il tempo della chiamata e richiedi l'identificatore per il supporto. |