v1 REST API

API ドキュメント

ベース URL

Production:https://api.quickname.tech

レート制限

  • IP アドレスごとに1時間あたり最大3リクエスト。それ以上必要な場合はお問い合わせください。
  • プロジェクトの説明：5〜1024文字
POST/v1/request/リクエストを作成

新しいドメイン検索リクエストを作成します。作成後、リクエストは処理キューに入れられます。

リクエストボディ

フィールドタイプ説明
user_description*stringプロジェクトの説明（5-1024文字）。詳細なほど良い提案が得られます。
zonesstring[]優先ドメインゾーンのリスト（例：["com", "io"]）。オプション。
domain_max_priceintegerドメインの最大価格（USD）。オプション。

リクエスト例

curl -X POST https://api.quickname.tech/v1/request/ \
  -H "Content-Type: application/json" \
  -d '{
    "user_description": "ヴィンテージ時計のオンラインマーケットプレイス",
    "zones": ["com", "io", "tech"],
    "domain_max_price": 100
  }'

レスポンス 201 Created

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "user_description": "ヴィンテージ時計のオンラインマーケットプレイス",
  "zones": ["com", "io", "tech"],
  "domain_max_price": 100,
  "status": "created",
  "results": [],
  "is_valid": true
}
GET/v1/request/{'{'}request_id{'}'}/リクエストステータスを取得

ドメイン検索リクエストの現在の状態（処理ステータスと結果を含む）を返します。

ステータス

created
processing
finished
error

リクエスト例

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

レスポンス 200 OK

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "user_description": "ヴィンテージ時計のオンラインマーケットプレイス",
  "zones": ["com", "io", "tech"],
  "status": "finished",
  "results": [
    {
      "domain": "techmarket.io",
      "price": 45,
      "availability": "available",
      "reasoning": "テクノロジーマーケットプレイスとして'tech'と'market'を組み合わせ"
    }
  ],
  "is_valid": true
}

レスポンスフィールド

Domain オブジェクト

フィールドタイプ説明
domainstring完全なドメイン名（例：example.com）
priceinteger | nullドメイン価格（USD）。null の場合があります。
availabilitystringステータス：available、unavailable、または unknown
reasoningstring | nullこの提案に対する AI の説明

エラーコード

コード説明
400バリデーションエラー — リクエストボディを確認してください
404リクエストが見つからないか期限切れ（24時間）
422無効な UUID 形式
429レート制限超過（3リクエスト/時間）
500内部サーバーエラー
ホームに戻る