metamaps--metamaps/doc/api/apis/topics.raml
Devin Howard 3843cab643 rails 5 + api v2 + raml api docs (#593)
* update Gemfile to rails 5 and ruby 2.3.0

* fiddle with javascripts and add sprockets manifest file

* update config directory for rails 5

* fix some errors with controllers/serializers

* fix travis and rspec

* new serializers renamed to serializers

* module Api::V1

* reusable embedding code

* add index/collections/paging. overriding most of snorlax now |:)

* raml api documentation + rspec tests to verify schemas/examples

* add sorting by ?sort and searching by ?q. Add pagination Link headers

* api v1 => v2

* fill out synapse api

* alphabetize map policy

* fix page thing

* fill out maps api

* formParameters => properties, and fiddle with map api

* more raml 1.0 stuff i'm learning about

* deprecate v1 api

* rails 5 uses ApplicationRecord class for app-wide model config

* Update topic spec for api v2

* workaround for user_preference.rb issue

* get ready for token api docs. also TODO is mapping api docs

* spec out mapping api

* map/mapping/synapse spec, plus other bugs

* awesome, token specs/apis are done

* add sanity checks to the api tests

* more cleanup

* devise fix

* fix starred map error
2016-09-21 13:22:40 -04:00

73 lines
1.6 KiB
Plaintext

type: collection
get:
responses:
200:
body:
application/json:
example: !include ../examples/topics.json
post:
body:
application/json:
properties:
name:
description: name
desc:
description: description
link:
description: (optional) link to content on the web
permission:
description: commons, public, or private
metacode_id:
description: Topic's metacode
responses:
201:
body:
application/json:
example: !include ../examples/topic.json
/{id}:
type: item
get:
responses:
200:
body:
application/json:
example: !include ../examples/topic.json
put:
body:
application/json:
properties:
name:
description: name
desc:
description: description
link:
description: (optional) link to content on the web
permission:
description: commons, public, or private
responses:
200:
body:
application/json:
example: !include ../examples/topic.json
patch:
body:
application/json:
properties:
name:
description: name
desc:
description: description
link:
description: (optional) link to content on the web
permission:
description: commons, public, or private
responses:
200:
body:
application/json:
example: !include ../examples/topic.json
delete:
responses:
204:
description: No content