集成示例代码

以下示例覆盖三种常用语言的完整调用流程：创建路由 → 投放中使用。所有示例基于 API v1。

PHP 示例

<?php
$apiKey = getenv('ABCLOAKPRO_API_KEY');

$ch = curl_init('https://api.abcloakpro.com/v1/routes');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . $apiKey,
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => json_encode([
        'route_name'    => '春季投放-渠道A',
        'route_type'    => 'TikTok',
        'original_page' => 'https://example.com/page-a',
        'landing_page'  => 'https://example.com/page-b',
    ]),
]);

$resp = json_decode(curl_exec($ch), true);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

if ($httpCode === 201) {
    echo '路由已创建: ' . $resp['data']['route_name'];
}

// IP库检测：识别IP是否为数据中心
$ch2 = curl_init('https://api.abcloakpro.com/v1/ip/check?ip=8.8.8.8');
curl_setopt_array($ch2, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER     => ['Authorization: Bearer ' . $apiKey],
]);
print_r(json_decode(curl_exec($ch2), true)['data']);

JavaScript 示例

const resp = await fetch('https://api.abcloakpro.com/v1/routes', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${process.env.ABCLOAKPRO_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    route_name: '春季投放-渠道A',
    route_type: 'TikTok',
    original_page: 'https://example.com/page-a',
    landing_page: 'https://example.com/page-b',
  }),
});

if (resp.ok) {
  const j = await resp.json();
  console.log('路由已创建:', j.data.route_name);
}

// IP库检测：识别IP是否为数据中心
const ipResp = await fetch('https://api.abcloakpro.com/v1/ip/check?ip=8.8.8.8', {
  headers: { 'Authorization': `Bearer ${process.env.ABCLOAKPRO_API_KEY}` },
});
console.log((await ipResp.json()).data);

Python 示例

import os, requests

resp = requests.post(
    'https://api.abcloakpro.com/v1/routes',
    headers={'Authorization': f"Bearer {os.environ['ABCLOAKPRO_API_KEY']}"},
    json={
        'route_name': '春季投放-渠道A',
        'route_type': 'TikTok',
        'original_page': 'https://example.com/page-a',
        'landing_page': 'https://example.com/page-b',
    },
    timeout=10,
)
resp.raise_for_status()
print('路由已创建:', resp.json()['data']['route_name'])

# IP库检测：识别IP是否为数据中心
ip_resp = requests.get('https://api.abcloakpro.com/v1/ip/check', params={'ip': '8.8.8.8'}, headers={'Authorization': f"Bearer {os.environ['ABCLOAKPRO_API_KEY']}"}, timeout=10)
print(ip_resp.json()['data'])

路由创建后的接入方式

• 域名绑定：通过 API 创建的路由尚未绑定域名，请在控制台「路由管理」完成绑定后投放使用
• 广告投放：将绑定的跳转域名填入投放平台的落地页地址字段
• 自有网站：以服务端 302 跳转接入（不要用前端 JS 跳转，避免影响响应速度）
• 批量管理：通过 GET /v1/routes 拉取全部路由，与您的投放台账对账