| Wiki Markup |
|---|
Note: These operations are RESTful so that the APIs are easy to understand and access, and not bound to a particular implementation's model. Authentication is at the HTTP layer and not discussed here. |
...
This document assumes JSON, however XML-based documents are easy to envision. |
...
hasMember
Determine if a subject is a member of a group.
Request Format
Method | GET |
|---|---|
URL | |
Request Body | None |
Response Format
HTTP Status | Response Body | Description |
|---|---|---|
200 OK | SubjectID Document | Member Found |
404 Not Found | None | Member Not Found |
...
h3. hasMember Determine if a subject is a member of a group. h4. Request Format || Method | GET || || URL | {{/groups/}}{{{}_<groupid>_{}}}{{/members/}}{{{}_<memberid>_{}}}{{\[?immediacy=}}{{{}_<immediacy>_{}}}{{\]}} || || Request Body | _None_ || h4. Response Format || HTTP Status || Response Body || Description || | 200 OK | SubjectID Document\\ {"ResponseType":"SubjectIDResponse", "Version":"1.0", "SubjectType":("Group"|"Person"), "Id":"<ID>"} | Member Found | | 404 Not Found | _None_ | Member Not Found | ---- Note: Because RESTful URLs are "eternal", _groupid_ and _memberid_ must be persistent (ie: pretty much non-changeable), and therefore should probably be implemented as [UUIDs|http://en.wikipedia.org/wiki/UUID]. We would therefore need an identifier mapping service. |