panoptes-client

A Javascript client to access the Panoptes API

Usage no npm install needed!

<script type="module">
  import panoptesClient from 'https://cdn.skypack.dev/panoptes-client';
</script>

README

Panoptes Client

A Javascript client for accessing the Panoptes API.

Installation

You can install the client from NPM:

npm install panoptes-client

and use it with:

ES5

apiClient = require('panoptes-client/lib/api-client');
auth = require('panoptes-client/lib/auth');
oauth = require('panoptes-client/lib/oauth');
talkClient = require('panoptes-client/lib/talk-client');

ES6

import apiClient from 'panoptes-client/lib/api-client'
import auth from 'panoptes-client/lib/auth'
import oauth from 'panoptes-client/lib/oauth'
import talkClient from 'panoptes-client/lib/talk-client'

Documentation

The documentation for the library is available at https://zooniverse.github.io/panoptes-javascript-client/. If there's anything missing, submit a PR!

Resource access

The Panoptes API is built on the very generically named JSON API Spec. This client leans heavily on this library to make it easy to access different resources that the API offers.

Conventions

This project adheres to Semantic Versioning, and follows the changelog format set out at Keep a CHANGELOG.

Running the tests

Tests (via tap) exist for the auth module, and can be run with npm run test.

License

Copyright 2015 Zooniverse

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.