Skip to main content

Plone JSON API -- Routes

Project description

Plone JSON API Routes

Author:

Ramon Bartl (RIDING BYTES - http://ridingbytes.com)

Version:

0.9.3

Lastest Build Status

Master Branch https://github.com/collective/plone.jsonapi.routes

Build Status https://readthedocs.org/projects/pip/badge/

Introduction

This is an add-on package for plone.jsonapi.core which provides some basic URLs for Plone standard contents (and more).

Motivation

The routes package is built on top of the plone.jsonapi.core package to allow Plone developers to build modern (JavaScript) web UIs which communicate through a RESTful API with their Plone site.

Compatibility

The plone.jsonapi.routes is compatible with Plone 4 and 5.

Documentation

http://plonejsonapiroutes.readthedocs.org

Source:

https://github.com/collective/plone.jsonapi.routes/tree/master/docs

See it in action

A small tec demo is available on youtube:

http://www.youtube.com/watch?v=MiwgkWLMUqk

License

MIT - do what you want

Changelog

0.9.4 - 2017-10-17

Changes

  • Merge brain data to object info

  • Handle Zope Datetime Fields

  • Support Backbone.js REST API

0.9.3 - 2017-05-14

Changes

  • IDataManager contain now a json_data method to return a JSON suitable return structure or delegate to the IFieldManager.json_data method. Please see section “Customizing” in the documentation for more details.

  • Added support for z3c.relationfield.interfaces.IRelationList fields

  • Added support for plone.app.textfield.interfaces.IRichText fields

  • Added support for plone.app.blob.interfaces.IBlobField fields

  • More code cleanup and refactoring (coming closer to a robust 1.0.0 release!)

0.9.2 - 2017-05-12

Changes

  • Added IFieldManager adapter to get and set the value on field level.

  • Removed build number from version route JSON response.

  • Content route improved.

  • API refactored.

  • Improved users route.

  • Updated documentation

0.9.1 - 2017-04-20

Changes

  • Added ICatalog and ICatalogQuery adapter for full search control. See docs for usage.

  • Removed query module in favor of the new adapters.

  • Removed multiple catalog query functionality. Please define a custom ICatalog adapter if you need it.

  • Added generic route provider for all portal_types. N.B. The old-style route providers, e.g. folders, documents etc., are now obsolete. Please use the lower portal type name instead, e.g. folder, docuememt

  • The users route shows now more details of the users and results are now batched.

  • Removed default getObjPositionInParent sorting. Please specify explicitly via sort_on.

  • UID of the plone site is now ‘0’ instead of 0.

  • Huge code refactoring and cleanup.

0.9.0 - 2017-01-12

Changes

  • API mthods get_items and get_batched accept now keyword paramters. Keywords can be catalog indexes, e.g. id=document-1 or a complete catalog query objejt, e.g. query={‘portal_type’: ‘Document’}.

  • Changed get_contents method to use the search functionality from the query module.

  • More doctests added

0.8.9 - 2017-01-11

Changes

  • Catalog to query can now be set via the catalog request parameter.

  • Optimized search logic

  • Fixed issue with multiple portal_type parameters in request

  • Code Refactoring

  • More tests

0.8.8 - 2017-01-10

Changes

  • Handle catalog queries for multiple contents, which might be located in different catalogs.

  • Fixed an issue where the batch navigation did not show more results when using multiple portal_type request parameters.

0.8.7 - 2017-01-10

Changes

  • Handle Reference Fields: Reference fields containing a reference can be updated with a dictionary, e.g.:

    {
      uid: <UID of a content containing a reference field>,
      ReferenceField: {
        "title": "New Title"
      }
    }
  • Added module underscore to the tests suite

  • Validation for the entire object added

  • Get the catalog to query from Archtype Tool and default to portal_catalog

  • Use explicit namespace in route providers

  • Handle Reference Fields (Fields containing and ImplicitAcquisitionWrapper object)

  • Added ZCML directive to enable/disable route registrations (default enabled):

    <!-- Disable route registration -->
    <plone:jsonapi
        register_api_routes="False"
    />
  • Version route is now part of the standard route providers

  • Dropped AdvancedQuery handling

0.8.6 - 2016-04-08

Fix for broken release 0.8.5

0.8.5 - 2016-04-08

CLOSED ISSUES

0.8.4 - 2016-01-14

CLOSED ISSUES

API CHANGES

  • Sharing information can be displayed for objects. Use ?sharing=yes

0.8.3 - 2015-09-14

CLOSED ISSUES

API CHANGES

  • File data not included by default anymore. Use ?filedata=yes

  • Workflow data not included by default anymore. Use ?workflow=yes

  • Workflow data is now located at the key workflow

  • The complete flag can be now negated, even if the full object is displayes ?complete=no

  • The state key is removed – use review_state instead

  • Parent URL data included now for brain results

0.8.2 - 2015-09-09

CLOSED ISSUES

0.8.1 - 2015-09-06

CLOSED ISSUES

ENHANCEMENTS

  • API actions to cut/copy/paste contents

  • New route provider plonesites

  • Support for catalog brain schema

0.8 - 2015-07-20

CLOSED ISSUES

0.7 - 2015-07-09

CLOSED ISSUES

OTHER CHANGES

  • Updated Documentation

  • Request module: Added helper functions

  • Travis CI integration

0.6 - 2015-02-22

CLOSED ISSUES

0.5 - 2015-02-20

CLOSED ISSUES

OTHER CHANGES

  • Added batch adapter

  • Added more tests

0.4 - 2015-01-13

FIXED ISSUES

ENHANCEMENTS

OTHER CHANGES

  • added IDataManager field data manager

  • added /auth route to enforce a basic auth

  • added a custom exception class to set the right response status

  • added recent_modified and recent_created handling

  • added unittests for the api and request module

  • no more request passing anymore - all handled by the request module now

0.3 - 2014-10-14

FIXED ISSUES

ENHANCEMENTS

DOCUMENTATION

0.2 - 2014-03-05

FIXED ISSUES

API CHANGES

  • API root url provided.

  • Image and file fields are now rendered as a nested structure, e.g:

    {
      data: b64,
      size: 42,
      content_type: "image/png"
    }
  • Workflow info is provided where possible, e.g:

    {
      status: "Private",
      review_state: "private",
      transitions: [
        {
          url: ".../content_status_modify?workflow_action=submit",
          display: "Puts your item in a review queue, so it can be published on the site.",
          value: "submit"
        },
      ],
      workflow: "simple_publication_workflow"
    }

0.1 - 2014-01-23

  • first public release

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

plone.jsonapi.routes-0.9.4.tar.gz (80.7 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page