metamaps--metamaps/doc/api/apis/synapses.raml

101 lines
2.7 KiB
Text
Raw Normal View History

2016-10-04 04:11:58 +00:00
#type: collection
get:
is: [ searchable: { searchFields: "desc" }, embeddable: { embedFields: "topic1,topic2,user" }, orderable, pageable ]
responses:
200:
body:
application/json:
example: !include ../examples/synapses.json
post:
body:
application/json:
properties:
desc:
2016-10-04 07:30:06 +00:00
description: text description of this synapse
required: false
category:
2016-10-04 07:30:06 +00:00
description: |
<code>from-to</code> or <code>both</code>
permission:
description: commons, public, or private
topic1_id:
description: the topic being linked from
topic2_id:
description: the topic being linked to
user_id:
description: the creator of the topic
responses:
201:
body:
application/json:
example: !include ../examples/synapse.json
/{id}:
2016-10-04 04:11:58 +00:00
#type: item
get:
is: [ embeddable: { embedFields: "topic1,topic2,user" } ]
responses:
200:
body:
application/json:
example: !include ../examples/synapse.json
put:
body:
application/json:
properties:
desc:
2016-10-04 07:30:06 +00:00
description: text description of this synapse
required: false
category:
2016-10-04 07:30:06 +00:00
description: |
<code>from-to</code> or <code>both</code>
required: false
permission:
description: commons, public, or private
2016-10-04 07:30:06 +00:00
required: false
topic1_id:
description: the topic being linked from
2016-10-04 07:30:06 +00:00
required: false
topic2_id:
description: the topic being linked to
2016-10-04 07:30:06 +00:00
required: false
user_id:
description: the creator of the topic
2016-10-04 07:30:06 +00:00
required: false
responses:
200:
body:
application/json:
example: !include ../examples/synapse.json
patch:
body:
application/json:
properties:
desc:
2016-10-04 07:30:06 +00:00
description: text description of this synapse
required: false
category:
2016-10-04 07:30:06 +00:00
description: |
<code>from-to</code> or <code>both</code>
required: false
permission:
description: commons, public, or private
2016-10-04 07:30:06 +00:00
required: false
topic1_id:
description: the topic being linked from
2016-10-04 07:30:06 +00:00
required: false
topic2_id:
description: the topic being linked to
2016-10-04 07:30:06 +00:00
required: false
user_id:
description: the creator of the topic
2016-10-04 07:30:06 +00:00
required: false
responses:
200:
body:
application/json:
example: !include ../examples/synapse.json
delete:
responses:
204:
description: No content