开发者 API参考帮助 - 短网址生成

入门

验证

速率限制

响应处理

开发者 API参考帮助 v3

入门

系统处理请求需要 API 密钥。用户注册后，系统会自动为该用户生成 API 密钥。 API 密钥必须随每个请求一起发送（参见下面的完整示例）。如果 API 密钥未发送或已过期，则会出现错误。请确保对您的 API 密钥保密，以防止滥用。

验证

要使用 API 系统进行身份验证，您需要将 API 密钥作为授权令牌与每个请求一起发送。您可以在下面查看示例代码。

cURL PHP

curl --location --request POST 'https://onelinker.cn/api/url/add' \
--header 'Authorization: Bearer YOURAPIKEY' \
--header 'Content-Type: application/json' \

$curl = curl_init();
curl_setopt_array($curl, array(
    CURLOPT_URL => "https://onelinker.cn/api/url/add",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_ENCODING => "",
    CURLOPT_MAXREDIRS => 2,
    CURLOPT_TIMEOUT => 10,
    CURLOPT_FOLLOWLOCATION => true,
    CURLOPT_CUSTOMREQUEST => "POST",
    CURLOPT_HTTPHEADER => array(
    "Authorization: Bearer YOURAPIKEY",
    "Content-Type: application/json",
    ),
));

$response = curl_exec($curl);

速率限制

我们的 API 有一个速率限制器来防止请求激增，以最大限度地提高其稳定性。我们的速率限制器目前的上限为每 1 分钟 30 个请求。

几个标头将与响应一起发送，可以检查这些标头以确定有关请求的各种信息。

X-RateLimit-Limit: 30
X-RateLimit-Remaining: 29
X-RateLimit-Reset: TIMESTAMP

响应处理

默认情况下，所有 API 响应都以 JSON 格式返回。要将其转换为可用数据，需要根据语言使用适当的函数。在 PHP 中，函数 json_decode() 可用于将数据转换为对象（默认）或数组（将第二个参数设置为 true）。检查错误键非常重要，因为它提供了有关是否存在错误的信息。您还可以检查标题代码。

{
    "error": 1,
    "message": "An error ocurred"
}

CTA 覆盖层

CTA覆盖层列表

GET https://onelinker.cn/api/overlay?limit=2&page=1

要通过API获取CTA覆盖层，您可以使用此接口。您还可以过滤数据（有关更多信息，请参阅表格）

参数	描述
limit	（可选）每页最多显示的结果的数量
page	（可选）当前请求的页码

cURL PHP

curl --location --request GET 'https://onelinker.cn/api/overlay?limit=2&page=1' \
--header 'Authorization: Bearer YOURAPIKEY' \
--header 'Content-Type: application/json' \

$curl = curl_init();

curl_setopt_array($curl, array(
    CURLOPT_URL => "https://onelinker.cn/api/overlay?limit=2&page=1",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_ENCODING => "",
    CURLOPT_MAXREDIRS => 2,
    CURLOPT_TIMEOUT => 10,
    CURLOPT_FOLLOWLOCATION => true,
    CURLOPT_CUSTOMREQUEST => "GET",
    CURLOPT_HTTPHEADER => array(
        "Authorization: Bearer YOURAPIKEY",
        "Content-Type: application/json",
    ),
    
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

服务器响应

{
    "error": "0",
    "data": {
        "result": 2,
        "perpage": 2,
        "currentpage": 1,
        "nextpage": 1,
        "maxpage": 1,
        "cta": [
            {
                "id": 1,
                "type": "message",
                "name": "Product 1 Promo",
                "date": "2020-11-10 18:00:00"
            },
            {
                "id": 2,
                "type": "contact",
                "name": "Contact Page",
                "date": "2020-11-10 18:10:00"
            }
        ]
    }
}

二维码

QR二维码列表

GET https://onelinker.cn/api/qr?limit=2&page=1

通过API获取您的二维码，您可以使用此接口。您还可以过滤数据（详见表格获取更多信息）。

参数	描述
limit	（可选）每页最多显示的结果的数量
page	（可选）当前请求的页码

cURL PHP

curl --location --request GET 'https://onelinker.cn/api/qr?limit=2&page=1' \
--header 'Authorization: Bearer YOURAPIKEY' \
--header 'Content-Type: application/json' \

$curl = curl_init();

curl_setopt_array($curl, array(
    CURLOPT_URL => "https://onelinker.cn/api/qr?limit=2&page=1",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_ENCODING => "",
    CURLOPT_MAXREDIRS => 2,
    CURLOPT_TIMEOUT => 10,
    CURLOPT_FOLLOWLOCATION => true,
    CURLOPT_CUSTOMREQUEST => "GET",
    CURLOPT_HTTPHEADER => array(
        "Authorization: Bearer YOURAPIKEY",
        "Content-Type: application/json",
    ),
    
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

服务器响应

{
    "error": "0",
    "data": {
        "result": 2,
        "perpage": 2,
        "currentpage": 1,
        "nextpage": 1,
        "maxpage": 1,
        "qrs": [
            {
                "id": 2,
                "link": "https:\/\/onelinker.cn\/qr\/a2d5e",
                "scans": 0,
                "name": "Google",
                "date": "2020-11-10 18:01:43"
            },
            {
                "id": 1,
                "link": "https:\/\/onelinker.cn\/qr\/b9edfe",
                "scans": 5,
                "name": "Google Canada",
                "date": "2020-11-10 18:00:25"
            }
        ]
    }
}

获取单个二维码

GET https://onelinker.cn/api/qr/:id

通过API获取单个二维码的详细信息，您可以使用此接口。

cURL PHP

curl --location --request GET 'https://onelinker.cn/api/qr/:id' \
--header 'Authorization: Bearer YOURAPIKEY' \
--header 'Content-Type: application/json' \

$curl = curl_init();

curl_setopt_array($curl, array(
    CURLOPT_URL => "https://onelinker.cn/api/qr/:id",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_ENCODING => "",
    CURLOPT_MAXREDIRS => 2,
    CURLOPT_TIMEOUT => 10,
    CURLOPT_FOLLOWLOCATION => true,
    CURLOPT_CUSTOMREQUEST => "GET",
    CURLOPT_HTTPHEADER => array(
        "Authorization: Bearer YOURAPIKEY",
        "Content-Type: application/json",
    ),
    
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

服务器响应

{
    "error": 0,
    "details": {
        "id": 1,
        "link": "https:\/\/onelinker.cn\/qr\/b9edfe",
        "scans": 5,
        "name": "Google Canada",
        "date": "2020-11-10 18:00:25"
    },
    "data": {
        "clicks": 1,
        "uniqueClicks": 1,
        "topCountries": {
            "Unknown": "1"
        },
        "topReferrers": {
            "Direct, email and other": "1"
        },
        "topBrowsers": {
            "Chrome": "1"
        },
        "topOs": {
            "Windows 10": "1"
        },
        "socialCount": {
            "facebook": 0,
            "twitter": 0,
            "instagram": 0
        }
    }
}

创建二维码

POST https://onelinker.cn/api/qr/add

要创建二维码，您需要通过POST请求以JSON格式发送有效数据。数据必须作为请求的原始主体发送，如下所示。下面的示例展示了您可以发送的所有参数，但不要求发送所有参数（请参阅表格获取更多信息）。

参数	描述
type	(必填) 文本 \| vCard \| 链接 \| 电子邮件 \| 电话 \| 短信 \| WiFi
data	(必填) 要嵌入二维码内的数据。根据类型，数据可以是字符串或数组。
background	(可选) RGB颜色，例如rgb(255,255,255)
foreground	(可选) RGB颜色，例如rgb(0,0,0)
logo	(可选) 徽标的路径，可以是png或jpg

cURL PHP

curl --location --request POST 'https://onelinker.cn/api/qr/add' \
--header 'Authorization: Bearer YOURAPIKEY' \
--header 'Content-Type: application/json' \
--data-raw '{
    "type": "link",
    "data": "https:\/\/google.com",
    "background": "rgb(255,255,255)",
    "foreground": "rgb(0,0,0)",
    "logo": "https:\/\/site.com\/logo.png"
}'

$curl = curl_init();

curl_setopt_array($curl, array(
    CURLOPT_URL => "https://onelinker.cn/api/qr/add",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_ENCODING => "",
    CURLOPT_MAXREDIRS => 2,
    CURLOPT_TIMEOUT => 10,
    CURLOPT_FOLLOWLOCATION => true,
    CURLOPT_CUSTOMREQUEST => "POST",
    CURLOPT_HTTPHEADER => array(
        "Authorization: Bearer YOURAPIKEY",
        "Content-Type: application/json",
    ),
    CURLOPT_POSTFIELDS => json_encode(array (
  'type' => 'link',
  'data' => 'https://google.com',
  'background' => 'rgb(255,255,255)',
  'foreground' => 'rgb(0,0,0)',
  'logo' => 'https://site.com/logo.png',
)),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

服务器响应

{
    "error": 0,
    "id": 3,
    "link": "https:\/\/onelinker.cn\/qr\/a58f79"
}

Update QR Code

PUT https://onelinker.cn/api/qr/:id/update

要更新二维码，您需要通过PUT请求以JSON格式发送有效数据。数据必须作为请求的原始主体发送，如下所示。下面的示例展示了您可以发送的所有参数，但不要求发送所有参数（请参阅表格获取更多信息）。

参数	描述
data	(必填) 要嵌入二维码内的数据。根据类型，数据可以是字符串或数组。
background	(可选) RGB颜色，例如rgb(255,255,255)
foreground	(可选) RGB颜色，例如rgb(0,0,0)
logo	(可选) 徽标的路径，可以是png或jpg

cURL PHP

curl --location --request PUT 'https://onelinker.cn/api/qr/:id/update' \
--header 'Authorization: Bearer YOURAPIKEY' \
--header 'Content-Type: application/json' \
--data-raw '{
    "type": "link",
    "data": "https:\/\/google.com",
    "background": "rgb(255,255,255)",
    "foreground": "rgb(0,0,0)",
    "logo": "https:\/\/site.com\/logo.png"
}'

$curl = curl_init();

curl_setopt_array($curl, array(
    CURLOPT_URL => "https://onelinker.cn/api/qr/:id/update",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_ENCODING => "",
    CURLOPT_MAXREDIRS => 2,
    CURLOPT_TIMEOUT => 10,
    CURLOPT_FOLLOWLOCATION => true,
    CURLOPT_CUSTOMREQUEST => "PUT",
    CURLOPT_HTTPHEADER => array(
        "Authorization: Bearer YOURAPIKEY",
        "Content-Type: application/json",
    ),
    CURLOPT_POSTFIELDS => json_encode(array (
  'type' => 'link',
  'data' => 'https://google.com',
  'background' => 'rgb(255,255,255)',
  'foreground' => 'rgb(0,0,0)',
  'logo' => 'https://site.com/logo.png',
)),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

服务器响应

{
    "error": 0,
    "message": "QR has been updated successfully."
}

删除二维码

DELETE https://onelinker.cn/api/qr/:id/delete

要删除二维码，您需要发送DELETE请求。

cURL PHP

curl --location --request DELETE 'https://onelinker.cn/api/qr/:id/delete' \
--header 'Authorization: Bearer YOURAPIKEY' \
--header 'Content-Type: application/json' \

$curl = curl_init();

curl_setopt_array($curl, array(
    CURLOPT_URL => "https://onelinker.cn/api/qr/:id/delete",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_ENCODING => "",
    CURLOPT_MAXREDIRS => 2,
    CURLOPT_TIMEOUT => 10,
    CURLOPT_FOLLOWLOCATION => true,
    CURLOPT_CUSTOMREQUEST => "DELETE",
    CURLOPT_HTTPHEADER => array(
        "Authorization: Bearer YOURAPIKEY",
        "Content-Type: application/json",
    ),
    
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

服务器响应

{
    "error": 0,
    "message": "QR Code has been deleted successfully."
}

像素

像素列表

GET https://onelinker.cn/api/pixels?limit=2&page=1

通过API获取您的像素代码，您可以使用此接口。您还可以过滤数据（详见表格获取更多信息）。

参数	描述
limit	（可选）每页最多显示的结果的数量
page	（可选）当前请求的页码

cURL PHP

curl --location --request GET 'https://onelinker.cn/api/pixels?limit=2&page=1' \
--header 'Authorization: Bearer YOURAPIKEY' \
--header 'Content-Type: application/json' \

$curl = curl_init();

curl_setopt_array($curl, array(
    CURLOPT_URL => "https://onelinker.cn/api/pixels?limit=2&page=1",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_ENCODING => "",
    CURLOPT_MAXREDIRS => 2,
    CURLOPT_TIMEOUT => 10,
    CURLOPT_FOLLOWLOCATION => true,
    CURLOPT_CUSTOMREQUEST => "GET",
    CURLOPT_HTTPHEADER => array(
        "Authorization: Bearer YOURAPIKEY",
        "Content-Type: application/json",
    ),
    
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

服务器响应

{
    "error": "0",
    "data": {
        "result": 2,
        "perpage": 2,
        "currentpage": 1,
        "nextpage": 1,
        "maxpage": 1,
        "pixels": [
            {
                "id": 1,
                "type": "gtmpixel",
                "name": "GTM Pixel",
                "tag": "GA-123456789",
                "date": "2020-11-10 18:00:00"
            },
            {
                "id": 2,
                "type": "twitterpixel",
                "name": "Twitter Pixel",
                "tag": "1234567",
                "date": "2020-11-10 18:10:00"
            }
        ]
    }
}

创建像素

POST https://onelinker.cn/api/pixel/add

可以使用此接口创建像素。您需要发送像素类型和标签。

参数	描述
type	(required) gtmpixel \| gapixel \| fbpixel \| adwordspixel \| linkedinpixel \| twitterpixel \| adrollpixel \| quorapixel \| pinterest \| bing \| snapchat \| reddit \| tiktok
name	(必填) 您的像素的自定义名称
tag	(必填) 像素的标签

cURL PHP

curl --location --request POST 'https://onelinker.cn/api/pixel/add' \
--header 'Authorization: Bearer YOURAPIKEY' \
--header 'Content-Type: application/json' \
--data-raw '{
    "type": "gtmpixel",
    "name": "My GTM",
    "tag": "GTM-ABCDE"
}'

$curl = curl_init();

curl_setopt_array($curl, array(
    CURLOPT_URL => "https://onelinker.cn/api/pixel/add",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_ENCODING => "",
    CURLOPT_MAXREDIRS => 2,
    CURLOPT_TIMEOUT => 10,
    CURLOPT_FOLLOWLOCATION => true,
    CURLOPT_CUSTOMREQUEST => "POST",
    CURLOPT_HTTPHEADER => array(
        "Authorization: Bearer YOURAPIKEY",
        "Content-Type: application/json",
    ),
    CURLOPT_POSTFIELDS => json_encode(array (
  'type' => 'gtmpixel',
  'name' => 'My GTM',
  'tag' => 'GTM-ABCDE',
)),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

服务器响应

{
    "error": 0,
    "id": 1
}

更新像素

PUT https://onelinker.cn/api/pixel/:id/update

要更新像素，您需要通过PUT请求以JSON格式发送有效数据。数据必须作为请求的原始主体发送，如下所示。下面的示例展示了您可以发送的所有参数，但不要求发送所有参数（请参阅表格获取更多信息）。

参数	描述
name	(可选) 您的像素的自定义名称
tag	(必填) 像素的标签

cURL PHP

curl --location --request PUT 'https://onelinker.cn/api/pixel/:id/update' \
--header 'Authorization: Bearer YOURAPIKEY' \
--header 'Content-Type: application/json' \
--data-raw '{
    "name": "My GTM",
    "tag": "GTM-ABCDE"
}'

$curl = curl_init();

curl_setopt_array($curl, array(
    CURLOPT_URL => "https://onelinker.cn/api/pixel/:id/update",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_ENCODING => "",
    CURLOPT_MAXREDIRS => 2,
    CURLOPT_TIMEOUT => 10,
    CURLOPT_FOLLOWLOCATION => true,
    CURLOPT_CUSTOMREQUEST => "PUT",
    CURLOPT_HTTPHEADER => array(
        "Authorization: Bearer YOURAPIKEY",
        "Content-Type: application/json",
    ),
    CURLOPT_POSTFIELDS => json_encode(array (
  'name' => 'My GTM',
  'tag' => 'GTM-ABCDE',
)),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

服务器响应

{
    "error": 0,
    "message": "Pixel has been updated successfully."
}

删除像素

DELETE https://onelinker.cn/api/pixel/:id/delete

要删除像素，您需要发送DELETE请求。

cURL PHP

curl --location --request DELETE 'https://onelinker.cn/api/pixel/:id/delete' \
--header 'Authorization: Bearer YOURAPIKEY' \
--header 'Content-Type: application/json' \

$curl = curl_init();

curl_setopt_array($curl, array(
    CURLOPT_URL => "https://onelinker.cn/api/pixel/:id/delete",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_ENCODING => "",
    CURLOPT_MAXREDIRS => 2,
    CURLOPT_TIMEOUT => 10,
    CURLOPT_FOLLOWLOCATION => true,
    CURLOPT_CUSTOMREQUEST => "DELETE",
    CURLOPT_HTTPHEADER => array(
        "Authorization: Bearer YOURAPIKEY",
        "Content-Type: application/json",
    ),
    
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

服务器响应

{
    "error": 0,
    "message": "Pixel has been deleted successfully."
}

品牌域名

品牌域名列表

GET https://onelinker.cn/api/domains?limit=2&page=1

要通过API获取您的品牌化域名，您可以使用此接口。您还可以过滤数据（有关更多信息，请参阅表格）

参数	描述
limit	（可选）每页最多显示的结果的数量
page	（可选）当前请求的页码

cURL PHP

curl --location --request GET 'https://onelinker.cn/api/domains?limit=2&page=1' \
--header 'Authorization: Bearer YOURAPIKEY' \
--header 'Content-Type: application/json' \

$curl = curl_init();

curl_setopt_array($curl, array(
    CURLOPT_URL => "https://onelinker.cn/api/domains?limit=2&page=1",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_ENCODING => "",
    CURLOPT_MAXREDIRS => 2,
    CURLOPT_TIMEOUT => 10,
    CURLOPT_FOLLOWLOCATION => true,
    CURLOPT_CUSTOMREQUEST => "GET",
    CURLOPT_HTTPHEADER => array(
        "Authorization: Bearer YOURAPIKEY",
        "Content-Type: application/json",
    ),
    
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

服务器响应

{
    "error": "0",
    "data": {
        "result": 2,
        "perpage": 2,
        "currentpage": 1,
        "nextpage": 1,
        "maxpage": 1,
        "domains": [
            {
                "id": 1,
                "domain": "https:\/\/domain1.com",
                "redirectroot": "https:\/\/rootdomain.com",
                "redirect404": "https:\/\/rootdomain.com\/404"
            },
            {
                "id": 2,
                "domain": "https:\/\/domain2.com",
                "redirectroot": "https:\/\/rootdomain2.com",
                "redirect404": "https:\/\/rootdomain2.com\/404"
            }
        ]
    }
}

创建品牌域名

POST https://onelinker.cn/api/domain/add

可以使用此接口添加一个域名。请确保您的域名正确指向我们的服务器。

参数	描述
domain	（必填）包含http或https的品牌域名
redirectroot	（可选）当别人访问您的根域名时自动跳转到该域名
redirect404	（可选）如果未找到短 url，则重定向到此页面（错误 404）

cURL PHP

curl --location --request POST 'https://onelinker.cn/api/domain/add' \
--header 'Authorization: Bearer YOURAPIKEY' \
--header 'Content-Type: application/json' \
--data-raw '{
    "domain": "https:\/\/domain1.com",
    "redirectroot": "https:\/\/rootdomain.com",
    "redirect404": "https:\/\/rootdomain.com\/404"
}'

$curl = curl_init();

curl_setopt_array($curl, array(
    CURLOPT_URL => "https://onelinker.cn/api/domain/add",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_ENCODING => "",
    CURLOPT_MAXREDIRS => 2,
    CURLOPT_TIMEOUT => 10,
    CURLOPT_FOLLOWLOCATION => true,
    CURLOPT_CUSTOMREQUEST => "POST",
    CURLOPT_HTTPHEADER => array(
        "Authorization: Bearer YOURAPIKEY",
        "Content-Type: application/json",
    ),
    CURLOPT_POSTFIELDS => json_encode(array (
  'domain' => 'https://domain1.com',
  'redirectroot' => 'https://rootdomain.com',
  'redirect404' => 'https://rootdomain.com/404',
)),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

服务器响应

{
    "error": 0,
    "id": 1
}

更新域

PUT https://onelinker.cn/api/domain/:id/update

要更新品牌化域名，您需要通过PUT请求以JSON格式发送有效数据。数据必须作为请求的原始主体发送，如下所示。下面的示例展示了您可以发送的所有参数，但不要求发送所有参数（请参阅表格获取更多信息）

参数	描述
redirectroot	（可选）当别人访问您的根域名时自动跳转到该域名
redirect404	（可选）如果未找到短 url，则重定向到此页面（错误 404）

cURL PHP

curl --location --request PUT 'https://onelinker.cn/api/domain/:id/update' \
--header 'Authorization: Bearer YOURAPIKEY' \
--header 'Content-Type: application/json' \
--data-raw '{
    "redirectroot": "https:\/\/rootdomain-new.com",
    "redirect404": "https:\/\/rootdomain-new.com\/404"
}'

$curl = curl_init();

curl_setopt_array($curl, array(
    CURLOPT_URL => "https://onelinker.cn/api/domain/:id/update",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_ENCODING => "",
    CURLOPT_MAXREDIRS => 2,
    CURLOPT_TIMEOUT => 10,
    CURLOPT_FOLLOWLOCATION => true,
    CURLOPT_CUSTOMREQUEST => "PUT",
    CURLOPT_HTTPHEADER => array(
        "Authorization: Bearer YOURAPIKEY",
        "Content-Type: application/json",
    ),
    CURLOPT_POSTFIELDS => json_encode(array (
  'redirectroot' => 'https://rootdomain-new.com',
  'redirect404' => 'https://rootdomain-new.com/404',
)),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

服务器响应

{
    "error": 0,
    "message": "Domain has been updated successfully."
}

删除域名

DELETE https://onelinker.cn/api/domain/:id/delete

要删除域名，你需要发送DELETE请求

cURL PHP

curl --location --request DELETE 'https://onelinker.cn/api/domain/:id/delete' \
--header 'Authorization: Bearer YOURAPIKEY' \
--header 'Content-Type: application/json' \

$curl = curl_init();

curl_setopt_array($curl, array(
    CURLOPT_URL => "https://onelinker.cn/api/domain/:id/delete",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_ENCODING => "",
    CURLOPT_MAXREDIRS => 2,
    CURLOPT_TIMEOUT => 10,
    CURLOPT_FOLLOWLOCATION => true,
    CURLOPT_CUSTOMREQUEST => "DELETE",
    CURLOPT_HTTPHEADER => array(
        "Authorization: Bearer YOURAPIKEY",
        "Content-Type: application/json",
    ),
    
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

服务器响应

{
    "error": 0,
    "message": "Domain has been deleted successfully."
}

广告管理

活动列表

GET https://onelinker.cn/api/campaigns?limit=2&page=1

要通过API获取您的广告活动，您可以使用此接口。您还可以过滤数据（有关更多信息，请参阅表格）

参数	描述
limit	（可选）每页最多显示的结果的数量
page	（可选）当前请求的页码

cURL PHP

curl --location --request GET 'https://onelinker.cn/api/campaigns?limit=2&page=1' \
--header 'Authorization: Bearer YOURAPIKEY' \
--header 'Content-Type: application/json' \

$curl = curl_init();

curl_setopt_array($curl, array(
    CURLOPT_URL => "https://onelinker.cn/api/campaigns?limit=2&page=1",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_ENCODING => "",
    CURLOPT_MAXREDIRS => 2,
    CURLOPT_TIMEOUT => 10,
    CURLOPT_FOLLOWLOCATION => true,
    CURLOPT_CUSTOMREQUEST => "GET",
    CURLOPT_HTTPHEADER => array(
        "Authorization: Bearer YOURAPIKEY",
        "Content-Type: application/json",
    ),
    
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

服务器响应

{
    "error": "0",
    "data": {
        "result": 2,
        "perpage": 2,
        "currentpage": 1,
        "nextpage": 1,
        "maxpage": 1,
        "campaigns": [
            {
                "id": 1,
                "name": "Sample Campaign",
                "public": false,
                "rotator": false,
                "list": "https:\/\/domain.com\/u\/admin\/list-1"
            },
            {
                "id": 2,
                "domain": "Facebook Campaign",
                "public": true,
                "rotator": "https:\/\/domain.com\/r\/test",
                "list": "https:\/\/domain.com\/u\/admin\/test-2"
            }
        ]
    }
}

创建活动

POST https://onelinker.cn/api/campaign/add

可以使用此接口添加广告活动。

参数	描述
name	（可选）活动名称
slug	（可选）轮播器别名
public	（可选）访问权限

cURL PHP

curl --location --request POST 'https://onelinker.cn/api/campaign/add' \
--header 'Authorization: Bearer YOURAPIKEY' \
--header 'Content-Type: application/json' \
--data-raw '{
    "name": "New Campaign",
    "slug": "new-campaign",
    "public": true
}'

$curl = curl_init();

curl_setopt_array($curl, array(
    CURLOPT_URL => "https://onelinker.cn/api/campaign/add",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_ENCODING => "",
    CURLOPT_MAXREDIRS => 2,
    CURLOPT_TIMEOUT => 10,
    CURLOPT_FOLLOWLOCATION => true,
    CURLOPT_CUSTOMREQUEST => "POST",
    CURLOPT_HTTPHEADER => array(
        "Authorization: Bearer YOURAPIKEY",
        "Content-Type: application/json",
    ),
    CURLOPT_POSTFIELDS => json_encode(array (
  'name' => 'New Campaign',
  'slug' => 'new-campaign',
  'public' => true,
)),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

服务器响应

{
    "error": 0,
    "id": 3,
    "domain": "New Campaign",
    "public": true,
    "rotator": "https:\/\/domain.com\/r\/new-campaign",
    "list": "https:\/\/domain.com\/u\/admin\/new-campaign-3"
}

将链接分配给广告活动

POST https://onelinker.cn/api/campaign/:campaignid/assign/:linkid

可以使用此接口将短链接分配给广告活动。此接口需要广告活动ID和短链接ID。

cURL PHP

curl --location --request POST 'https://onelinker.cn/api/campaign/:campaignid/assign/:linkid' \
--header 'Authorization: Bearer YOURAPIKEY' \
--header 'Content-Type: application/json' \

$curl = curl_init();

curl_setopt_array($curl, array(
    CURLOPT_URL => "https://onelinker.cn/api/campaign/:campaignid/assign/:linkid",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_ENCODING => "",
    CURLOPT_MAXREDIRS => 2,
    CURLOPT_TIMEOUT => 10,
    CURLOPT_FOLLOWLOCATION => true,
    CURLOPT_CUSTOMREQUEST => "POST",
    CURLOPT_HTTPHEADER => array(
        "Authorization: Bearer YOURAPIKEY",
        "Content-Type: application/json",
    ),
    
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

服务器响应

{
    "error": 0,
    "message": "Link successfully added to the campaign."
}

更新活动

PUT https://onelinker.cn/api/campaign/:id/update

要更新广告活动，您需要通过PUT请求发送有效的JSON数据。数据必须按照下面所示发送为请求的原始主体。下面的示例显示了您可以发送的所有参数，但不必发送所有参数（有关更多信息，请参阅表格）

参数	描述
name	（必填）活动名称
slug	（可选）轮播器别名
public	（可选）访问权限

cURL PHP

curl --location --request PUT 'https://onelinker.cn/api/campaign/:id/update' \
--header 'Authorization: Bearer YOURAPIKEY' \
--header 'Content-Type: application/json' \
--data-raw '{
    "name": "Twitter Campaign",
    "slug": "twitter-campaign",
    "public": true
}'

$curl = curl_init();

curl_setopt_array($curl, array(
    CURLOPT_URL => "https://onelinker.cn/api/campaign/:id/update",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_ENCODING => "",
    CURLOPT_MAXREDIRS => 2,
    CURLOPT_TIMEOUT => 10,
    CURLOPT_FOLLOWLOCATION => true,
    CURLOPT_CUSTOMREQUEST => "PUT",
    CURLOPT_HTTPHEADER => array(
        "Authorization: Bearer YOURAPIKEY",
        "Content-Type: application/json",
    ),
    CURLOPT_POSTFIELDS => json_encode(array (
  'name' => 'Twitter Campaign',
  'slug' => 'twitter-campaign',
  'public' => true,
)),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

服务器响应

{
    "error": 0,
    "id": 3,
    "domain": "Twitter Campaign",
    "public": true,
    "rotator": "https:\/\/domain.com\/r\/twitter-campaign",
    "list": "https:\/\/domain.com\/u\/admin\/twitter-campaign-3"
}

删除活动

DELETE https://onelinker.cn/api/campaign/:id/delete

要删除广告活动，您需要发送一个DELETE请求。

cURL PHP

curl --location --request DELETE 'https://onelinker.cn/api/campaign/:id/delete' \
--header 'Authorization: Bearer YOURAPIKEY' \
--header 'Content-Type: application/json' \

$curl = curl_init();

curl_setopt_array($curl, array(
    CURLOPT_URL => "https://onelinker.cn/api/campaign/:id/delete",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_ENCODING => "",
    CURLOPT_MAXREDIRS => 2,
    CURLOPT_TIMEOUT => 10,
    CURLOPT_FOLLOWLOCATION => true,
    CURLOPT_CUSTOMREQUEST => "DELETE",
    CURLOPT_HTTPHEADER => array(
        "Authorization: Bearer YOURAPIKEY",
        "Content-Type: application/json",
    ),
    
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

服务器响应

{
    "error": 0,
    "message": "Campaign has been deleted successfully."
}

自定义欢迎界面

自定义欢迎页面

GET https://onelinker.cn/api/splash?limit=2&page=1

通过API获取自定义启动页面，您可以使用此接口。您还可以过滤数据（详见表格获取更多信息）

参数	描述
limit	（可选）每页最多显示的结果的数量
page	（可选）当前请求的页码

cURL PHP

curl --location --request GET 'https://onelinker.cn/api/splash?limit=2&page=1' \
--header 'Authorization: Bearer YOURAPIKEY' \
--header 'Content-Type: application/json' \

$curl = curl_init();

curl_setopt_array($curl, array(
    CURLOPT_URL => "https://onelinker.cn/api/splash?limit=2&page=1",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_ENCODING => "",
    CURLOPT_MAXREDIRS => 2,
    CURLOPT_TIMEOUT => 10,
    CURLOPT_FOLLOWLOCATION => true,
    CURLOPT_CUSTOMREQUEST => "GET",
    CURLOPT_HTTPHEADER => array(
        "Authorization: Bearer YOURAPIKEY",
        "Content-Type: application/json",
    ),
    
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

服务器响应

{
    "error": "0",
    "data": {
        "result": 2,
        "perpage": 2,
        "currentpage": 1,
        "nextpage": 1,
        "maxpage": 1,
        "splash": [
            {
                "id": 1,
                "name": "Product 1 Promo",
                "date": "2020-11-10 18:00:00"
            },
            {
                "id": 2,
                "name": "Product 2 Promo",
                "date": "2020-11-10 18:10:00"
            }
        ]
    }
}

账号

获取账号信息

GET https://onelinker.cn/api/account

要获取有关您的账户的信息，您可以该接口发送请求，它将返回有关该账户的数据。

cURL PHP

curl --location --request GET 'https://onelinker.cn/api/account' \
--header 'Authorization: Bearer YOURAPIKEY' \
--header 'Content-Type: application/json' \

$curl = curl_init();

curl_setopt_array($curl, array(
    CURLOPT_URL => "https://onelinker.cn/api/account",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_ENCODING => "",
    CURLOPT_MAXREDIRS => 2,
    CURLOPT_TIMEOUT => 10,
    CURLOPT_FOLLOWLOCATION => true,
    CURLOPT_CUSTOMREQUEST => "GET",
    CURLOPT_HTTPHEADER => array(
        "Authorization: Bearer YOURAPIKEY",
        "Content-Type: application/json",
    ),
    
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

服务器响应

{
    "error": 0,
    "data": {
        "id": 1,
        "email": "sample@domain.com",
        "username": "sampleuser",
        "avatar": "https:\/\/domain.com\/content\/avatar.png",
        "status": "pro",
        "expires": "2022-11-15 15:00:00",
        "registered": "2020-11-10 18:01:43"
    }
}

更新账号

PUT https://onelinker.cn/api/account/update

要更新账户信息，您可以向此接口发送请求，它将更新账户的数据。

cURL PHP

curl --location --request PUT 'https://onelinker.cn/api/account/update' \
--header 'Authorization: Bearer YOURAPIKEY' \
--header 'Content-Type: application/json' \
--data-raw '{
    "email": "newemail@google.com",
    "password": "newpassword"
}'

$curl = curl_init();

curl_setopt_array($curl, array(
    CURLOPT_URL => "https://onelinker.cn/api/account/update",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_ENCODING => "",
    CURLOPT_MAXREDIRS => 2,
    CURLOPT_TIMEOUT => 10,
    CURLOPT_FOLLOWLOCATION => true,
    CURLOPT_CUSTOMREQUEST => "PUT",
    CURLOPT_HTTPHEADER => array(
        "Authorization: Bearer YOURAPIKEY",
        "Content-Type: application/json",
    ),
    CURLOPT_POSTFIELDS => json_encode(array (
  'email' => 'newemail@google.com',
  'password' => 'newpassword',
)),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

服务器响应

{
    "error": 0,
    "message": "Account has been successfully updated."
}

链接

List Links

GET https://onelinker.cn/api/urls?limit=2&page=1&order=date

通过API获取您的链接，您可以使用此接口。您还可以过滤数据（详见表格获取更多信息）。

参数	描述
limit	（可选）每页最多显示的结果的数量
page	（可选）当前请求的页码
order	(可选) 在日期或点击之间排序数据

cURL PHP

curl --location --request GET 'https://onelinker.cn/api/urls?limit=2&page=1&order=date' \
--header 'Authorization: Bearer YOURAPIKEY' \
--header 'Content-Type: application/json' \

$curl = curl_init();

curl_setopt_array($curl, array(
    CURLOPT_URL => "https://onelinker.cn/api/urls?limit=2&page=1&order=date",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_ENCODING => "",
    CURLOPT_MAXREDIRS => 2,
    CURLOPT_TIMEOUT => 10,
    CURLOPT_FOLLOWLOCATION => true,
    CURLOPT_CUSTOMREQUEST => "GET",
    CURLOPT_HTTPHEADER => array(
        "Authorization: Bearer YOURAPIKEY",
        "Content-Type: application/json",
    ),
    
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

服务器响应

{
    "error": "0",
    "data": {
        "result": 2,
        "perpage": 2,
        "currentpage": 1,
        "nextpage": 1,
        "maxpage": 1,
        "urls": [
            {
                "id": 2,
                "alias": "google",
                "shorturl": "https:\/\/onelinker.cn\/google",
                "longurl": "https:\/\/google.com",
                "clicks": 0,
                "title": "Google",
                "description": "",
                "date": "2020-11-10 18:01:43"
            },
            {
                "id": 1,
                "alias": "googlecanada",
                "shorturl": "https:\/\/onelinker.cn\/googlecanada",
                "longurl": "https:\/\/google.ca",
                "clicks": 0,
                "title": "Google Canada",
                "description": "",
                "date": "2020-11-10 18:00:25"
            }
        ]
    }
}

获取单个链接

GET https://onelinker.cn/api/url/:id

通过API获取单个链接的详细信息，您可以使用此接口。

cURL PHP

curl --location --request GET 'https://onelinker.cn/api/url/:id' \
--header 'Authorization: Bearer YOURAPIKEY' \
--header 'Content-Type: application/json' \

$curl = curl_init();

curl_setopt_array($curl, array(
    CURLOPT_URL => "https://onelinker.cn/api/url/:id",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_ENCODING => "",
    CURLOPT_MAXREDIRS => 2,
    CURLOPT_TIMEOUT => 10,
    CURLOPT_FOLLOWLOCATION => true,
    CURLOPT_CUSTOMREQUEST => "GET",
    CURLOPT_HTTPHEADER => array(
        "Authorization: Bearer YOURAPIKEY",
        "Content-Type: application/json",
    ),
    
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

服务器响应

{
    "error": 0,
    "details": {
        "id": 1,
        "shorturl": "https:\/\/onelinker.cn\/googlecanada",
        "longurl": "https:\/\/google.com",
        "title": "Google",
        "description": "",
        "location": {
            "canada": "https:\/\/google.ca",
            "united states": "https:\/\/google.us"
        },
        "device": {
            "iphone": "https:\/\/google.com",
            "android": "https:\/\/google.com"
        },
        "expiry": null,
        "date": "2020-11-10 18:01:43"
    },
    "data": {
        "clicks": 0,
        "uniqueClicks": 0,
        "topCountries": 0,
        "topReferrers": 0,
        "topBrowsers": 0,
        "topOs": 0,
        "socialCount": {
            "facebook": 0,
            "twitter": 0,
            "google": 0
        }
    }
}

缩短链接

POST https://onelinker.cn/api/url/add

要缩短链接，您需要通过POST请求以JSON格式发送有效数据。数据必须作为请求的原始主体发送，如下所示。下面的示例展示了您可以发送的所有参数，但不要求发送所有参数（请参阅表格获取更多信息）。

参数	描述
url	(必填) 要缩短的长链接。
custom	(可选) 自定义别名而非随机别名。
type	(可选) 重定向类型 [direct, frame, splash]，仅对自定义启动页面使用 id 或对CTA页面使用 overlay-id
password	(可选) 密码保护
domain	(可选) 自定义域名
expiry	(可选) 链接的过期时间示例 2021-09-28 23:11:16
geotarget	(可选) 地理定位数据
devicetarget	(可选) 设备定位数据
languagetarget	（可选）目标语言
metatitle	(可选) 元标题
metadescription	(可选) 元描述
metaimage	（可选）链接到jpg或png图像

cURL PHP

curl --location --request POST 'https://onelinker.cn/api/url/add' \
--header 'Authorization: Bearer YOURAPIKEY' \
--header 'Content-Type: application/json' \
--data-raw '{
    "url": "https:\/\/google.com",
    "custom": "google",
    "password": "mypass",
    "expiry": "2020-11-11 12:00:00",
    "type": "splash",
    "metatitle": "Not Google",
    "metadescription": "Not Google description",
    "metaimage": "https:\/\/www.mozilla.org\/media\/protocol\/img\/logos\/firefox\/browser\/og.4ad05d4125a5.png",
    "geotarget": [
        {
            "location": "Canada",
            "link": "https:\/\/google.ca"
        },
        {
            "location": "United States",
            "link": "https:\/\/google.us"
        }
    ],
    "devicetarget": [
        {
            "device": "iPhone",
            "link": "https:\/\/google.com"
        },
        {
            "device": "Android",
            "link": "https:\/\/google.com"
        }
    ],
    "languagetarget": [
        {
            "language": "en",
            "link": "https:\/\/google.com"
        },
        {
            "language": "fr",
            "link": "https:\/\/google.ca"
        }
    ],
    "parameters": [
        {
            "name": "aff",
            "value": "3"
        },
        {
            "device": "gtm_source",
            "link": "api"
        }
    ]
}'

$curl = curl_init();

curl_setopt_array($curl, array(
    CURLOPT_URL => "https://onelinker.cn/api/url/add",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_ENCODING => "",
    CURLOPT_MAXREDIRS => 2,
    CURLOPT_TIMEOUT => 10,
    CURLOPT_FOLLOWLOCATION => true,
    CURLOPT_CUSTOMREQUEST => "POST",
    CURLOPT_HTTPHEADER => array(
        "Authorization: Bearer YOURAPIKEY",
        "Content-Type: application/json",
    ),
    CURLOPT_POSTFIELDS => json_encode(array (
  'url' => 'https://google.com',
  'custom' => 'google',
  'password' => 'mypass',
  'expiry' => '2020-11-11 12:00:00',
  'type' => 'splash',
  'metatitle' => 'Not Google',
  'metadescription' => 'Not Google description',
  'metaimage' => 'https://www.mozilla.org/media/protocol/img/logos/firefox/browser/og.4ad05d4125a5.png',
  'geotarget' => 
  array (
    0 => 
    array (
      'location' => 'Canada',
      'link' => 'https://google.ca',
    ),
    1 => 
    array (
      'location' => 'United States',
      'link' => 'https://google.us',
    ),
  ),
  'devicetarget' => 
  array (
    0 => 
    array (
      'device' => 'iPhone',
      'link' => 'https://google.com',
    ),
    1 => 
    array (
      'device' => 'Android',
      'link' => 'https://google.com',
    ),
  ),
  'languagetarget' => 
  array (
    0 => 
    array (
      'language' => 'en',
      'link' => 'https://google.com',
    ),
    1 => 
    array (
      'language' => 'fr',
      'link' => 'https://google.ca',
    ),
  ),
  'parameters' => 
  array (
    0 => 
    array (
      'name' => 'aff',
      'value' => '3',
    ),
    1 => 
    array (
      'device' => 'gtm_source',
      'link' => 'api',
    ),
  ),
)),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

服务器响应

{
    "error": 0,
    "id": 3,
    "shorturl": "https:\/\/onelinker.cn\/google"
}

更新链接

PUT https://onelinker.cn/api/url/:id/update

要更新链接，您需要通过PUT请求以JSON格式发送有效数据。数据必须作为请求的原始主体发送，如下所示。下面的示例展示了您可以发送的所有参数，但不要求发送所有参数（请参阅表格获取更多信息）。

参数	描述
url	(必填) 要缩短的长链接。
custom	(可选) 自定义别名而非随机别名。
type	(可选) 重定向类型 [direct, frame, splash]
password	(可选) 密码保护
domain	(可选) 自定义域名
expiry	(可选) 链接的过期时间示例 2021-09-28 23:11:16
geotarget	(可选) 地理定位数据
devicetarget	(可选) 设备定位数据
languagetarget	（可选）目标语言
metatitle	(可选) 元标题
metadescription	(可选) 元描述
metaimage	（可选）链接到jpg或png图像

cURL PHP

curl --location --request PUT 'https://onelinker.cn/api/url/:id/update' \
--header 'Authorization: Bearer YOURAPIKEY' \
--header 'Content-Type: application/json' \
--data-raw '{
    "url": "https:\/\/google.com",
    "custom": "google",
    "password": "mypass",
    "expiry": "2020-11-11 12:00:00",
    "type": "splash",
    "geotarget": [
        {
            "location": "Canada",
            "link": "https:\/\/google.ca"
        },
        {
            "location": "United States",
            "link": "https:\/\/google.us"
        }
    ],
    "devicetarget": [
        {
            "device": "iPhone",
            "link": "https:\/\/google.com"
        },
        {
            "device": "Android",
            "link": "https:\/\/google.com"
        }
    ],
    "parameters": [
        {
            "name": "aff",
            "value": "3"
        },
        {
            "device": "gtm_source",
            "link": "api"
        }
    ]
}'

$curl = curl_init();

curl_setopt_array($curl, array(
    CURLOPT_URL => "https://onelinker.cn/api/url/:id/update",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_ENCODING => "",
    CURLOPT_MAXREDIRS => 2,
    CURLOPT_TIMEOUT => 10,
    CURLOPT_FOLLOWLOCATION => true,
    CURLOPT_CUSTOMREQUEST => "PUT",
    CURLOPT_HTTPHEADER => array(
        "Authorization: Bearer YOURAPIKEY",
        "Content-Type: application/json",
    ),
    CURLOPT_POSTFIELDS => json_encode(array (
  'url' => 'https://google.com',
  'custom' => 'google',
  'password' => 'mypass',
  'expiry' => '2020-11-11 12:00:00',
  'type' => 'splash',
  'geotarget' => 
  array (
    0 => 
    array (
      'location' => 'Canada',
      'link' => 'https://google.ca',
    ),
    1 => 
    array (
      'location' => 'United States',
      'link' => 'https://google.us',
    ),
  ),
  'devicetarget' => 
  array (
    0 => 
    array (
      'device' => 'iPhone',
      'link' => 'https://google.com',
    ),
    1 => 
    array (
      'device' => 'Android',
      'link' => 'https://google.com',
    ),
  ),
  'parameters' => 
  array (
    0 => 
    array (
      'name' => 'aff',
      'value' => '3',
    ),
    1 => 
    array (
      'device' => 'gtm_source',
      'link' => 'api',
    ),
  ),
)),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

服务器响应

{
    "error": 0,
    "id": 3,
    "short": "https:\/\/onelinker.cn\/google"
}

删除链接

DELETE https://onelinker.cn/api/url/:id/delete

要删除链接，您需要发送DELETE请求。

cURL PHP

curl --location --request DELETE 'https://onelinker.cn/api/url/:id/delete' \
--header 'Authorization: Bearer YOURAPIKEY' \
--header 'Content-Type: application/json' \

$curl = curl_init();

curl_setopt_array($curl, array(
    CURLOPT_URL => "https://onelinker.cn/api/url/:id/delete",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_ENCODING => "",
    CURLOPT_MAXREDIRS => 2,
    CURLOPT_TIMEOUT => 10,
    CURLOPT_FOLLOWLOCATION => true,
    CURLOPT_CUSTOMREQUEST => "DELETE",
    CURLOPT_HTTPHEADER => array(
        "Authorization: Bearer YOURAPIKEY",
        "Content-Type: application/json",
    ),
    
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

服务器响应

{
    "error": 0,
    "message": "Link has been deleted successfully"
}

频道

频道列表

GET https://onelinker.cn/api/channels?limit=2&page=1

要通过API获取您的频道，您可以使用此接口。您还可以过滤数据（有关更多信息，请参阅表格）

参数	描述
limit	（可选）每页最多显示的结果的数量
page	（可选）当前请求的页码

cURL PHP

curl --location --request GET 'https://onelinker.cn/api/channels?limit=2&page=1' \
--header 'Authorization: Bearer YOURAPIKEY' \
--header 'Content-Type: application/json' \

$curl = curl_init();

curl_setopt_array($curl, array(
    CURLOPT_URL => "https://onelinker.cn/api/channels?limit=2&page=1",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_ENCODING => "",
    CURLOPT_MAXREDIRS => 2,
    CURLOPT_TIMEOUT => 10,
    CURLOPT_FOLLOWLOCATION => true,
    CURLOPT_CUSTOMREQUEST => "GET",
    CURLOPT_HTTPHEADER => array(
        "Authorization: Bearer YOURAPIKEY",
        "Content-Type: application/json",
    ),
    
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

服务器响应

{
    "error": "0",
    "data": {
        "result": 2,
        "perpage": 2,
        "currentpage": 1,
        "nextpage": 1,
        "maxpage": 1,
        "channels": [
            {
                "id": 1,
                "name": "Channel 1",
                "description": "Description of channel 1",
                "color": "#000000",
                "starred": true
            },
            {
                "id": 2,
                "name": "Channel 2",
                "description": "Description of channel 2",
                "color": "#FF0000",
                "starred": false
            }
        ]
    }
}

列出频道项目

GET https://onelinker.cn/api/channel/:id?limit=1&page=1

要通过API获取在选择的频道中的项目，您可以使用此接口。您还可以过滤数据（有关更多信息，请参阅表格）

参数	描述
limit	（可选）每页最多显示的结果的数量
page	（可选）当前请求的页码

cURL PHP

curl --location --request GET 'https://onelinker.cn/api/channel/:id?limit=1&page=1' \
--header 'Authorization: Bearer YOURAPIKEY' \
--header 'Content-Type: application/json' \

$curl = curl_init();

curl_setopt_array($curl, array(
    CURLOPT_URL => "https://onelinker.cn/api/channel/:id?limit=1&page=1",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_ENCODING => "",
    CURLOPT_MAXREDIRS => 2,
    CURLOPT_TIMEOUT => 10,
    CURLOPT_FOLLOWLOCATION => true,
    CURLOPT_CUSTOMREQUEST => "GET",
    CURLOPT_HTTPHEADER => array(
        "Authorization: Bearer YOURAPIKEY",
        "Content-Type: application/json",
    ),
    
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

服务器响应

{
    "error": "0",
    "data": {
        "result": 2,
        "perpage": 2,
        "currentpage": 1,
        "nextpage": 1,
        "maxpage": 1,
        "items": [
            {
                "type": "links",
                "id": 1,
                "title": "My Sample Link",
                "preview": "https:\/\/google.com",
                "link": "https:\/\/onelinker.cn\/google",
                "date": "2022-05-12"
            },
            {
                "type": "bio",
                "id": 1,
                "title": "My Sample Bio",
                "preview": "https:\/\/onelinker.cn\/mybio",
                "link": "https:\/\/onelinker.cn\/mybio",
                "date": "2022-06-01"
            }
        ]
    }
}

创建频道

POST https://onelinker.cn/api/channel/add

可以使用此接口添加频道。

参数	描述
name	（必选）频道名称
description	（可选）频道描述
color	（可选）频道徽章颜色（十六进制）
starred	（可选）是否标记为星标频道（true 或 false）

cURL PHP

curl --location --request POST 'https://onelinker.cn/api/channel/add' \
--header 'Authorization: Bearer YOURAPIKEY' \
--header 'Content-Type: application/json' \
--data-raw '{
    "name": "New Channel",
    "description": "my new channel",
    "color": "#000000",
    "starred": true
}'

$curl = curl_init();

curl_setopt_array($curl, array(
    CURLOPT_URL => "https://onelinker.cn/api/channel/add",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_ENCODING => "",
    CURLOPT_MAXREDIRS => 2,
    CURLOPT_TIMEOUT => 10,
    CURLOPT_FOLLOWLOCATION => true,
    CURLOPT_CUSTOMREQUEST => "POST",
    CURLOPT_HTTPHEADER => array(
        "Authorization: Bearer YOURAPIKEY",
        "Content-Type: application/json",
    ),
    CURLOPT_POSTFIELDS => json_encode(array (
  'name' => 'New Channel',
  'description' => 'my new channel',
  'color' => '#000000',
  'starred' => true,
)),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

服务器响应

{
    "error": 0,
    "id": 3,
    "name": "New Channel",
    "description": "my new channel",
    "color": "#000000",
    "starred": true
}

将项目分配给频道

POST https://onelinker.cn/api/channel/:channelid/assign/:type/:itemid

可以通过发送带有频道ID、项目类型（链接、个人简介或二维码）和项目ID的请求，将项目分配给任何频道。

参数	描述
:channelid	（必选）频道ID
:type	（必选）链接、个人简介或二维码
:itemid	(必选) Item ID

cURL PHP

curl --location --request POST 'https://onelinker.cn/api/channel/:channelid/assign/:type/:itemid' \
--header 'Authorization: Bearer YOURAPIKEY' \
--header 'Content-Type: application/json' \

$curl = curl_init();

curl_setopt_array($curl, array(
    CURLOPT_URL => "https://onelinker.cn/api/channel/:channelid/assign/:type/:itemid",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_ENCODING => "",
    CURLOPT_MAXREDIRS => 2,
    CURLOPT_TIMEOUT => 10,
    CURLOPT_FOLLOWLOCATION => true,
    CURLOPT_CUSTOMREQUEST => "POST",
    CURLOPT_HTTPHEADER => array(
        "Authorization: Bearer YOURAPIKEY",
        "Content-Type: application/json",
    ),
    
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

服务器响应

{
    "error": 0,
    "message": "Item successfully added to the channel."
}

更新频道

PUT https://onelinker.cn/api/channel/:id/update

要更新频道，您需要通过PUT请求以JSON格式发送有效数据。数据必须按照下面所示发送为请求的原始主体。下面的示例展示了您可以发送的所有参数，但不必发送所有参数（有关更多信息，请参阅表格）

参数	描述
name	（必选）频道名称
description	（可选）频道描述
color	（可选）频道徽章颜色（十六进制）
starred	（可选）是否标记为星标频道（true 或 false）

cURL PHP

curl --location --request PUT 'https://onelinker.cn/api/channel/:id/update' \
--header 'Authorization: Bearer YOURAPIKEY' \
--header 'Content-Type: application/json' \
--data-raw '{
    "name": "Acme Corp",
    "description": "channel for items for Acme Corp",
    "color": "#FFFFFF",
    "starred": false
}'

$curl = curl_init();

curl_setopt_array($curl, array(
    CURLOPT_URL => "https://onelinker.cn/api/channel/:id/update",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_ENCODING => "",
    CURLOPT_MAXREDIRS => 2,
    CURLOPT_TIMEOUT => 10,
    CURLOPT_FOLLOWLOCATION => true,
    CURLOPT_CUSTOMREQUEST => "PUT",
    CURLOPT_HTTPHEADER => array(
        "Authorization: Bearer YOURAPIKEY",
        "Content-Type: application/json",
    ),
    CURLOPT_POSTFIELDS => json_encode(array (
  'name' => 'Acme Corp',
  'description' => 'channel for items for Acme Corp',
  'color' => '#FFFFFF',
  'starred' => false,
)),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

服务器响应

{
    "error": 0,
    "message": "Channel has been updated successfully."
}

删除频道

DELETE https://onelinker.cn/api/channel/:id/delete

要删除频道，您需要发送一个DELETE请求。所有项目也将被取消分配。

cURL PHP

curl --location --request DELETE 'https://onelinker.cn/api/channel/:id/delete' \
--header 'Authorization: Bearer YOURAPIKEY' \
--header 'Content-Type: application/json' \

$curl = curl_init();

curl_setopt_array($curl, array(
    CURLOPT_URL => "https://onelinker.cn/api/channel/:id/delete",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_ENCODING => "",
    CURLOPT_MAXREDIRS => 2,
    CURLOPT_TIMEOUT => 10,
    CURLOPT_FOLLOWLOCATION => true,
    CURLOPT_CUSTOMREQUEST => "DELETE",
    CURLOPT_HTTPHEADER => array(
        "Authorization: Bearer YOURAPIKEY",
        "Content-Type: application/json",
    ),
    
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

服务器响应

{
    "error": 0,
    "message": "Channel has been deleted successfully."
}

资源

解决方案

开发者 API参考帮助 v3

入门

验证

速率限制

响应处理

CTA 覆盖层

CTA覆盖层列表

服务器响应

二维码

QR二维码列表

服务器响应

获取单个二维码

服务器响应

创建二维码

服务器响应

Update QR Code

服务器响应

删除二维码

服务器响应

像素

像素列表

服务器响应

创建像素

服务器响应

更新像素

服务器响应

删除像素

服务器响应

品牌域名

品牌域名列表

服务器响应

创建品牌域名

服务器响应

更新域

服务器响应

删除域名

服务器响应

广告管理

活动列表

服务器响应

创建活动

服务器响应

将链接分配给广告活动

服务器响应

更新活动

服务器响应

删除活动

服务器响应

自定义欢迎界面

自定义欢迎页面

服务器响应

账号

获取账号信息

服务器响应

更新账号

服务器响应

链接

List Links

服务器响应

获取单个链接

服务器响应

缩短链接

服务器响应

更新链接

服务器响应

删除链接

服务器响应

频道

频道列表

服务器响应

列出频道项目

服务器响应

创建频道

服务器响应

将项目分配给频道

服务器响应

更新频道

服务器响应