amo_api_dart 是一个用于与 AMO (AmoCRM) API 进行交互的 Dart 插件。它允许你在 Flutter 应用中轻松地与 AmoCRM 进行通信，执行诸如获取联系人、创建交易、更新客户等操作。

以下是如何在 Flutter 项目中使用 amo_api_dart 插件的步骤：

1. 添加依赖

首先，你需要在 pubspec.yaml 文件中添加 amo_api_dart 依赖：

dependencies:
  flutter:
    sdk: flutter
  amo_api_dart: ^1.0.0  # 请使用最新版本

然后运行 flutter pub get 来安装依赖。

2. 初始化 AMO API 客户端

在你的 Dart 代码中，首先需要初始化 AmoApiClient。你需要提供 AmoCRM 的域名、客户端 ID、客户端密钥和重定向 URI。

import 'package:amo_api_dart/amo_api_dart.dart';

void main() async {
  final client = AmoApiClient(
    domain: 'yourdomain.amocrm.ru',
    clientId: 'your_client_id',
    clientSecret: 'your_client_secret',
    redirectUri: 'your_redirect_uri',
  );

  // 获取授权 URL
  final authUrl = client.getAuthorizationUrl();
  print('Auth URL: $authUrl');

  // 用户授权后，获取授权码并交换为访问令牌
  final authCode = 'your_auth_code';
  final token = await client.getAccessToken(authCode);
  print('Access Token: $token');

  // 使用访问令牌进行 API 调用
  client.setAccessToken(token.accessToken);

  // 获取联系人列表
  final contacts = await client.getContacts();
  print('Contacts: $contacts');
}

3. 获取授权 URL

在用户授权之前，你需要生成一个授权 URL，用户将通过该 URL 进行授权。你可以使用 getAuthorizationUrl() 方法来生成这个 URL。

final authUrl = client.getAuthorizationUrl();
print('Auth URL: $authUrl');

4. 获取访问令牌

用户授权后，AmoCRM 会重定向到你的重定向 URI，并附带一个授权码。你需要使用这个授权码来获取访问令牌。

final authCode = 'your_auth_code';
final token = await client.getAccessToken(authCode);
print('Access Token: $token');

5. 使用访问令牌进行 API 调用

获取到访问令牌后，你可以使用它来进行各种 API 调用。例如，获取联系人列表：

final contacts = await client.getContacts();
print('Contacts: $contacts');

6. 其他 API 调用

amo_api_dart 提供了多种方法来与 AmoCRM API 进行交互。以下是一些常见的 API 调用示例：

• 获取交易列表:

  final leads = await client.getLeads();
  print('Leads: $leads');
  

• 创建交易:

  final newLead = await client.createLead({
    'name': 'New Lead',
    'price': 1000,
  });
  print('New Lead: $newLead');
  

• 更新联系人:

  final updatedContact = await client.updateContact(123, {
    'name': 'Updated Name',
  });
  print('Updated Contact: $updatedContact');
  

7. 处理错误

在进行 API 调用时，可能会遇到各种错误。你可以使用 try-catch 块来捕获并处理这些错误。

try {
  final contacts = await client.getContacts();
  print('Contacts: $contacts');
} catch (e) {
  print('Error: $e');
}

8. 刷新访问令牌

访问令牌通常有一个有效期，过期后需要刷新。你可以使用 refreshToken 方法来刷新访问令牌。

final newToken = await client.refreshToken(token.refreshToken);
print('New Access Token: $newToken');

9. 保存和加载令牌

为了在应用重启后仍然保持登录状态，你可以将访问令牌和刷新令牌保存到本地存储中，并在应用启动时加载它们。

// 保存令牌
await saveTokenToStorage(token);

// 加载令牌
final savedToken = await loadTokenFromStorage();
client.setAccessToken(savedToken.accessToken);

10. 完整示例

以下是一个完整的示例，展示了如何使用 amo_api_dart 插件进行授权、获取访问令牌并获取联系人列表：

import 'package:amo_api_dart/amo_api_dart.dart';

void main() async {
  final client = AmoApiClient(
    domain: 'yourdomain.amocrm.ru',
    clientId: 'your_client_id',
    clientSecret: 'your_client_secret',
    redirectUri: 'your_redirect_uri',
  );

  // 获取授权 URL
  final authUrl = client.getAuthorizationUrl();
  print('Auth URL: $authUrl');

  // 用户授权后，获取授权码并交换为访问令牌
  final authCode = 'your_auth_code';
  final token = await client.getAccessToken(authCode);
  print('Access Token: $token');

  // 使用访问令牌进行 API 调用
  client.setAccessToken(token.accessToken);

  // 获取联系人列表
  try {
    final contacts = await client.getContacts();
    print('Contacts: $contacts');
  } catch (e) {
    print('Error: $e');
  }
}