self-serve

Proves the address: the calling email-less key sends back the code `POST /v1/keys/self/email` mailed. On success the address becomes this key's account's, and THIS key, and only this key, is lifted to `verified` on the free tier, which also unlocks offline downloads.

Only the key that asked for the code can redeem it. An address that already has ANY identity row is NEVER attached, whether or not anybody ever verified it, and nothing moves between identities: the answer is 409 email-in-use. The app should then sign in with that address through POST /v1/keys, which the owner's own mailbox verifies; that is a new key on the address's identity, so the email-less key's own state (its usage, styles and jobs) does not come with it. A wrong code counts against [identity::MAX_EMAIL_CODE_ATTEMPTS] (then the code is void), and attempts are capped per key and per IP per day like every other verification budget.

post/v1/keys/self/email/verify

Request

  • Base URL: https://api.mapmap.ai
  • URL: https://api.mapmap.ai/v1/keys/self/email/verify
  • Auth: one of:
    • HTTP bearer
    • API key in query parameter api_key

Request body

codestring required

The code from the mail.

Response

Address attached; this key is now verified on the free tier

emailstring required

The address now on the account.

monthly_quotainteger required

Requests allowed per calendar month from now on.

statestring required

Always verified.

Changes

No recorded changes to this operation across all 1 revision of this API.