jsonapi_client 0.2.1

  • README.md
  • Installing
  • Versions
  • 1


JSON API Client in Dartlang #

Dartlang implementation of JSON API Client, adherent to JSON API specification 1.0.

Installation #

Add jsonapi_client to your pubspec.yaml:

  jsonapi_client: "0.2.1"

Usage #

Instantiate a client:

JSONAPIClient c = new JSONAPIClient();

then use it:

try {
  JSONAPIDocument d = await c.get(
} catch (err) {
  // the API did not return a valid JSON API Document

GET method #

Used to retrieve a document containing a JSON API resource or a list of resources.

Future<JSONAPIDocument> get(String url, {List<String> includeModels, Map headers})

POST method #

Used to create a document containing a JSON API resource.

Future<JSONAPIDocument> post(String url, String document, {List<String> includeModels, Map headers})

DELETE method #

Used to delete a resource.

Future delete(String url, {Map headers})

Tests #

You can test your application which uses JSONAPIClient by using the included MockJSONAPIClient class.

MockJSONAPIClient mockClient = new MockJSONAPIClient();

JSONAPIDocument mockDocument = new JSONAPIDocument({
  "data": {
      "id": "1",
      "type": "persons",
      "attributes": {
        "name": "Gianfranco",
        "surname": "Reppucci"

payload = '''
  "data": {
      "type": "persons",
      "attributes": {
        "name": "Gianfranco",
        "surname": "Reppucci"


mockClient.post('http://mockapi.test/persons', payload, includeModels: ['company'], headers: {'X-Test': 'Mock-Value'}); // will return mockDocument as output

// you can access the last request by using these mock client getters


All notable changes to this project will be documented in this file. This project adheres to Semantic Versioning.

[0.2.1] - 2016-07-07

Added #

  • Attributes requestUrl,requestPayload, requestIncludedModels, requestHeaders to MockJSONAPIClient class.

[0.2.0] - 2016-07-06

Added #

  • Class MockJSONAPIClient.

[0.0.1] - 2016-07-05

Initial version.

Use this package as a library

1. Depend on it

Add this to your package's pubspec.yaml file:

  jsonapi_client: ^0.2.1

2. Install it

You can install packages from the command line:

with pub:

$ pub get

Alternatively, your editor might support pub get. Check the docs for your editor to learn more.

3. Import it

Now in your Dart code, you can use:

import 'package:jsonapi_client/jsonapi_client.dart';
Version Uploaded Documentation Archive
0.2.1 Jul 7, 2016 Go to the documentation of jsonapi_client 0.2.1 Download jsonapi_client 0.2.1 archive
0.2.0 Jul 6, 2016 Go to the documentation of jsonapi_client 0.2.0 Download jsonapi_client 0.2.0 archive
0.0.1 Jul 5, 2016 Go to the documentation of jsonapi_client 0.0.1 Download jsonapi_client 0.0.1 archive
Describes how popular the package is relative to other packages. [more]
Code health derived from static analysis. [more]
Reflects how tidy and up-to-date the package is. [more]
Weighted score of the above. [more]
Learn more about scoring.

The package version is not analyzed, because it does not support Dart 2. Until this is resolved, the package will receive a health and maintenance score of 0.

Analysis issues and suggestions

Support Dart 2 in pubspec.yaml.

The SDK constraint in pubspec.yaml doesn't allow the Dart 2.0.0 release. For information about upgrading it to be Dart 2 compatible, please see https://www.dartlang.org/dart-2#migration.

Maintenance issues and suggestions

Make sure dartdoc successfully runs on your package's source files. (-10 points)

Dependencies were not resolved.


Package Constraint Resolved Available
Direct dependencies
Dart SDK >=1.13.0 <2.0.0