Instagram PHP API V2 技术文档

1. 安装指南

环境要求

• PHP 5.3 或更高版本
• cURL 扩展
• 已注册的 Instagram 应用

安装步骤

强烈建议使用 Composer 来管理依赖和更新。

1. 打开终端或命令行工具，进入你的项目目录。
2. 运行以下命令安装 Instagram PHP API V2：

   composer require cosenary/instagram
   

2. 项目使用说明

初始化类

首先，你需要初始化 Instagram 类。以下是一个简单的示例：

use MetzWeb\Instagram\Instagram;

$instagram = new Instagram(array(
    'apiKey'      => 'YOUR_APP_KEY',
    'apiSecret'   => 'YOUR_APP_SECRET',
    'apiCallback' => 'YOUR_APP_CALLBACK'
));

echo "<a href='{$instagram->getLoginUrl()}'>登录 Instagram</a>";

用户认证 (OAuth2)

用户认证是使用 Instagram API 的关键步骤。以下是认证流程的示例：

// 获取 OAuth 回调代码
$code = $_GET['code'];
$data = $instagram->getOAuthToken($code);

echo '你的用户名是: ' . $data->user->username;

获取用户喜欢的内容

认证成功后，你可以获取用户喜欢的内容：

// 设置用户访问令牌
$instagram->setAccessToken($data);

// 获取所有用户喜欢的内容
$likes = $instagram->getUserLikes();

// 查看 API 响应
echo '<pre>';
print_r($likes);
echo '</pre>';

3. 项目API使用文档

设置 Instagram

你可以通过以下两种方式初始化 Instagram 类：

1. 使用数组进行用户认证：

   new Instagram(array(
       'apiKey'      => 'YOUR_APP_KEY',
       'apiSecret'   => 'YOUR_APP_SECRET',
       'apiCallback' => 'YOUR_APP_CALLBACK'
   ));
   

2. 仅访问公开数据：

   new Instagram('YOUR_APP_KEY');
   

获取登录URL

你可以通过以下方式获取登录 URL：

$loginUrl = $instagram->getLoginUrl(array(
    'basic',
    'likes'
));

获取 OAuth 令牌

你可以通过以下方式获取 OAuth 令牌：

$token = $instagram->getOAuthToken($code, true);

用户方法

• 公开方法：

  • getUser($id)
  • searchUser($name, $limit)
  • getUserMedia($id, $limit)

• 认证方法：

  • getUser()
  • getUserLikes($limit)
  • getUserFeed($limit)
  • getUserMedia($id, $limit)

关系方法

• 认证方法：
  • getUserFollows($id, $limit)
  • getUserFollower($id, $limit)
  • getUserRelationship($id)
  • modifyRelationship($action, $user)

媒体方法

• 公开方法：
  • getMedia($id)
  • getPopularMedia()
  • searchMedia($lat, $lng, $distance, $minTimestamp, $maxTimestamp)

评论方法

• 公开方法：

  • getMediaComments($id)

• 认证方法：

  • addMediaComment($id, $text)
  • deleteMediaComment($id, $commentID)

标签方法

• 公开方法：
  • getTag($name)
  • getTagMedia($name)
  • searchTags($name)

喜欢方法

• 认证方法：
  • getMediaLikes($id)
  • likeMedia($id)
  • deleteLikedMedia($id)

4. 项目安装方式

使用 Composer 安装

通过 Composer 安装是最推荐的方式，步骤如下：

1. 打开终端或命令行工具，进入你的项目目录。
2. 运行以下命令安装 Instagram PHP API V2：

   composer require cosenary/instagram
   

手动安装

如果你不使用 Composer，也可以手动下载项目并将其包含在你的项目中。

1. 从 GitHub 下载项目：Instagram PHP API V2
2. 将下载的文件解压并放置在你的项目目录中。
3. 在你的 PHP 文件中包含 Instagram.php：

   require_once 'path/to/Instagram.php';
   

通过以上步骤，你就可以成功安装并使用 Instagram PHP API V2 了。