Skip to content
pubscout

atlassian_apis

0.15.0, released 3 years ago by xaha.dev

Dart client for Atlassian REST APIs (Jira, Confluence, Service Desk, Cloud Admin).

WASM-ready
$ flutter pub add atlassian_apis
Source repository

What it does

It wraps Atlassian’s OpenAPI definitions into typed Dart classes, handling authentication, request building, and response parsing. The client supports all major Atlassian services and can upload files via multipart requests.

AI-written summary of version 0.15.0, based on the package's README and metadata. Report an inaccuracy

Use it when

  • You need to integrate with Jira, Confluence, or Service Desk from a Dart/Flutter app.
  • You prefer a fully typed API client generated from OpenAPI schemas.
  • You want to avoid writing boilerplate HTTP code for Atlassian endpoints.

Skip it when

  • You only need a few specific endpoints and want a lightweight solution.
  • You are already using another HTTP client like dio and prefer to keep a single HTTP layer.

Strengths

  • Fully typed, generated from official OpenAPI specs; reduces manual coding.
  • Supports authentication via API token or OAuth, and multipart uploads for attachments.
  • Cross‑platform (Android, iOS, web, desktop).

Weaknesses

  • Relies on http package; no advanced features like interceptors or retry logic.
  • Requires manual updates when Atlassian changes schemas; you must bump the package version.
  • No built‑in caching or offline support.

Setup

Kind
Pure Dart
Effort
Low
Code generation
No
Direct dependencies
2

Add dependency, create ApiClient with basicAuthentication, instantiate JiraPlatformApi or ConfluenceApi, call methods. No build_runner needed.

import 'dart:io';
import 'package:atlassian_apis/jira_platform.dart';

void main() async {
  var user = Platform.environment['ATLASSIAN_USER']!;
  var token = Platform.environment['ATLASSIAN_API_TOKEN']!;
  var client = ApiClient.basicAuthentication(
      Uri.https('<your-account>.atlassian.net', ''),
      user: user,
      apiToken: token);
  var jira = JiraPlatformApi(client);
  var projects = await jira.projects.searchProjects();
  print(projects);
  client.close();
}

Alternatives

Packages that do the same job and could replace atlassian_apis.