如何使用 PHP Bitly v4 缩短 URL?

Question

我有 Bitlyv3的这段代码，它运行良好。

<?php
$login = 'login-code-here';
$api_key = 'api-key-here';
$long_url = 'https://stackoverflow.com/questions/ask';
$ch = curl_init('http://api.bitly.com/v3/shorten?login='.$login.'&apiKey='.$api_key.'&longUrl='.$long_url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$result = curl_exec($ch);
$res = json_decode($result, true);
echo $res['data']['url']; // bit.ly/2PcG3Fg
?>

但是，如何在较新版本中执行此操作？上面的示例使用 API 密钥，但已弃用它以支持 OAuth 请求。

如何使用Bitlyv4缩短URL？

Answer 1

获取通用访问令牌

转到您的 Bitly，单击右上角的汉堡菜单>"设置">"高级设置> API 支持">然后单击"通用访问令牌"链接。键入密码并生成通用令牌。这就是您将用于身份验证的内容。

请参阅 https://dev.bitly.com/v4_documentation.html 并查找使用单个帐户的应用程序部分。

根据 https://dev.bitly.com/v4/#section/Application-using-a-single-account，身份验证发生了一些变化。

对 Bitly API 进行身份验证的方式在 V4 中发生了变化。以前，身份验证令牌将作为每个请求的access_token查询参数提供。相反，V4 要求在每个请求上将令牌作为授权标头的一部分提供。

法典

请参阅此文档 https://dev.bitly.com/v4/#operation/createFullBitlink，了解有关 Bitly 期望的信息。

在 v4 中，您可以在标头中使用通用令牌作为每个请求的持有者，如下所示：

<?php
$long_url = 'https://stackoverflow.com/questions/ask';
$apiv4 = 'https://api-ssl.bitly.com/v4/bitlinks';
$genericAccessToken = 'your-token';
$data = array(
'long_url' => $long_url
);
$payload = json_encode($data);
$header = array(
'Authorization: Bearer ' . $genericAccessToken,
'Content-Type: application/json',
'Content-Length: ' . strlen($payload)
);
$ch = curl_init($apiv4);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($ch, CURLOPT_POSTFIELDS, $payload);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, $header);
$result = curl_exec($ch);
print_r($result);

请求

您发送的 JSON 将如下所示：

{"long_url":"https://stackoverflow.com/questions/ask"}

响应

{
"created_at":"1970-01-01T00:00:00+0000",
"id":"shortcode-link-id-here",
"link":"shortcode-link-here",
"custom_bitlinks":[
],
"long_url":"https://stackoverflow.com/questions/ask",
"archived":false,
"tags":[
],
"deeplinks":[
],
"references":{
"group":"group-link-here"
}
}

编辑

注释中有一个请求，要求只查看短链接输出。为此，只需像这样调整代码：

<?php
$long_url = 'https://stackoverflow.com/questions/ask';
$apiv4 = 'https://api-ssl.bitly.com/v4/bitlinks';
$genericAccessToken = 'your-token';
$data = array(
'long_url' => $long_url
);
$payload = json_encode($data);
$header = array(
'Authorization: Bearer ' . $genericAccessToken,
'Content-Type: application/json',
'Content-Length: ' . strlen($payload)
);
$ch = curl_init($apiv4);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($ch, CURLOPT_POSTFIELDS, $payload);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, $header);
$result = curl_exec($ch);
$resultToJson = json_decode($result);
if (isset($resultToJson->link)) {
echo $resultToJson->link;
}
else {
echo 'Not found';
}

结果(假设上面的文件是测试.php)

php test.php
bit.ly/2ZbYD4Z

Answer 2

这是一个你可以使用的PHP包 https://packagist.org/packages/codehaveli/bitly-php

使用软件包的步骤：

第 1 步：

composer require codehaveli/bitly-php:dev-master --prefer-source通过作曲家安装软件包 [如果未安装 https://getcomposer.org/，请从此处获取]

第 2 步：

从 Bitly 添加访问令牌和组 GUID [此处指南：https://www.codehaveli.com/how-to-generate-bitly-oauth-access-token/]

<?php
require 'vendor/autoload.php';
use CodehaveliBitly;
use CodehaveliExceptionsBitlyErrorException;
// First setup your credentials provided by Bitly
$accessToken  = "ACCESS_TOKEN_FROM_BITLY";
$guid         = "GUID_FROM_BITLY";
Bitly::init($accessToken, $guid);

第 3 步：

使用访问令牌和指南初始化后，只需调用从资源getUrl的方法，就像使用 URL 一样，就会给你短链接。

<?php
use CodehaveliBitly;
use CodehaveliExceptionsBitlyErrorException;
$accessToken  = "ACCESS_TOKEN_FROM_BITLY";
$guid         = "GUID_FROM_BITLY";
Bitly::init($accessToken, $guid);
$link = Bitly::link();
try {
$shortLink = $link->getUrl("https://stackoverflow.com/"); // Generated link
} catch (BitlyErrorException $e) {
$code    = $e->getCode();
$message = $e->getMessage();
}

注意：此软件包正在积极开发中。