Risposta rapida
Come faccio a controllare se l'API SerpCrypto funziona?
Chiama GET https://serpcrypto.com/api/v1/credits con la tua chiave: è gratuito e risponde in JSON con i crediti che ti restano. Un 200 significa che l'API e la tua chiave funzionano. Gli errori 502 e 504 derivano da una ricerca non riuscita e non vengono mai addebitati. SerpCrypto pubblica gli incidenti nel changelog; non pubblica nessuna percentuale di uptime finché non è misurata.
curl -s https://serpcrypto.com/api/v1/credits -H "Authorization: Bearer $SERPCRYPTO_API_KEY"Cosa significa ogni risposta?
| Stato HTTP | Significato | Addebitato? | Cosa fare |
|---|---|---|---|
| 200 | L'API funziona; per una ricerca, i risultati sono nel body | 1 credito per una ricerca riuscita; il controllo dei crediti è gratuito | Niente |
401 invalid_api_key | La chiave è mancante, sbagliata o revocata | No | Copia di nuovo la chiave dalla dashboard |
402 insufficient_credits | Sul tuo account non restano crediti | No | Acquista un pack sulla pagina dei prezzi |
429 concurrency_limit | Troppe ricerche nello stesso momento | No | Riduci le richieste in parallelo, oppure chiedi un limite più alto |
502 search_failed | La ricerca non è riuscita a completarsi | No | Riprova dopo una breve attesa |
504 search_timeout | Nessuna risposta in tempo | No | Riprova dopo una breve attesa |
Il problema è dalla mia parte, dalla vostra o del motore?
Esegui prima il controllo gratuito, poi una ricerca semplice, poi la tua richiesta reale. Ogni passaggio isola un livello.
- La chiamata ai crediti fallisce con 401: il problema è la chiave. Controlla il formato dell'header:
Authorization: Bearer <key>, con uno spazio. - La chiamata ai crediti funziona ma ogni ricerca restituisce 502: il livello di raccolta o il motore sta fallendo per tutti. Aspetta qualche minuto e riprova; nel frattempo non viene addebitato nulla.
- Una query semplice funziona ma la tua fallisce con 400: un parametro non è tra i valori ammessi. La reference della ricerca elenca ogni valore.
- I risultati sembrano diversi da quelli del tuo browser: di solito dipende da posizione, lingua o dispositivo. Imposta
gl,hl,locationedevicein modo che corrispondano a ciò con cui confronti; vedi posizioni e lingue.
Dove vengono pubblicati gli incidenti e le modifiche?
Nel changelog. Ogni voce ha una data, cosa è stato interessato (un motore, un campo, l'area cliente o i pagamenti) e cosa è cambiato. Anche un campo aggiunto compare lì, così un parser può essere aggiornato prima che il campo gli serva.
Non gestiamo un sito di stato separato, e questa pagina non mostra nessuna luce verde che potrebbe essere obsoleta. Il controllo gratuito qui sopra ti dice lo stato reale dell'API per la tua chiave, nel momento in cui lo chiedi.
Perché non c'è una percentuale di uptime qui?
Perché non ne abbiamo ancora misurata una con un metodo pubblicato. Una percentuale di uptime implica una probe definita, un periodo definito e un guasto definito. Quando l'avremo, comparirà qui con il suo metodo e la sua data. Fino ad allora, la promessa onesta è la regola di fatturazione: 1 credito = 1 richiesta di ricerca andata a buon fine, che restituisce una pagina di risultati su qualsiasi motore supportato. Una richiesta non riuscita non viene addebitata.
Cosa devo inviare al supporto durante un incidente?
Scrivi a [email protected] con l'ID della richiesta da search_metadata.id (o l'ora della richiesta se non c'è stata risposta), il motore, lo stato HTTP e il codice di errore. Non includere mai la tua chiave API. Risposte via email entro 12 ore, 7 giorni su 7, incluso il supporto per l'integrazione dell'API. La pagina dei contatti elenca gli altri dettagli che velocizzano una risposta.