10/15 款服务器配置有货即时交付免安装费

开发者 · API v1.1

DediJet API

小巧且行为可预期的 JSON API。无需密钥即可读取产品目录、实时库存和网络状态。使用在账户中创建的令牌，还可读取您的余额、充值记录、交易记录、已保存的配置和 SSH 密钥。

基础 URLhttps://dedijet.com/api/v1

正在用笔记本电脑打字的 Dex

简介

API 通过 HTTPS 传输 JSON 数据。每个响应都是一个包含 data 键的对象，列表响应还会包含 meta。价格为月费，不含增值税，以 USD 和 EUR 计价；时间戳为 ISO 8601 格式的 UTC 时间。

公开端点以 OpenAPI 3.1 描述，可直接用于代码生成器和 AI 智能体；面向 AI 助手的 DediJet 通俗简介见 llms.txt。

公开端点对所有人开放，并会发送 Access-Control-Allow-Origin: *，因此您可以从浏览器、脚本或监控工具中调用，例如在已售罄的服务器重新有货时收到提醒。

请求
curl -s https://dedijet.com/api/v1/plans/ryzen-9-9950x

身份验证

涉及您账户的端点需要 API 令牌，以 Bearer 令牌形式发送。请在账户的 API 令牌页面中创建和撤销令牌：每个令牌仅显示一次，请将其保存在密钥管理工具中。令牌目前为只读。请妥善保管令牌：任何持有令牌的人都能读取您的账户数据。

请求
curl -s https://dedijet.com/api/v1/account \
  -H "Authorization: Bearer $DEDIJET_TOKEN"

服务器操作。电源、重装系统和救援模式等操作将随在线结账功能一同加入 API。在此之前，服务器在 API 中仅可读取。

错误

错误使用标准 HTTP 状态码，响应体格式统一：

错误响应
{
    "error": {
        "code": "not_found",
        "message": "No plan with this id. List plans with GET /api/v1/plans.",
        "docs": "https://dedijet.com/docs/api#errors"
    }
}
状态状态码含义
400invalid_parameter某个查询参数的值无法识别。
401unauthorized, invalid_token令牌缺失、无效或已被撤销。
404not_found端点或资源 ID 不存在。
405method_not_allowed该端点为只读：请使用 GET。
429rate_limited请求过多；请在 Retry-After 指定的延迟后重试。
503unavailable账户数据暂时不可用；请在 Retry-After 指定的延迟后重试。

速率限制与缓存

公开响应会缓存 60 秒（状态接口为 30 秒），因此更频繁地轮询并不能获得更新的数据。请将每个 IP 的公开请求控制在每分钟 60 次以内。经过身份验证的请求限制为每个令牌每分钟 120 次，且每个经过身份验证的响应都带有 RateLimit-Limit、RateLimit-Remaining 和 RateLimit-Reset 响应头。账户数据从不缓存。

列出配置

公开

GET/api/v1/plans

列出所有服务器配置及其实时库存和价格。可使用查询参数进行筛选。

参数类型说明
familystringentry、performance、enterprise、storage 或 gpu
locationstring机房地点 ID，例如 fra
in_stockboolean设为 1 时，仅返回可立即交付的服务器

请求
curl -s "https://dedijet.com/api/v1/plans?family=performance&in_stock=1"
响应 · 实时数据（节选）
{
    "data": [
        {
            "id": "ryzen-9-9950x",
            "name": "AMD Ryzen 9 9950X",
            "family": "performance",
            "cpu": {
                "model": "AMD Ryzen 9 9950X",
                "cores": 16,
                "threads": 32,
                "base_ghz": 4.3,
                "boost_ghz": 5.7,
                "architecture": "Zen 5",
                "l3_cache_mb": 64
            },
            "memory": {
                "size_gb": 128,
                "type": "DDR5",
                "ecc": false
            },
            "storage": "2 × 2 TB NVMe",
            "gpu": null,
            "network": {
                "port": "1 Gbps",
                "bandwidth": "unmetered",
                "ipv4": 1,
                "ipv6": "/64",
                "ddos_protection": true
            },
            "price": {
                "monthly": {
                    "usd": 269.0,
                    "eur": 234.0
                },
                "setup_fee": 0.0,
                "currency_note": "Monthly, excluding VAT"
            },
            "availability": {
                "in_stock": true,
                "delivery": "instant",
                "locations": [
                    "fra",
                    "ams",
                    "lon",
                    "nyc",
                    "lax",
                    "sin"
                ]
            },
            "links": {
                "page": "https://dedijet.com/servers/ryzen-9-9950x",
                "order": "https://dedijet.com/order/ryzen-9-9950x"
            }
        }
    ],
    "meta": {
        "count": 1,
        "in_stock": 1,
        "generated_at": "2026-10-16T02:10:31Z"
    }
}

获取单个配置

公开

GET/api/v1/plans/{id}

按 ID 获取单个配置。已售罄的配置会附带最接近的有货替代配置的 ID。

参数类型说明
idstring配置 ID，例如 ryzen-9-9950x

请求
curl -s "https://dedijet.com/api/v1/plans/ryzen-9-9950x"
响应 · 实时数据（节选）
{
    "data": {
        "id": "ryzen-9-9950x",
        "name": "AMD Ryzen 9 9950X",
        "family": "performance",
        "cpu": {
            "model": "AMD Ryzen 9 9950X",
            "cores": 16,
            "threads": 32,
            "base_ghz": 4.3,
            "boost_ghz": 5.7,
            "architecture": "Zen 5",
            "l3_cache_mb": 64
        },
        "memory": {
            "size_gb": 128,
            "type": "DDR5",
            "ecc": false
        },
        "storage": "2 × 2 TB NVMe",
        "gpu": null,
        "network": {
            "port": "1 Gbps",
            "bandwidth": "unmetered",
            "ipv4": 1,
            "ipv6": "/64",
            "ddos_protection": true
        },
        "price": {
            "monthly": {
                "usd": 269.0,
                "eur": 234.0
            },
            "setup_fee": 0.0,
            "currency_note": "Monthly, excluding VAT"
        },
        "availability": {
            "in_stock": true,
            "delivery": "instant",
            "locations": [
                "fra",
                "ams",
                "lon",
                "nyc",
                "lax",
                "sin"
            ]
        },
        "links": {
            "page": "https://dedijet.com/servers/ryzen-9-9950x",
            "order": "https://dedijet.com/order/ryzen-9-9950x"
        }
    }
}

列出机房地点

公开

GET/api/v1/locations

列出数据中心地点，包括坐标和有货配置的数量。

请求
curl -s "https://dedijet.com/api/v1/locations"
响应 · 实时数据（节选）
{
    "data": [
        {
            "id": "fra",
            "iata": "FRA",
            "city": "Frankfurt",
            "country": "Germany",
            "country_code": "DE",
            "region": "Europe",
            "coordinates": {
                "lat": 50.1,
                "lon": 8.7
            },
            "plans": 15,
            "plans_in_stock": 10,
            "links": {
                "page": "https://dedijet.com/locations/frankfurt"
            }
        }
    ],
    "meta": {
        "count": 8
    }
}

列出操作系统

公开

GET/api/v1/os

列出可一键安装的操作系统镜像，包括其支持周期，以及从付款确认到上线所需的分钟数。

请求
curl -s "https://dedijet.com/api/v1/os"
响应 · 实时数据（节选）
{
    "data": [
        {
            "id": "ubuntu-2404",
            "name": "Ubuntu 24.04 LTS",
            "family": "Ubuntu",
            "version": "24.04 LTS",
            "support": "Standard support until April 2029",
            "typical_install_minutes": 2,
            "license": null
        }
    ],
    "meta": {
        "count": 15,
        "custom_iso": true
    }
}

网络状态

公开

GET/api/v1/status

各机房地点的组件状态，以及正在发生的故障和计划维护窗口的数量。

请求
curl -s "https://dedijet.com/api/v1/status"
响应 · 实时数据（节选）
{
    "data": {
        "overall": "operational",
        "since": "2026-10-14",
        "locations": {
            "fra": {
                "city": "Frankfurt",
                "components": {
                    "network": "operational",
                    "ddos": "operational",
                    "provisioning": "operational",
                    "ipmi": "operational"
                }
            }
        },
        "ongoing": 0,
        "scheduled": 0,
        "updated_at": "2026-10-16T02:10:31Z"
    }
}

您的账户

需要令牌

GET/api/v1/account

您的账户 ID、邮箱地址和余额，以及是否已启用双重验证（2FA）。

请求
curl -s "https://dedijet.com/api/v1/account" \
  -H "Authorization: Bearer $DEDIJET_TOKEN"
示例响应
{
    "data": {
        "id": "DJ-4KQ8M2X",
        "email": "(your sign-in email)",
        "name": null,
        "balance": {
            "usd": 625.0
        },
        "two_factor": true,
        "created_at": "2026-10-14T09:00:00Z"
    }
}

列出充值记录

需要令牌

GET/api/v1/topups

列出您的充值记录（从新到旧排列），包括状态、币种、到账金额和赠送金额。充值处于等待付款状态时，还会包含付款信息。

参数类型说明
statusstring可选筛选条件：pending、confirming、paid、expired、failed 或 canceled
limitinteger1 至 100，默认为 25
pageinteger页码，从 1 开始
请求
curl -s "https://dedijet.com/api/v1/topups" \
  -H "Authorization: Bearer $DEDIJET_TOKEN"
示例响应
{
    "data": [
        {
            "id": "TU-7K2M9QX4D",
            "status": "paid",
            "amount": {
                "usd": 500.0
            },
            "bonus_percent": 25,
            "coin": "usdt-trc20",
            "ticker": "USDT",
            "network": "TRON (TRC-20)",
            "payment": null,
            "confirmations": 19,
            "confirmations_needed": 19,
            "tx_hash": "9f3c41d2a7b8e05c6d1f2a3b4c5d6e7f8091a2b3c4d5e6f708192a3b4c5d6e7f",
            "credited": {
                "usd": 500.0,
                "bonus_usd": 125.0
            },
            "created_at": "2026-10-14T09:12:00Z",
            "paid_at": "2026-10-14T09:13:10Z",
            "links": {
                "page": "https://dedijet.com/account/billing/topup/TU-7K2M9QX4D"
            }
        }
    ],
    "meta": {
        "count": 1,
        "total": 1,
        "page": 1,
        "pages": 1,
        "limit": 25
    }
}

获取单笔充值

需要令牌

GET/api/v1/topups/{id}

按 ID 获取单笔充值，例如在脚本中跟踪其区块确认进度。此处示例为一笔等待付款的充值。

参数类型说明
idstring充值 ID，例如 TU-9QX4D7K2M
请求
curl -s "https://dedijet.com/api/v1/topups/TU-9QX4D7K2M" \
  -H "Authorization: Bearer $DEDIJET_TOKEN"
示例响应
{
    "data": {
        "id": "TU-9QX4D7K2M",
        "status": "pending",
        "amount": {
            "usd": 1000.0
        },
        "bonus_percent": 50,
        "coin": "btc",
        "ticker": "BTC",
        "network": "Bitcoin",
        "payment": {
            "address": "bc1qar0srrr7xfkvy5l643lydnw9re59gtzzwf5mdq",
            "amount": "0.01563912",
            "memo": null,
            "uri": "bitcoin:bc1qar0srrr7xfkvy5l643lydnw9re59gtzzwf5mdq?amount=0.01563912",
            "rate_locked_until": "2026-10-14T10:30:00Z"
        },
        "confirmations": null,
        "confirmations_needed": 1,
        "tx_hash": null,
        "credited": null,
        "created_at": "2026-10-14T10:00:00Z",
        "paid_at": null,
        "links": {
            "page": "https://dedijet.com/account/billing/topup/TU-9QX4D7K2M"
        }
    }
}

列出余额交易记录

需要令牌

GET/api/v1/transactions

列出余额的每一笔入账和扣款（从新到旧排列），以及每笔交易后的余额。

参数类型说明
limitinteger1 至 100，默认为 50
pageinteger页码，从 1 开始
请求
curl -s "https://dedijet.com/api/v1/transactions" \
  -H "Authorization: Bearer $DEDIJET_TOKEN"
示例响应
{
    "data": [
        {
            "id": 2,
            "type": "bonus",
            "amount": {
                "usd": 125.0
            },
            "balance_after": {
                "usd": 625.0
            },
            "description": "Top-up bonus +25% · TU-7K2M9QX4D",
            "topup": "TU-7K2M9QX4D",
            "created_at": "2026-10-14T09:13:10Z"
        },
        {
            "id": 1,
            "type": "topup",
            "amount": {
                "usd": 500.0
            },
            "balance_after": {
                "usd": 500.0
            },
            "description": "Top-up TU-7K2M9QX4D · USDT",
            "topup": "TU-7K2M9QX4D",
            "created_at": "2026-10-14T09:13:10Z"
        }
    ],
    "meta": {
        "count": 2,
        "total": 2,
        "page": 1,
        "pages": 1,
        "limit": 50,
        "balance": {
            "usd": 625.0
        }
    }
}

列出已保存的配置

需要令牌

GET/api/v1/configurations

列出在配置器中保存的服务器配置，包括月费和可重新打开该配置的链接，便于直接下单。

请求
curl -s "https://dedijet.com/api/v1/configurations" \
  -H "Authorization: Bearer $DEDIJET_TOKEN"
示例响应
{
    "data": [
        {
            "id": "cfg_41",
            "plan": "ryzen-9-9950x",
            "location": "fra",
            "os": "debian-13",
            "hostname": "game1.example.com",
            "options": {
                "ipv4_extra": 2,
                "port_10g": false,
                "nvme": null,
                "hdd_extra": 0,
                "backup": null,
                "raid": "raid1"
            },
            "lines": [
                {
                    "label": "AMD Ryzen 9 9950X",
                    "usd": 269.0,
                    "eur": 234.0
                },
                {
                    "label": "2 additional IPv4",
                    "usd": 5.0,
                    "eur": 4.3
                }
            ],
            "price": {
                "monthly": {
                    "usd": 274.0,
                    "eur": 238.3
                },
                "currency_note": "Monthly, excluding VAT"
            },
            "in_stock": true,
            "created_at": "2026-10-14T09:20:00Z",
            "links": {
                "order": "https://dedijet.com/order/ryzen-9-9950x?loc=fra&os=debian-13&ipv4=2&hostname=game1.example.com"
            }
        }
    ],
    "meta": {
        "count": 1,
        "max": 20
    }
}

列出 SSH 密钥

需要令牌

GET/api/v1/ssh-keys

列出您账户中保存的 SSH 公钥。使用 /api/v1/ssh-keys/{id} 获取单个密钥。

请求
curl -s "https://dedijet.com/api/v1/ssh-keys" \
  -H "Authorization: Bearer $DEDIJET_TOKEN"
示例响应
{
    "data": [
        {
            "id": "key_7",
            "name": "laptop",
            "type": "ssh-ed25519",
            "fingerprint": "SHA256:2YhB0RmRk5hD8b2Fw3nH9L0w1u3c4QeXo6qZ7tP8sVk",
            "public_key": "ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIOMqqnkVzrm0SdG6UOoqKLsabgH5C9okWi0dh2l9GKJl you@laptop",
            "created_at": "2026-10-14T09:05:00Z"
        }
    ],
    "meta": {
        "count": 1
    }
}

列出您的服务器

需要令牌

GET/api/v1/servers

列出您账户中的独立服务器，包括状态、IP 地址和续费日期。使用 /api/v1/servers/{id} 获取单台服务器。

请求
curl -s "https://dedijet.com/api/v1/servers" \
  -H "Authorization: Bearer $DEDIJET_TOKEN"
示例响应
{
    "data": [
        {
            "id": "SV-8M2K4QX",
            "plan": "ryzen-9-9950x",
            "name": "AMD Ryzen 9 9950X",
            "location": "fra",
            "os": "debian-13",
            "hostname": "game1.example.com",
            "ipv4": "203.0.113.10",
            "status": "active",
            "price": {
                "monthly": {
                    "usd": 274.0
                }
            },
            "renews_at": "2026-11-14",
            "created_at": "2026-10-14T09:30:00Z"
        }
    ],
    "meta": {
        "count": 1,
        "active": 1
    }
}