API 文档

使用我们的 RESTful API 轻松集成到您的应用程序中

认证

所有 API 请求需要在 URL 参数中携带 token 进行认证。

URL 参数

token=YOUR_API_TOKEN

您可以在个人中心获取您的 API Token。请妥善保管，不要泄露给他人。

基础信息

GET /api/code/email?token=YOUR_API_TOKEN&productCode=GMAIL_CODE

{
  "code": 0,
  "message": "SUCCESS",
  "data": {
    "uid": "ORD20250102001",
    "account": "example@gmail.com",
    "url": "https://api.xxx.com/..."
  }
}

{
  "code": 101,
  "message": "Insufficient stock",
  "data": null
}

GET /api/code/fetch?token=YOUR_API_TOKEN&uid=ORD20250102001

{
  "code": 0,
  "message": "SUCCESS",
  "data": {
    "code": "123456"
  }
}

{
  "code": 601,
  "message": "Waiting for verification code",
  "data": null
}

GET /api/account/email?token=YOUR_API_TOKEN&productCode=GMAIL_ACCOUNT

{
  "code": 0,
  "message": "SUCCESS",
  "data": {
    "uid": "ORD20250102001",
    "account": "example@gmail.com",
    "password": "abc123",
    "recoverAccount": "recover@...",
    "text": "example@gmail.com----..."
  }
}

{
  "code": 101,
  "message": "Insufficient stock",
  "data": null
}

GET /api/user/balance?token=YOUR_API_TOKEN

{
  "code": 0,
  "message": "SUCCESS",
  "data": {
    "username": "xxxxx",
    "balance": 94686.294
  }
}

错误代码

响应格式：code=0 表示成功，code≠0 表示失败，message 字段包含错误信息

代码示例

JavaScript (Node.js)

// Step 1: Get verification code email
const emailRes = await fetch('https://gapi.mailsapi.com/api/code/email?token=YOUR_API_TOKEN&productCode=GMAIL_CODE');
const emailData = await emailRes.json();

if (emailData.code === 0) {
  console.log('Email:', emailData.data.account);
  console.log('UID:', emailData.data.uid);

  // Step 2: Fetch verification code (poll until received)
  const fetchCode = async () => {
    const codeRes = await fetch(`https://gapi.mailsapi.com/api/code/fetch?token=YOUR_API_TOKEN&uid=${emailData.data.uid}`);
    const codeData = await codeRes.json();

    if (codeData.code === 0 && codeData.data.code) {
      console.log('Verification Code:', codeData.data.code);
      return codeData.data.code;
    }
    // Wait and retry if code not yet available
    await new Promise(r => setTimeout(r, 3000));
    return fetchCode();
  };

  await fetchCode();
}

Python

import requests
import time

API_TOKEN = 'YOUR_API_TOKEN'
BASE_URL = 'https://gapi.mailsapi.com'

# Step 1: Get verification code email
email_res = requests.get(f'{BASE_URL}/api/code/email', params={
    'token': API_TOKEN,
    'productCode': 'GMAIL_CODE'
})
email_data = email_res.json()

if email_data['code'] == 0:
    print(f"Email: {email_data['data']['account']}")
    uid = email_data['data']['uid']

    # Step 2: Fetch verification code (poll until received)
    while True:
        code_res = requests.get(f'{BASE_URL}/api/code/fetch', params={
            'token': API_TOKEN,
            'uid': uid
        })
        code_data = code_res.json()

        if code_data['code'] == 0 and code_data['data'].get('code'):
            print(f"Verification Code: {code_data['data']['code']}")
            break

        time.sleep(3)  # Wait 3 seconds before retry