API lýsing · Aðgangur
Aðgangurinn og þessi lykill
GET/v1/me
Tegund aðgangs, birtingarnafn og þrep, og auðkenni, heiti, heimildir, leyfðar IP tölur og gildistími þessa lykils.
- Heimild
- Hvaða gildur lykill sem er.
- Takmarkaflokkur
read- Auðkenning
- Undirrituð
Svör
200 OK
Aðgangurinn og lykillinn. application/json · Me
accountobject3 reitir
typestring (enum)namestringtierstringÞóknunarþrep aðgangsins.
keyobject6 reitir
idstringnamestringscopesfylki af string (enum)ip_allowlistfylki af stringcreated_atstring (date-time)expires_atstring (date-time)getur verið nullnull fyrir ótímabundinn lykil.
Öll svör bera MK-Request-Id, auk RateLimit-Policy og RateLimit.
Villur
Villur nota villuumslagið. Greindu þær eftir code.
| Staða | Kóði | Merking |
|---|---|---|
| 400 | invalid_request | Beiðnin er gölluð: ógilt JSON, óþekktur eða ógildur reitur, eða haus vantar. |
| 401 | invalid_signature | MK-* hausana vantar eða þeir eru gallaðir, auðkenni lykilsins er óþekkt eða undirskriftin passar ekki. |
| 401 | key_expired | Gildistími lykilsins er liðinn. |
| 401 | key_revoked | Lykillinn var afturkallaður. |
| 401 | timestamp_out_of_range | MK-Timestamp munar meira en 30 sekúndum frá klukku netþjónsins. |
| 401 | nonce_reused | Þessi lykill hefur þegar notað þetta MK-Nonce. |
| 403 | ip_not_allowed | Beiðnin kom frá IP tölu sem er ekki meðal leyfðra IP talna lykilsins. |
| 403 | account_restricted | Aðgangurinn getur ekki notað API-ið eins og er (til dæmis læstur, óvirkur eða nýskráningu ólokið). |
| 403 | api_access_disabled | Slökkt er á aðgangi að API-inu. |
| 429 | rate_limited | Of margar beiðnir. Bíddu í Retry-After sekúndur. |
| 429 | too_many_concurrent_requests | Of margar beiðnir í vinnslu í einu fyrir þennan lykil eða aðgang. |
| 429 | key_suspended | Lykillinn er stöðvaður, til dæmis eftir að hafa farið ítrekað yfir beiðnatakmörk. |
| 500 | internal_error | Eitthvað fór úrskeiðis hjá okkur. |
| 502 | bad_gateway | Undirliggjandi þjónusta svaraði á óvæntan hátt. |
| 503 | overloaded | Þjónustan er undir of miklu álagi. Reyndu aftur eftir Retry-After sekúndur. |
| 503 | service_unavailable | Þjónustan er tímabundið ekki tiltæk. |
| 504 | gateway_timeout | Undirliggjandi þjónusta svaraði ekki í tæka tíð. POST beiðni gæti samt klárast; reyndu aftur með sama Idempotency-Key. |
Beiðni
# Signed by sign-headers.sh: see Authentication
curl https://public-api.myntkaup.is/v1/me \
$(./sign-headers.sh GET /v1/me | sed 's/^/-H /')import { Myntkaup } from "@myntkaup/api";
const client = new Myntkaup(); // reads the key from the environment
const me = await client.me();
console.log(me.account.name, me.key.scopes);from myntkaup import Myntkaup
client = Myntkaup() # reads the key from the environment
me = client.me()
print(me["account"]["name"], me["key"]["scopes"])Svar
{
"account": {
"type": "person",
"name": "Jón Jónsson",
"tier": "tier-1"
},
"key": {
"id": "mk_live_4f9c2a7d1e0b8c6a5d3f",
"name": "DCA bot",
"scopes": [
"account:read",
"transactions:read"
],
"ip_allowlist": [
"203.0.113.10"
],
"created_at": "2026-11-01T09:30:00Z",
"expires_at": "2027-01-30T09:30:00Z"
}
}Grunnslóð https://public-api.myntkaup.is