Kurze Antwort
Wie prüfe ich, ob die SerpCrypto API funktioniert?
Rufen Sie GET https://serpcrypto.com/api/v1/credits mit Ihrem Schlüssel auf: Der Aufruf ist kostenlos und antwortet in JSON mit Ihren verbleibenden Credits. Ein 200 bedeutet, dass die API und Ihr Schlüssel funktionieren. Fehler 502 und 504 stammen aus einer fehlgeschlagenen Suche und werden nie berechnet. SerpCrypto veröffentlicht Vorfälle im Changelog; eine Uptime-Zahl wird erst veröffentlicht, wenn sie gemessen ist.
curl -s https://serpcrypto.com/api/v1/credits -H "Authorization: Bearer $SERPCRYPTO_API_KEY"Was bedeutet welche Antwort?
| HTTP-Status | Bedeutung | Berechnet? | Was zu tun ist |
|---|---|---|---|
| 200 | Die API funktioniert; bei einer Suche stehen die Ergebnisse im Body | 1 Credit für eine erfolgreiche Suche; der Credits-Check ist kostenlos | Nichts |
401 invalid_api_key | Der Schlüssel fehlt, ist falsch oder wurde widerrufen | Nein | Kopieren Sie den Schlüssel erneut aus dem Dashboard |
402 insufficient_credits | Auf Ihrem Konto sind keine Credits mehr übrig | Nein | Kaufen Sie ein Paket auf der Preisseite |
429 concurrency_limit | Zu viele Suchen gleichzeitig | Nein | Senken Sie die parallelen Anfragen oder fragen Sie ein höheres Limit an |
502 search_failed | Die Suche konnte nicht abgeschlossen werden | Nein | Wiederholen Sie sie nach kurzer Wartezeit |
504 search_timeout | Keine Antwort innerhalb der Zeit | Nein | Wiederholen Sie sie nach kurzer Wartezeit |
Liegt das Problem bei mir, bei uns oder an der Engine?
Führen Sie zuerst den kostenlosen Check aus, dann eine einfache Suche, dann Ihre echte Anfrage. Jeder Schritt isoliert eine Ebene.
- Der Credits-Aufruf schlägt mit 401 fehl: Das Problem ist der Schlüssel. Prüfen Sie das Header-Format:
Authorization: Bearer <key>, mit einem Leerzeichen. - Der Credits-Aufruf funktioniert, aber jede Suche liefert 502: Die Sammlungsebene oder die Engine schlägt für alle fehl. Warten Sie einige Minuten und wiederholen Sie den Aufruf; in der Zwischenzeit wird nichts berechnet.
- Eine einfache Suchanfrage funktioniert, Ihre schlägt mit 400 fehl: Ein Parameter liegt außerhalb der erlaubten Liste. Die Suchreferenz listet jeden Wert auf.
- Die Ergebnisse weichen von Ihrem Browser ab: Das liegt meist an Standort, Sprache oder Gerät. Setzen Sie
gl,hl,locationunddevicepassend zu dem, womit Sie vergleichen; siehe Standorte und Sprachen.
Wo werden Vorfälle und Änderungen veröffentlicht?
Im Changelog. Jeder Eintrag enthält ein Datum, was betroffen war (eine Engine, ein Feld, der Kundenbereich oder Zahlungen) und was sich geändert hat. Ein neu hinzugefügtes Feld erscheint dort ebenfalls, sodass ein Parser aktualisiert werden kann, bevor er das Feld benötigt.
Wir betreiben keine separate Status-Seite, und diese Seite zeigt kein grünes Licht, das veraltet sein könnte. Der kostenlose Check oben zeigt Ihnen den tatsächlichen Zustand der API für Ihren Schlüssel im Moment der Abfrage.
Warum gibt es hier keine Uptime-Prozentzahl?
Weil wir noch keine mit einer veröffentlichten Methode gemessen haben. Eine Uptime-Zahl bedeutet eine definierte Probe, einen definierten Zeitraum und einen definierten Fehler. Sobald wir das haben, erscheint sie hier mit Methode und Datum. Bis dahin ist das ehrliche Versprechen die Abrechnungsregel: 1 Credit = 1 erfolgreiche Suchanfrage, die eine Ergebnisseite auf jeder unterstützten Engine liefert. Eine fehlgeschlagene Anfrage wird nicht berechnet.
Was sollte ich dem Support während eines Vorfalls senden?
Schreiben Sie an [email protected] mit der Request-ID aus search_metadata.id (oder der Uhrzeit der Anfrage, falls es keine Antwort gab), der Engine, dem HTTP-Status und dem Fehlercode. Fügen Sie niemals Ihren API-Schlüssel bei. E-Mail-Antworten innerhalb von 12 Stunden, 7 Tage die Woche, auch bei Hilfe zur API-Integration. Die Kontaktseite listet die weiteren Angaben, die eine Antwort beschleunigen.