GunSpec
Feedback

Feedback und Datenmeldungen

Eine falsche Zahl, ein fehlender Datensatz, ein Fehler in einem Endpunkt, eine Seite, die deine Frage nicht beantwortet hat: Für jedes davon gibt es einen Kanal, und jeder landet bei einem Menschen.

Wähle nach dem, was du gefunden hast. Datenkorrekturen und Support haben beide eine API, damit eine Integration sie ohne Browser einreichen kann.

Eine falsche oder fehlende Zahl

Reiche eine Datenmeldung gegen den Datensatz und den betroffenen Abschnitt ein. Von einer Person geprüft; eine Korrektur geht über denselben Weg in den Katalog, den Mitarbeiter nutzen.

So funktioniert es

Etwas kaputt oder unklar

Eröffne ein Support-Ticket. Füge die X-Request-Id eines fehlgeschlagenen Aufrufs bei, dann sehen wir die Anfrage selbst.

So funktioniert es

Diese Dokumentation

Jede Seite hat in der Fußzeile ein Hilfreich/Nicht-hilfreich-Element und einen Meldelink. Beides erreicht uns als Ticket mit Seite und Endpunkt.

So funktioniert es

Eine Funktion, die du brauchst

Ein Ticket in der Kategorie Feature-Request. Was sich wiederholt, formt die Roadmap; eine Antwort sagt dir, wann etwas ausgeliefert wird.

So funktioniert es

Eine Sicherheitslücke

Kein Ticket. Schreib vertraulich an security@gunspec.io; die Meldungsrichtlinie sagt, was beizulegen ist und was wir zusichern.

So funktioniert es

POST /v1/me/reports reicht eine Korrektur zu einer Waffe ein und benennt Abschnitt und Problemart; GET /v1/me/reports listet, was du eingereicht hast und wo es steht. Beides braucht einen Schlüssel, der zu einem Konto gehört. Vollständige Formen stehen in der Referenz.

Eine falsche Lauflänge melden
bash
curl -X POST https://api.gunspec.io/v1/me/reports \  -H "X-API-Key: your_api_key" \  -H "Content-Type: application/json" \  -d '{    "firearmId": "glock-17-gen5",    "section": "specs",    "issueType": "incorrect",    "description": "Barrel length is listed as 114 mm; Glock quotes 114.2 mm.",    "suggestedValue": "114.2",    "references": ["https://eu.glock.com/en/pistols/g17"]  }'

Request-Body

  • firearmIdstringerforderlich

    Slug of the firearm this row belongs to.

  • sectionenumerforderlich

    Which part of the record the report is about.

    • game-stats
    • specs
    • ballistics
    • barrel
    • materials
    • operating
    • calibers
    • users
    • description
  • issueTypeenumerforderlich

    What kind of problem: incorrect, missing, outdated.

    • incorrect
    • missing
    • outdated
  • descriptionstringerforderlich

    Prose summary of the record, where one has been written.

  • suggestedValuestring

    What the reporter believes the value should be.

  • referencesstring[]

    Pages the reporter cited in support.

Lebenszyklus

  1. pending
  2. reviewed
  3. resolved
  4. dismissed
  • Eine Meldung pro Konto, Waffe und Abschnitt alle 24 Stunden; eine zweite im Fenster ist ein 429 REPORT_RATE_LIMITED. Ergänze stattdessen die bereits eingereichte.
  • Nenne wo möglich eine Quelle in references. Eine Meldung mit Herstellerseite dahinter wird weit schneller gelöst als eine nackte Zahl.
  • Wird eine Meldung akzeptiert, ändern sich updatedAt und version des Datensatzes, ein firearm.updated-Ereignis feuert, und ein Conditional Request antwortet nicht mehr mit 304.

POST /v1/me/support eröffnet ein Ticket mit Kategorie und gewünschter Priorität; GET /v1/me/support listet deine, Antworten gehen an /v1/me/support/{ticketId}/replies. Dieselben Tickets erscheinen in deinem Profil auf der Seite. Formen stehen in der Referenz.

Ein technisches Ticket eröffnen
bash
curl -X POST https://api.gunspec.io/v1/me/support \  -H "X-API-Key: your_api_key" \  -H "Content-Type: application/json" \  -d '{    "subject": "Webhook deliveries stopped after rotating the secret",    "category": "technical",    "priority": "normal",    "description": "Endpoint ep_… has returned 401 since 09:40 UTC. Request id 8f3c2b1a."  }'

Request-Body

  • subjectstringerforderlich

    One-line summary of the issue.

  • descriptionstringerforderlich

    Prose summary of the record, where one has been written.

  • categoryenum

    What the ticket is about. Not a firearm or attachment category.

    • billing
    • technical
    • data_quality
    • feature_request
    • other
  • priorityenum

    Triage priority you are asking for. Staff may change it.

    • low
    • normal
    • high
    • urgent

Lebenszyklus

  1. open
  2. in_progress
  3. waiting
  4. resolved
  5. closed
  • Nenne die Request-ID eines fehlgeschlagenen Aufrufs. Sie findet Anfrage, Status und Fehlercode in unseren Logs ohne Hin und Her.
  • Priorität ist dein Wunsch; Mitarbeiter können sie ändern. Studio- und Enterprise-Pläne haben priorisierten bzw. dedizierten Support.
  • Antworten von uns kommen am Ticket und per E-Mail; eine Antwort von dir öffnet ein gelöstes Ticket wieder.

Zwei Elemente sitzen in der Fußzeile jeder Seite.

  • War diese Seite hilfreich: ein Klick, kein Konto. Pro Seite gezählt, damit wir wissen, welche Seiten Arbeit brauchen.
  • Problem melden: ein kurzes Formular, das ein Support-Ticket mit Seite, sichtbarem Endpunkt und URL eröffnet, damit du nie beschreiben musst, wo du warst.
  • Jede Seite hat außerdem Seite kopieren und In ChatGPT / Claude / Perplexity öffnen im Kopf sowie eine Markdown-Version, damit du einen Assistenten dazu befragen und uns schicken kannst, was er falsch hatte.

Meldungen und Tickets prüft eine Person, nie ein Automatismus.

  1. 1Eine Meldung entsteht als pending. Mitarbeiter sehen sie in einer Prüfwarteschlange neben dem betroffenen Datensatz.
  2. 2Sie wechselt zu reviewed, während sie gegen die genannte Quelle und die Herstellerangaben geprüft wird, dann zu resolved oder dismissed, mit Begründung an der Meldung.
  3. 3Eine akzeptierte Korrektur wird über den Katalog-Editor geschrieben: version des Datensatzes ändert sich, Abonnenten werden benachrichtigt, und Caches revalidieren bei der nächsten Anfrage.
  4. 4Ein Ticket wird am Ticket selbst und per E-Mail beantwortet. Feature-Requests bleiben offen, bis sie ausgeliefert oder mit Begründung abgelehnt werden.

Reiche eine Sicherheitslücke nicht als Ticket oder Datenmeldung ein. Schreib vertraulich an security@gunspec.io; die Meldungsrichtlinie deckt Umfang, Safe Harbor und das ab, was du von uns erwarten kannst.