README

Forge API:

概述

此PHP SDK 使您能够轻松地将 Forge REST API 集成到您的应用程序中，包括 OAuth、数据管理、模型派生和设计自动化。

要求

PHP版本5.4.0及以上。
Forge开发者门户上的已注册应用。

开始之前

由于分支，文档并非无处不在
从 forge-php-client 分支创建，以修复自 2022 年 9 月 30 日起的弃用问题，并保持此包正常工作

安装

Composer

要使用 Composer 安装绑定，请运行以下命令

composer require autodesk/forge-client

手动安装

下载文件并包含 autoload.php

require_once('/path/to/ForgeClient/autoload.php');

教程

遵循此教程，查看逐步认证指南，以及如何使用 Forge API 的示例。

创建应用

在 Forge 开发者门户上创建一个应用。注意客户端 ID 和客户端密钥。

认证

此 SDK 附带一个 OAuth 2.0 客户端，允许您检索双端和三端令牌。它还允许您刷新三端令牌。教程使用双端和三端令牌调用不同的数据管理端点。

双端令牌

此类令牌直接提供给应用程序。

要获取双端令牌，请运行以下代码。请注意，您需要用您的应用的客户端 ID 和客户端密钥替换 your-client-id 和 your-client-secret。

<?php

Autodesk\Auth\Configuration::getDefaultConfiguration()
    ->setClientId('<your-client-id>')
    ->setClientSecret('<your-client-secret>');

$twoLeggedAuth = new Autodesk\Auth\OAuth2\TwoLeggedAuth();
$twoLeggedAuth->setScopes(['bucket:read']);

$twoLeggedAuth->fetchToken();

$tokenInfo = [
    'applicationToken' => $twoLeggedAuth->getAccessToken(),
    'expiry'           => time() + $twoLeggedAuth->getExpiresIn(),
];

三端令牌

生成认证 URL

要请求用户权限以获取访问令牌，请将用户重定向到同意页面。

用您的应用的客户端 ID、客户端密钥和重定向 URL 替换 your-client-id、your-client-secret 和 your-redirect-url，并运行代码以创建同意页面 URL。

请注意，重定向URL必须与您创建应用时提供的回调URL相匹配。

<?php

Autodesk\Auth\Configuration::getDefaultConfiguration()
    ->setClientId('<your-client-id>')
    ->setClientSecret('<your-client-secret>')
    ->setRedirectUrl('<your-redirect-url>');

$threeLeggedAuth = new Autodesk\Auth\OAuth2\ThreeLeggedAuth();
$threeLeggedAuth->addScope('code:all');

$authUrl = $threeLeggedAuth->createAuthUrl();

获取授权码

一旦用户在同意页面上获得权限，Forge将页面重定向到您创建应用时提供的重定向URL。授权码将通过查询字符串返回。

GET /callback?code={authorizationCode}

获取访问令牌

使用您收到的授权码，按照以下方式请求访问令牌

<?php

Autodesk\Auth\Configuration::getDefaultConfiguration()
    ->setClientId('<your-client-id>')
    ->setClientSecret('<your-client-secret>')
    ->setRedirectUrl('<your-redirect-url>');

$threeLeggedAuth = new Autodesk\Auth\OAuth2\ThreeLeggedAuth();
$threeLeggedAuth->addScope('code:all');

$threeLeggedAuth->fetchToken($_GET['code']);

$userToken = [
    'accessToken'  => $threeLeggedAuth->getAccessToken(),
    'refreshToken' => $threeLeggedAuth->getRefreshToken(),
    'expiry'       => time() + $threeLeggedAuth->getExpiresIn(),
];

请注意，访问令牌在短时间内会过期。字段expires_in表示访问令牌的有效期（以秒为单位）。要刷新访问令牌，请调用$threeLeggedAuth->refreshToken($refreshToken);方法。

示例API调用

使用TwoLeggedAuth对象或ThreeLeggedAuth对象调用Forge API。

<?php


$apiInstance = new Autodesk\Forge\Client\Api\ActivitiesApi($threeLeggedAuth);
$activity = new \Autodesk\Forge\Client\Model\Activity(); // \Autodesk\Forge\Client\Model\Activity

$result = $apiInstance->createActivity($activity);

API文档

您可以在开发者门户上获取API的完整文档。

API端点文档

所有URI都是相对于https://developer.api.autodesk.com的。例如，createActivity URI是'https://developer.api.autodesk.com/autocad.io/us-east/v2/Activities'。

缩略图

支持

forge.help@autodesk.com

ISIBIM

库的新版本

productdevteam-isibim / forge-client

维护者

详细信息