API-Dokumentation

Basis-URL

Production:https://api.quickname.tech

Rate-Limits

Maximal 3 Anfragen pro Stunde pro IP-Adresse. Wenn Sie mehr benötigen, kontaktieren Sie uns.
Projektbeschreibung: 5 bis 1024 Zeichen

POST/v1/request/Anfrage erstellen

Erstellt eine neue Domain-Suchanfrage. Nach der Erstellung wird die Anfrage zur Verarbeitung in die Warteschlange gestellt.

Anfragekörper

Feld	Typ	Beschreibung
user_description*	string	Projektbeschreibung (5-1024 Zeichen). Je detaillierter, desto bessere Vorschläge.
zones	string[]	Liste bevorzugter Domain-Zonen (z.B. ["com", "io"]). Optional.
domain_max_price	integer	Maximaler Domain-Preis in USD. Optional.

Beispielanfrage

curl -X POST https://api.quickname.tech/v1/request/ \
  -H "Content-Type: application/json" \
  -d '{
    "user_description": "Online-Marktplatz für Vintage-Uhren",
    "zones": ["com", "io", "tech"],
    "domain_max_price": 100
  }'

Antwort 201 Created

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "user_description": "Online-Marktplatz für Vintage-Uhren",
  "zones": ["com", "io", "tech"],
  "domain_max_price": 100,
  "status": "created",
  "results": [],
  "is_valid": true
}

GET/v1/request/{'{'}request_id{'}'}/Anfragestatus abrufen

Gibt den aktuellen Status einer Domain-Suchanfrage zurück, einschließlich Verarbeitungsstatus und Ergebnisse.

Status

created

processing

finished

error

Beispielanfrage

curl https://api.quickname.tech/v1/request/123e4567-e89b-12d3-a456-426614174000/

Antwort 200 OK

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "user_description": "Online-Marktplatz für Vintage-Uhren",
  "zones": ["com", "io", "tech"],
  "status": "finished",
  "results": [
    {
      "domain": "techmarket.io",
      "price": 45,
      "availability": "available",
      "reasoning": "Kombiniert 'tech' mit 'market' für einen Technologie-Marktplatz"
    }
  ],
  "is_valid": true
}

Antwortfelder

Domain-Objekt

Feld	Typ	Beschreibung
domain	string	Vollständiger Domain-Name (z.B. example.com)
price	integer \| null	Domain-Preis in USD. Kann null sein.
availability	string	Status: available, unavailable oder unknown
reasoning	string \| null	KI-Erklärung für diesen Vorschlag

Fehlercodes

Code	Beschreibung
400	Validierungsfehler — Anfragekörper prüfen
404	Anfrage nicht gefunden oder abgelaufen (24 Stunden)
422	Ungültiges UUID-Format
429	Rate-Limit überschritten (3 Anfragen/Stunde)
500	Interner Serverfehler

Zurück zur Startseite