Sources

Get a source

Returns a source's name and mark. A source needs no item or key to be read, but you see only your own, those you claim and those of items you can read, unless you hold keys.manage.

GET
/source

Authorization

headerAuthorizationBearer <token>

Authenticate with an API key (marfa_k1_…) or an OAuth access token (marfa_at_…).

Query parameters

source*string

The source code. It's a query parameter because a code such as .. or one holding / can't travel safely in a path.

Response body

Returns the source.

application/json
  1. response

A source code with the name and mark it's shown by.

source*string

The source code, as items carry it in source.

name*string

The name to show for the source.

name_from*string

Where name comes from: set on the source, the app signed in under it, the label of the key that holds it, or the code itself.

Value in"set""app""key""code"
mark?string

The icon ID set for the source, from the same sets as a type's icon. Absent until someone sets one.

curl -X GET 'http://localhost:8600/source?source=string'
{  "source": "string",  "name": "string",  "name_from": "set",  "mark": "string"}