atlassian_apis
0.15.0, released 3 years ago by xaha.dev
Dart client for Atlassian REST APIs (Jira, Confluence, Service Desk, Cloud Admin).
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.
- cronet_http
An Android Flutter plugin providing access to the Cronet HTTP client.
87Compare - dbus
Native Dart D-Bus client for Linux and Windows.
91Compare - stream_chat
Low‑level Dart client for Stream Chat API
91Compare - aws_client
Strongly-typed Dart client libraries for accessing Amazon Web Services (AWS) APIs.
86Compare