快速上手
5 分钟内生成你的第一张运单标签。 一次 API 调用，即可对比 USPS、UPS 和 FedEx 的运费。
开始之前
atoship 账户
前往 atoship.com 免费注册 —— 无需绑定信用卡
充值余额
向钱包充值即可购买标签， 用多少付多少。
获取 API 密钥
进入 控制台 → 设置 → API 密钥，即可生成你的密钥
1
获取运费报价
提交包裹尺寸和收发地址，即可获取所有承运商的实时报价。 atoship 会自动比对 USPS、UPS 和 FedEx，帮你找出最优价格。
JavaScript
// 从多家承运商获取运费报价
const response = await fetch('https://atoship.com/api/v1/rates', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({
from_address: {
name: "Your Store",
street1: "123 Store Street",
city: "San Francisco",
state: "CA",
zip: "94102",
country: "US"
},
to_address: {
name: "John Customer",
street1: "456 Customer Ave",
city: "Los Angeles",
state: "CA",
zip: "90210",
country: "US"
},
parcel: {
weight: 16, // 盎司
length: 12,
width: 8,
height: 6
}
})
});
const rates = await response.json();
// 返回 USPS、UPS、FedEx 的运费报价，含价格与时效预估USPS
Priority Mail、Ground Advantage、First Class
UPS
Ground、2-Day、Next Day Air
FedEx
Ground、Express、Home Delivery
2
生成标签
选定最优报价并生成运单标签，费用将从你的钱包余额中扣除。
生成标签
// 生成运单标签
const response = await fetch('https://atoship.com/api/v1/labels', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({
rate_id: "rate_abc123", // 来自报价接口的返回结果
label_format: "PDF" // PDF、PNG 或 ZPL
})
});
const label = await response.json();
console.log('Tracking:', label.tracking_number);
console.log('Label URL:', label.label_url);
// 下载并打印标签即可！标签已就绪！
返回结果中包含运单跟踪号，以及一个可下载标签 PDF 的链接。 打印出来贴到包裹上，交寄即可！
{
"id": "lbl_abc123",
"tracking_number": "9400111899223344556677",
"label_url": "https://labels.atoship.com/lbl_abc123.pdf",
"carrier": "usps",
"service": "priority_mail",
"cost": 8.45
}