MyName 網域註冊服務

MyName API 文件

MyName 網域註冊服務的完整 API 技術文件。

網域註冊 網域轉移 會員系統 購物車 付款系統

概述

MyName API 提供完整的網域註冊和管理功能,讓開發者可以將網域服務整合到自己的應用程式中。

  • 會員管理:註冊、登入、資料管理
  • 網域查詢:檢查網域可用性
  • 網域註冊:註冊新網域
  • 網域轉移:轉入/轉出網域
  • 網域續約:續約已註冊網域
  • 購物車系統:商品加入購物車、結帳
  • 訂單管理:查詢訂單狀態
  • 付款整合:支援多種付款方式

注意: MyName API 基於 WebNIC API v2 構建,提供更簡化的介面和額外功能。

API 網址

MyName API 提供以下基礎網址:

Base URLs
正式環境:
https://2cctel.1ccgo.com/myname/api/

測試環境:
https://2cctel.1ccgo.com/myname/api/test/

提示: 開發時請使用測試環境,避免影響正式環境的資料。

認證

MyName API 使用 Session-based 認證或 API Key 認證。

Session 認證

用於網頁應用

使用者登入後,後續請求會自動使用 Session 認證。

API Key 認證

用於第三方整合

X-API-Key: your_api_key_here

注意: API Key 可以在會員後台的「開發者設定」中產生和管理。

註冊會員

建立新的會員帳號。

POST /auth/register
註冊新會員

請求參數

參數 類型 說明 必填
email string 電子郵件地址 必填
password string 密碼(至少 8 個字元) 必填
name string 姓名 必填
phone string 電話號碼 選填
company string 公司名稱 選填

請求範例

JSON
{
  "email": "user@example.com",
  "password": "securepassword123",
  "name": "王小明",
  "phone": "0912345678",
  "company": "範例有限公司"
}

回應範例

JSON
{
  "success": true,
  "message": "註冊成功",
  "data": {
    "user_id": 123,
    "email": "user@example.com",
    "name": "王小明"
  }
}

注意: 註冊成功後會自動登入,並發送驗證郵件到註冊的電子郵件地址。

會員登入

會員登入取得 Session。

POST /auth/login
會員登入

請求參數

參數 類型 說明 必填
email string 電子郵件地址 必填
password string 密碼 必填
remember boolean 記住登入狀態 選填

請求範例

JSON
{
  "email": "user@example.com",
  "password": "securepassword123",
  "remember": true
}

回應範例

JSON
{
  "success": true,
  "message": "登入成功",
  "data": {
    "user_id": 123,
    "email": "user@example.com",
    "name": "王小明",
    "session_id": "abc123def456"
  }
}

重要: 連續登入失敗 5 次會暫時鎖定帳號 30 分鐘。

網域查詢

檢查網域是否可註冊,並取得價格資訊。

GET /domain/check
查詢網域可用性

請求參數

參數 類型 說明 必填
domain string 網域名稱(例如:example.com) 必填
tlds array 要查詢的頂級域名陣列(例如:["com", "net", "tw"]) 選填

請求範例

HTTP
GET https://2cctel.1ccgo.com/myname/api/domain/check?domain=example&tlds[]=com&tlds[]=net&tlds[]=tw

回應範例

JSON
{
  "success": true,
  "data": [
    {
      "domain": "example.com",
      "available": true,
      "price": 12.00,
      "currency": "TWD",
      "promo_price": 10.00,
      "registration_periods": [1, 2, 3, 5, 10]
    },
    {
      "domain": "example.net",
      "available": true,
      "price": 15.00,
      "currency": "TWD",
      "registration_periods": [1, 2, 3, 5, 10]
    },
    {
      "domain": "example.tw",
      "available": false,
      "price": 20.00,
      "currency": "TWD",
      "status": "registered"
    }
  ]
}

提示: 可以一次查詢多個頂級域名,方便使用者比較價格和可用性。

更多功能

MyName API 還提供更多功能,包括網域註冊、轉移、購物車系統和付款整合。

其他可用功能:

網域註冊 網域轉移 購物車系統 付款整合 訂單管理