集成示例代码

以下示例覆盖三种常用语言的完整调用流程：创建路由 → 获取跳转链接 → 投放中使用。所有示例基于 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([
        'name'       => '春季投放-渠道A',
        'page_a'     => 'https://example.com/page-a',
        'page_b'     => 'https://example.com/page-b',
        'split_ratio' => 0.5,
        'default_group' => 'a',
    ]),
]);

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

if ($httpCode === 201) {
    echo '跳转链接: ' . $resp['short_url'];
}

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({
    name: '春季投放-渠道A',
    page_a: 'https://example.com/page-a',
    page_b: 'https://example.com/page-b',
    split_ratio: 0.5,
  }),
});

if (resp.ok) {
  const { short_url } = await resp.json();
  console.log('跳转链接:', short_url);
}

Python 示例

import os, requests

resp = requests.post(
    'https://api.abcloakpro.com/v1/routes',
    headers={'Authorization': f"Bearer {os.environ['ABCLOAKPRO_API_KEY']}"},
    json={
        'name': '春季投放-渠道A',
        'page_a': 'https://example.com/page-a',
        'page_b': 'https://example.com/page-b',
        'split_ratio': 0.5,
        'default_group': 'a',
    },
    timeout=10,
)
resp.raise_for_status()
print('跳转链接:', resp.json()['short_url'])

跳转链接接入方式

• 广告投放：将 short_url 填入投放平台的落地页地址字段
• 自有网站：以服务端 302 跳转接入（不要用前端 JS 跳转，避免影响响应速度）
• 批量管理：通过 GET /v1/routes 拉取全部链接，与您的投放台账对账