rename api endpoint yet again. item/store appears to be blacklisted in some hosting environments.
This commit is contained in:
parent
53c950b235
commit
f5f1b9602a
@ -1,104 +0,0 @@
|
|||||||
API item/store
|
|
||||||
==============
|
|
||||||
|
|
||||||
Usage: POST /api/z/1.0/item/store
|
|
||||||
|
|
||||||
Description: item/store posts an item (typically a conversation item or post, but can be any item) using form input.
|
|
||||||
|
|
||||||
|
|
||||||
Required:
|
|
||||||
|
|
||||||
- body
|
|
||||||
|
|
||||||
text/bbcode contents by default.
|
|
||||||
|
|
||||||
|
|
||||||
Optional:
|
|
||||||
|
|
||||||
- $_FILES['media']
|
|
||||||
uploaded media file to include with post
|
|
||||||
|
|
||||||
- title
|
|
||||||
title of post/item
|
|
||||||
|
|
||||||
- contact_allow
|
|
||||||
array of xchan.xchan_hash allowed to view this item
|
|
||||||
|
|
||||||
- group_allow
|
|
||||||
array of group.hash allowed to view this item
|
|
||||||
|
|
||||||
- contact_deny
|
|
||||||
array of xchan.xchan_hash not allowed to view this item
|
|
||||||
|
|
||||||
- group_deny
|
|
||||||
array of group.hash not allowed to view this item
|
|
||||||
|
|
||||||
- coord
|
|
||||||
geographic coordinates
|
|
||||||
|
|
||||||
- location
|
|
||||||
freefrom location
|
|
||||||
|
|
||||||
- expire
|
|
||||||
datetime this post will expire or be removed
|
|
||||||
|
|
||||||
- mimetype
|
|
||||||
mimetype if not text/bbcode
|
|
||||||
|
|
||||||
- parent
|
|
||||||
item.id of parent to this post (makes it a comment)
|
|
||||||
|
|
||||||
- parent_mid
|
|
||||||
alternate form of parent using message_id
|
|
||||||
|
|
||||||
- remote_xchan
|
|
||||||
xchan.xchan_hash of this message author if not the channel owner
|
|
||||||
|
|
||||||
- consensus
|
|
||||||
boolean set to true if this is a consensus or voting item (default false)
|
|
||||||
|
|
||||||
- nocomment
|
|
||||||
boolean set to true if comments are to be disabled (default false)
|
|
||||||
|
|
||||||
- origin
|
|
||||||
do not use this without reading the code
|
|
||||||
|
|
||||||
- namespace
|
|
||||||
persistent identity for a remote network or service
|
|
||||||
|
|
||||||
- remote_id
|
|
||||||
message_id of this resource on a remote network or service
|
|
||||||
|
|
||||||
- message_id
|
|
||||||
message_id of this item (leave unset to generate one)
|
|
||||||
|
|
||||||
- created
|
|
||||||
datetime of message creation
|
|
||||||
|
|
||||||
- post_id
|
|
||||||
existing item.id if this is an edit operation
|
|
||||||
|
|
||||||
- app
|
|
||||||
application or network name to display with item
|
|
||||||
|
|
||||||
- categories
|
|
||||||
comma separated categories for this item
|
|
||||||
|
|
||||||
- webpage
|
|
||||||
item.page_type if not 0
|
|
||||||
|
|
||||||
- pagetitle
|
|
||||||
for webpage and design elements, the 'page name'
|
|
||||||
|
|
||||||
- layout_mid
|
|
||||||
item.mid of layout for this design element
|
|
||||||
|
|
||||||
- plink
|
|
||||||
permalink for this item if different than the default
|
|
||||||
|
|
||||||
- verb
|
|
||||||
activitystream verb for this item/activity
|
|
||||||
|
|
||||||
- obj_type
|
|
||||||
activitystream object type for this item/activity
|
|
||||||
|
|
225
doc/api_item_update.md
Normal file
225
doc/api_item_update.md
Normal file
@ -0,0 +1,225 @@
|
|||||||
|
API item/update
|
||||||
|
===============
|
||||||
|
|
||||||
|
|
||||||
|
Usage: POST /api/z/1.0/item/update
|
||||||
|
|
||||||
|
Description: item/update posts an item (typically a conversation item or post, but can be any item) using form input.
|
||||||
|
|
||||||
|
|
||||||
|
Required:
|
||||||
|
|
||||||
|
- body
|
||||||
|
|
||||||
|
text/bbcode contents by default.
|
||||||
|
|
||||||
|
|
||||||
|
Optional:
|
||||||
|
|
||||||
|
- $_FILES['media']
|
||||||
|
|
||||||
|
uploaded media file to include with post
|
||||||
|
|
||||||
|
- title
|
||||||
|
|
||||||
|
title of post/item
|
||||||
|
|
||||||
|
- contact_allow
|
||||||
|
|
||||||
|
array of xchan.xchan_hash allowed to view this item
|
||||||
|
|
||||||
|
- group_allow
|
||||||
|
|
||||||
|
array of group.hash allowed to view this item
|
||||||
|
|
||||||
|
- contact_deny
|
||||||
|
|
||||||
|
array of xchan.xchan_hash not allowed to view this item
|
||||||
|
|
||||||
|
- group_deny
|
||||||
|
|
||||||
|
array of group.hash not allowed to view this item
|
||||||
|
|
||||||
|
- coord
|
||||||
|
|
||||||
|
geographic coordinates
|
||||||
|
|
||||||
|
- location
|
||||||
|
|
||||||
|
freefrom location
|
||||||
|
|
||||||
|
- expire
|
||||||
|
|
||||||
|
datetime this post will expire or be removed
|
||||||
|
|
||||||
|
- mimetype
|
||||||
|
|
||||||
|
mimetype if not text/bbcode
|
||||||
|
|
||||||
|
- parent
|
||||||
|
|
||||||
|
item.id of parent to this post (makes it a comment)
|
||||||
|
|
||||||
|
- parent_mid
|
||||||
|
|
||||||
|
alternate form of parent using message_id
|
||||||
|
|
||||||
|
- remote_xchan
|
||||||
|
|
||||||
|
xchan.xchan_hash of this message author if not the channel owner
|
||||||
|
|
||||||
|
- consensus
|
||||||
|
|
||||||
|
boolean set to true if this is a consensus or voting item (default false)
|
||||||
|
|
||||||
|
- nocomment
|
||||||
|
|
||||||
|
boolean set to true if comments are to be disabled (default false)
|
||||||
|
|
||||||
|
- origin
|
||||||
|
|
||||||
|
do not use this without reading the code
|
||||||
|
|
||||||
|
- namespace
|
||||||
|
|
||||||
|
persistent identity for a remote network or service
|
||||||
|
|
||||||
|
- remote_id
|
||||||
|
|
||||||
|
message_id of this resource on a remote network or service
|
||||||
|
|
||||||
|
- message_id
|
||||||
|
|
||||||
|
message_id of this item (leave unset to generate one)
|
||||||
|
|
||||||
|
- created
|
||||||
|
|
||||||
|
datetime of message creation
|
||||||
|
|
||||||
|
- post_id
|
||||||
|
|
||||||
|
existing item.id if this is an edit operation
|
||||||
|
|
||||||
|
- app
|
||||||
|
|
||||||
|
application or network name to display with item
|
||||||
|
|
||||||
|
- categories
|
||||||
|
|
||||||
|
comma separated categories for this item
|
||||||
|
|
||||||
|
- webpage
|
||||||
|
|
||||||
|
item.page_type if not 0
|
||||||
|
|
||||||
|
- pagetitle
|
||||||
|
|
||||||
|
for webpage and design elements, the 'page name'
|
||||||
|
|
||||||
|
- layout_mid
|
||||||
|
|
||||||
|
item.mid of layout for this design element
|
||||||
|
|
||||||
|
- plink
|
||||||
|
|
||||||
|
permalink for this item if different than the default
|
||||||
|
|
||||||
|
- verb
|
||||||
|
|
||||||
|
activitystream verb for this item/activity
|
||||||
|
|
||||||
|
- obj_type
|
||||||
|
|
||||||
|
activitystream object type for this item/activity
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
Example:
|
||||||
|
|
||||||
|
curl -u mychannel:mypassword https://xyz.macgirvin.com/api/z/1.0/item/update -d body="hello world"
|
||||||
|
|
||||||
|
|
||||||
|
Returns:
|
||||||
|
|
||||||
|
|
||||||
|
{
|
||||||
|
|
||||||
|
"success": true,
|
||||||
|
"item_id": "2245",
|
||||||
|
"item": {
|
||||||
|
"id": "2245",
|
||||||
|
"mid": "14135cdecf6b8e3891224e4391748722114da6668eebbcb56fe4667b60b88249@xyz.macgirvin.com",
|
||||||
|
"aid": "1",
|
||||||
|
"uid": "2",
|
||||||
|
"parent": "0",
|
||||||
|
"parent_mid": "14135cdecf6b8e3891224e4391748722114da6668eebbcb56fe4667b60b88249@xyz.macgirvin.com",
|
||||||
|
"thr_parent": "14135cdecf6b8e3891224e4391748722114da6668eebbcb56fe4667b60b88249@xyz.macgirvin.com",
|
||||||
|
"created": "2016-12-03 20:00:12",
|
||||||
|
"edited": "2016-12-03 20:00:12",
|
||||||
|
"expires": "0001-01-01 00:00:00",
|
||||||
|
"commented": "2016-12-03 20:00:12",
|
||||||
|
"received": "2016-12-03 20:00:12",
|
||||||
|
"changed": "2016-12-03 20:00:12",
|
||||||
|
"comments_closed": "0001-01-01 00:00:00",
|
||||||
|
"owner_xchan": "pgcJx1IQjuPkx8aI9qheJlBMZzJz-oTPjHy3h5pWlOVOriBO_cSiUhhqwhuZ74TYJ8_ECO3pPiRMWC0q8YPCQg",
|
||||||
|
"author_xchan": "pgcJx1IQjuPkx8aI9qheJlBMZzJz-oTPjHy3h5pWlOVOriBO_cSiUhhqwhuZ74TYJ8_ECO3pPiRMWC0q8YPCQg",
|
||||||
|
"source_xchan": "",
|
||||||
|
"mimetype": "text/bbcode",
|
||||||
|
"title": "",
|
||||||
|
"body": "hello world",
|
||||||
|
"html": "",
|
||||||
|
"app": "",
|
||||||
|
"lang": "",
|
||||||
|
"revision": "0",
|
||||||
|
"verb": "http://activitystrea.ms/schema/1.0/post",
|
||||||
|
"obj_type": "http://activitystrea.ms/schema/1.0/note",
|
||||||
|
"obj": "",
|
||||||
|
"tgt_type": "",
|
||||||
|
"target": "",
|
||||||
|
"layout_mid": "",
|
||||||
|
"postopts": "",
|
||||||
|
"route": "",
|
||||||
|
"llink": "https://xyz.macgirvin.com/display/14135cdecf6b8e3891224e4391748722114da6668eebbcb56fe4667b60b88249@xyz.macgirvin.com",
|
||||||
|
"plink": "https://xyz.macgirvin.com/channel/mychannel/?f=&mid=14135cdecf6b8e3891224e4391748722114da6668eebbcb56fe4667b60b88249@xyz.macgirvin.com",
|
||||||
|
"resource_id": "",
|
||||||
|
"resource_type": "",
|
||||||
|
"attach": "",
|
||||||
|
"sig": "sa4TOQNfHtV13HDZ1tuQGWNBpZp-nWhT2GMrZEmelXxa_IvEepD2SEsCTWOBqM8OKPJLfNy8_i-ORXjrOIIgAa_aT8cw5vka7Q0C8L9eEb_LegwQ_BtH0CXO5uT30e_8uowkwzh6kmlVg1ntD8QqrGgD5jTET_fMQOIw4gQUBh40GDG9RB4QnPp_MKsgemGrADnRk2vHO7-bR32yQ0JI-8G-eyeqGaaJmIwkHoi0vXsfjZtU7ijSLuKEBWboNjKEDU89-vQ1c5Kh1r0pmjiDk-a5JzZTYShpuhVA-vQgEcADA7wkf4lJZCYNwu3FRwHTvhSMdF0nmyv3aPFglQDky38-SAXZyQSvd7qlABHGCVVDmYrYaiq7Dh4rRENbAUf-UJFHPCVB7NRg34R8HIqmOKq1Su99bIWaoI2zuAQEVma9wLqMoFsluFhxX58KeVtlCZlro7tZ6z619-dthS_fwt0cL_2dZ3QwjG1P36Q4Y4KrCTpntn9ot5osh-HjVQ01h1I9yNCj6XPgYJ8Im3KT_G4hmMDFM7H9RUrYLl2o9XYyiS2nRrf4aJHa0UweBlAY4zcQG34bw2AMGCY53mwsSArf4Hs3rKu5GrGphuwYX0lHa7XEKMglwBWPWHI49q7-oNWr7aWwn1FnfaMfl4cQppCMtKESMNRKm_nb9Dsh5e0",
|
||||||
|
"diaspora_meta": "",
|
||||||
|
"location": "",
|
||||||
|
"coord": "",
|
||||||
|
"public_policy": "",
|
||||||
|
"comment_policy": "contacts",
|
||||||
|
"allow_cid": "",
|
||||||
|
"allow_gid": "",
|
||||||
|
"deny_cid": "",
|
||||||
|
"deny_gid": "",
|
||||||
|
"item_restrict": "0",
|
||||||
|
"item_flags": "0",
|
||||||
|
"item_private": "0",
|
||||||
|
"item_origin": "1",
|
||||||
|
"item_unseen": "0",
|
||||||
|
"item_starred": "0",
|
||||||
|
"item_uplink": "0",
|
||||||
|
"item_consensus": "0",
|
||||||
|
"item_wall": "1",
|
||||||
|
"item_thread_top": "1",
|
||||||
|
"item_notshown": "0",
|
||||||
|
"item_nsfw": "0",
|
||||||
|
"item_relay": "0",
|
||||||
|
"item_mentionsme": "0",
|
||||||
|
"item_nocomment": "0",
|
||||||
|
"item_obscured": "0",
|
||||||
|
"item_verified": "1",
|
||||||
|
"item_retained": "0",
|
||||||
|
"item_rss": "0",
|
||||||
|
"item_deleted": "0",
|
||||||
|
"item_type": "0",
|
||||||
|
"item_hidden": "0",
|
||||||
|
"item_unpublished": "0",
|
||||||
|
"item_delayed": "0",
|
||||||
|
"item_pending_remove": "0",
|
||||||
|
"item_blocked": "0"
|
||||||
|
}
|
||||||
|
|
||||||
|
}
|
@ -28,8 +28,8 @@
|
|||||||
api_register_func('api/z/1.0/group','api_group', true);
|
api_register_func('api/z/1.0/group','api_group', true);
|
||||||
api_register_func('api/red/xchan','api_red_xchan',true);
|
api_register_func('api/red/xchan','api_red_xchan',true);
|
||||||
api_register_func('api/z/1.0/xchan','api_red_xchan',true);
|
api_register_func('api/z/1.0/xchan','api_red_xchan',true);
|
||||||
api_register_func('api/red/item/store','red_item_store', true);
|
api_register_func('api/red/item/update','zot_item_update', true);
|
||||||
api_register_func('api/z/1.0/item/store','red_item_store', true);
|
api_register_func('api/z/1.0/item/update','zot_item_update', true);
|
||||||
api_register_func('api/red/item/full','red_item', true);
|
api_register_func('api/red/item/full','red_item', true);
|
||||||
api_register_func('api/z/1.0/item/full','red_item', true);
|
api_register_func('api/z/1.0/item/full','red_item', true);
|
||||||
|
|
||||||
@ -266,7 +266,7 @@
|
|||||||
require_once('include/hubloc.php');
|
require_once('include/hubloc.php');
|
||||||
|
|
||||||
if($_SERVER['REQUEST_METHOD'] === 'POST') {
|
if($_SERVER['REQUEST_METHOD'] === 'POST') {
|
||||||
$r = xchan_store($_REQUEST);
|
// $r = xchan_store($_REQUEST);
|
||||||
}
|
}
|
||||||
$r = xchan_fetch($_REQUEST);
|
$r = xchan_fetch($_REQUEST);
|
||||||
json_return_and_die($r);
|
json_return_and_die($r);
|
||||||
@ -341,7 +341,7 @@
|
|||||||
|
|
||||||
}
|
}
|
||||||
|
|
||||||
function red_item_store($type) {
|
function zot_item_update($type) {
|
||||||
|
|
||||||
if (api_user() === false) {
|
if (api_user() === false) {
|
||||||
logger('api_red_item_store: no user');
|
logger('api_red_item_store: no user');
|
||||||
|
Reference in New Issue
Block a user