Get the signed-in person
getMe
GET /api/v1/me
Scope:
profileRate cost: 1Who the token acts as
The same body as GET /api/me, which stays.
Request
Section titled “Request”curl "$FOLDR/api/v1/me" \ -H "Authorization: Bearer $TOKEN"$FOLDR is your site’s address (for example https://files.example.com) and $TOKEN is an access token. See Getting access.
Responses
Section titled “Responses”| Status | Meaning | Body |
|---|---|---|
| 200 | The Me. | application/json: Me |
200 response
Section titled “200 response”Me:
| Field | Type | Description |
|---|---|---|
name | string | Required. Display name, or the username where there is none. |
email | string or null | Required. Email address, where the directory has one. |
username | string | Required. Sign-in name. |
Example:
{ "name": "string", "email": "string", "username": "string"}Errors
Section titled “Errors”Every error is an application/problem+json document (ProblemDetails); branch on its type or code. See Errors.
| Status | Problem types | When |
|---|---|---|
| 400 | invalid-request | Invalid request (invalid-request). |
| 401 | invalid-token | Invalid token (invalid-token). |
| 403 | insufficient-scope | Insufficient scope (insufficient-scope). |
| 429 | rate-limited | Too many requests (rate-limited). |
| 500 | internal-error | Internal error (internal-error). |