Flutter票务管理插件anbocas_tickets_api的使用

Flutter票务管理插件anbocas_tickets_api的使用

特性

• 集中的配置用于API请求。
• 预构建的公司、活动和票务API类。
• 支持自定义头部、查询参数和带有Bearer令牌的身份验证。
• 可配置的日志记录用于调试。

开始使用

前提条件

在使用插件之前，您需要获取一个API密钥。获取API密钥的方法如下：

安装

将anbocas_tickets_api添加到您的pubspec.yaml文件中：

dependencies:
  anbocas_tickets_api: ^0.0.1

然后运行：

flutter pub get

初始化设置

在进行任何API调用之前，您需要使用API密钥和其他必需的设置来配置插件。这应该在应用程序启动时完成：

import 'package:anbocas_tickets_api/anbocas_tickets_api.dart';

void main() async {
  AnbocasRequestPlugin.instance
      ?.config(token: dotenv.env['API_KEY'], enableLog: true);

  runApp(MyApp());
}

发起API请求

配置完成后，您可以开始发起API请求。以下是一些示例：

获取公司列表

import 'package:anbocas_tickets_api/anbocas_tickets_api.dart';

void fetchCompanies() async {
  var companyList = await AnbocasRequestPlugin.company.get();
  print(companyList);
}

获取活动数据

import 'package:anbocas_tickets_api/anbocas_tickets_api.dart';

void fetchEvents() async {
  var events = await AnbocasRequestPlugin.event.get();
  print(events);
}

添加新票务

import 'package:anbocas_tickets_api/anbocas_tickets_api.dart';

Future<void> _submit() async {
  if (_formKey.currentState!.validate()) {
    final api = AnbocasRequestPlugin.ticket;
    await api.createTicket(
      eventId: "HERE EVENT ID", // 替换为实际的活动ID
      name: "HERE Ticket Name", // 替换为实际的票务名称
      description: "DESCRIPTION", // 替换为实际的描述
      capacity: 100, // 替换为实际的容量
      price: 20.0, // 替换为实际的价格
      availableFrom: DateTime.now(), // 替换为实际的可用开始日期
      availableTo: DateTime.now().add(Duration(days: 30)), // 替换为实际的可用结束日期
      status: "AVAILABLE", // 替换为实际的状态
    );
  }
}

API概述

• 公司API：访问与公司相关的数据。
• 活动API：管理与活动相关的数据。
• 票务API：处理与票务相关的操作。

许可证

该项目受BSD-3许可证保护 - 详情请参阅LICENSE文件。

支持

如遇到任何问题或需要请求API密钥，请联系[rahul@anbocas.com]。

示例代码

import 'package:anbocas_tickets_api/anbocas_tickets_api.dart';
import 'package:flutter/material.dart';
import 'package:flutter_dotenv/flutter_dotenv.dart';

void main() async {
  await dotenv.load(fileName: ".env");
  runApp(const MyApp());
}

class MyApp extends StatefulWidget {
  const MyApp({super.key});

  [@override](/user/override)
  State<MyApp> createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  [@override](/user/override)
  void initState() {
    AnbocasTicketsApi.instance
        ?.config(token: dotenv.env['API_KEY'], enableLog: true);
    super.initState();
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Anbocas Tickets API DEMO',
      debugShowCheckedModeBanner: false,
      theme: ThemeData(
        colorScheme: ColorScheme.fromSeed(seedColor: Colors.deepPurple),
        useMaterial3: true,
      ),
      home: const MyHomePage(title: 'Flutter Demo Home Page'),
    );
  }
}

class MyHomePage extends StatefulWidget {
  const MyHomePage({super.key, required this.title});
  final String title;

  [@override](/user/override)
  State<MyHomePage> createState() => _MyHomePageState();
}

class _MyHomePageState extends State<MyHomePage> {
  int _counter = 0;

  void _incrementCounter() {
    setState(() {
      _counter++;
    });
  }

  [@override](/user/override)
  void initState() {
    fetchingEvent();
    super.initState();
  }

  void fetchingEvent() async {
    await AnbocasTicketsApi.event
        .get(companyId: "08277ced-baec-4751-87b1-4786c786636a");
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        backgroundColor: Theme.of(context).colorScheme.inversePrimary,
        title: Text(widget.title),
      ),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: [
            const Text(
              '你已经按下了按钮这么多次:',
            ),
            Text(
              '$_counter',
              style: Theme.of(context).textTheme.headlineMedium,
            ),
          ],
        ),
      ),
      floatingActionButton: FloatingActionButton(
        onPressed: _incrementCounter,
        tooltip: '增加',
        child: const Icon(Icons.add),
      ),
    );
  }
}