Hosted ongabo.esvia theHypermedia Protocol

Query URL FormatsHow you can address various things in the hypermedia network

A URL that references one or more resources

Exact Resource

Proposal Stage: Confirmed

example document:

hm://MY_ID/cars/ferarri

reference my home document

hm://MY_ID

reference my comment:

hm://MY_ID/COMMENT_TSID

Profile

Proposal Stage: Good Idea

Reference my "Profile" metadata

hm://MY_ID/:profile

Contacts

Proposal Stage: Confirmed

Reference one of my contacts

hm://MY_ID/CONTACT_TSID

List people who I have added as a contact

List people who have added me

Search

Proposal Stage: Good Idea

Search the node for all content about "robots"

hm://search?q=robots

Search gabo's server

https://gabo.es/hm/search?q=robots

Direct Children

Proposal Stage: Good Idea

the top-level documents under my account

hm://MY_ID/:documents

hm://search?type=documents&space=MY_ID

All my cars documents

hm://MY_ID/cars/:documents?view=card

All Children

Proposal Stage: Good Idea

all of my documents:

hm://MY_ID/:documents?r

All my documents about cars

hm://MY_ID/cars/:documents

Activity

Proposal Stage: Maybe

Returns EVENTS of Ferarri document

hm://MY_ID/cars/ferarri/:activity

Returns ALL EVENTS within the cars section of my site

hm://MY_ID/cars/:all-activity

Returns ALL EVENTS on my site (aka the "Site Feed")

hm://MY_ID/:all-activity?eventType=comments&groupBy=thread

Global Activity feed

hm://activity

Citations

Proposal Stage: Maybe

Query for known links to my ferarri

hm://MY_ID/cars/ferrari/:activity?events=citation

BTW, the default query param is:

?events=citation,version,comment,capability

Versions

Proposal Stage: Maybe

Query for the versions of my cars document:

hm://MY_ID/cars/:activity?events=version

Peer

Proposal Stage: Maybe

Maybe, reference a specific Peer ID

hm://peer/PEER_ID

Search on peer:

hm://peer/PEER_ID/search

Load my cars doc, loaded from this specific peer

hm://MY_ID@PEER_ID/cars?l

or, from the peer on gabo.es

hm://MY_ID@gabo.es/cars?l

Do you like what you are reading?. Subscribe to receive updates.

Unsubscribe anytime