API lýsing · Lyklar
Afturkalla þennan lykil
POST/v1/me/key/revoke
Afturkallar lykilinn sem beiðnin er undirrituð með, strax og fyrir fullt og allt, eins og að afturkalla hann í Stillingum → API. Hvaða gildi lykill sem er getur afturkallað sjálfan sig: fyrir skriftu sem er búin að nota lykilinn sinn, eða skipanalínutól sem skráir sig út. Eigandi aðgangsins fær venjulega tölvupóstinn.
- Heimild
- Hvaða gildur lykill sem er.
- Takmarkaflokkur
read- Auðkenning
- Undirrituð
Svör
200 OK
Lykillinn, nú afturkallaður. application/json · RevokedKey
keyobject3 reitir
idstringstatus"revoked"revoked_atstring (date-time)
Ö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. |
| 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/key/revoke \
-X POST \
$(./sign-headers.sh POST /v1/me/key/revoke | sed 's/^/-H /')import { Myntkaup } from "@myntkaup/api";
const client = new Myntkaup(); // reads the key from the environment
// Every request this key signs after this fails.
const { key } = await client.revokeKey();
console.log(key.id, key.revoked_at);from myntkaup import Myntkaup
client = Myntkaup() # reads the key from the environment
# Every request this key signs after this fails.
key = client.revoke_key()["key"]
print(key["id"], key["revoked_at"])Svar
{
"key": {
"id": "mk_live_4f9c2a7d1e0b8c6a5d3f",
"status": "revoked",
"revoked_at": "2026-11-03T10:15:10Z"
}
}Grunnslóð https://public-api.myntkaup.is