> ## Documentation Index > Fetch the complete documentation index at: https://docs.didit.me/llms.txt > Use this file to discover all available pages before exploring further. # API Verifikasi Email: Dapatkan Kredensial API Didit > POST /programmatic/verify-email/ mengonfirmasi email dan memberi token akses, client_id, serta api_key Didit. Harga bayar per penggunaan. Perintah untuk Memverifikasi Email & Mendapatkan Kredensial Salin prompt ke papan klip \

\`Exchange the email verification code for usable Didit credentials — step 2 of programmatic onboarding.

Endpoint:
POST https://apx.didit.me/auth/v2/programmatic/verify-email/

Authentication:
None. The email + code pair is the credential.

Request body:
\- email (string, required) — Same email used in /programmatic/register/.
\- code (string, required) — 6-character alphanumeric code from the registration email (e.g. "A3K9F2"). Valid for 15 minutes.

curl example:
curl -X POST https://apx.didit.me/auth/v2/programmatic/verify-email/ \
-H "Content-Type: application/json" \
-d '{
"email": "you@yourdomain.com",
"code": "A3K9F2"
}'

Response (200 OK):
\{
"access_token": "eyJ...RS256 JWT",
"refresh_token": "eyJ...RS256 JWT",
"expires_in": 86400,
"organization": {
"uuid": "a1b2c3d4-5678-...",
"name": "you"
},
"application": {
"uuid": "b2c3d4e5-6789-...",
"name": "you",
"client_id": "S9LIYGSoWNuGMLHsvEt9dQ",
"api_key": "sk_live_example_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
"data_location": "eu"
}
}

What happens server-side:
1\. The pending account is marked email-verified.
2\. A default organization is created (named after the local part of the email, e.g. "you" from "you@yourdomain.com").
3\. A default application is created inside the organization with a fresh client_id and api_key, in the European Union (data_location "eu"). Its location can be chosen once with PATCH /organizations/me/{org_id}/applications/{app_id}/ before the application is used; see /auth-api/update-application.
4\. JWTs are issued (RS256, default 24h / 86400 seconds lifetime).

How to use the response:
\- application.api_key → set as the x-api-key header on EVERY call to https://verification.didit.me/v3/... (sessions, workflows, questionnaires, billing, etc.). PERSIST IT SECURELY. You can read it again later with GET /organizations/me/{org_id}/applications/{app_id}/.
\- access_token → use as "Authorization: Bearer " against Account Management endpoints on https://apx.didit.me/auth/v2 (e.g. to create more applications).
\- refresh_token → exchange for a new access_token after expiry.

Save the api_key, the organization.uuid (org_id), and the application.uuid (app_id) — you will need all three to manage applications later.

Failure modes (400 unless noted):
\- Field-level: { "email": ["Enter a valid email address."] } or { "code": ["Ensure this field has at least 6 characters."] }.
\- Wrong or expired code CURRENTLY returns a BARE ARRAY ["Invalid or expired verification code."] — known server-side inconsistency; treat as { "code": [...] } client-side.
\- Unknown email: { "detail": "User not found." }

Recovery if you lose the api_key later:
Call POST /programmatic/login/ with email + password to get a fresh access_token, then GET /organizations/me/{org_id}/applications/{app_id}/ to read the api_key back. See /auth-api/login and /auth-api/get-credentials.

For end-to-end Didit integration, paste in the full prompt at /integration/integration-prompt.`

\
Tempel ke ## OpenAPI ````yaml id/openapi-auth.json POST /programmatic/verify-email/ openapi: 3.0.0 info: version: 1.0.0 title: Didit Auth API description: >- API pendaftaran dan autentikasi terprogram untuk pengembang dan agen AI. Daftar dalam 2 panggilan API -- tanpa perlu browser. Platform verifikasi identitas yang paling ramah agen. ## URL Dasar Semua endpoint dalam spesifikasi ini di-hosting di `https://apx.didit.me/auth/v2`. Ini adalah host yang berbeda dari API verifikasi (`https://verification.didit.me/v3`). Perhatikan perbedaannya: host autentikasi ini menerbitkan **token akses JWT** Anda dan memungkinkan Anda mencantumkan serta mengelola **organisasi** dan **aplikasi** Anda. Host verifikasi adalah tempat Anda memanggil sesi, alur kerja, AML, dll., yang diautentikasi dengan **`api_key`** yang dikembalikan oleh API ini. ## Cara kerja alur autentikasi 1. `POST /programmatic/register/` — kirimkan email + kata sandi. 2. Terima kode alfanumerik 6 karakter melalui email. 3. `POST /programmatic/verify-email/` — kirimkan kode tersebut. Anda akan mendapatkan kembali JWT `access_token`, `refresh_token`, sebuah organisasi, dan aplikasi default dengan `client_id` + `api_key`. 4. Simpan `api_key`. Gunakan sebagai `x-api-key` untuk setiap panggilan ke `https://verification.didit.me/v3/...`. 5. Dari mesin mana pun di masa mendatang, `POST /programmatic/login/` menukarkan email + kata sandi Anda dengan JWT baru, lalu panggil `GET /organizations/me/` dan endpoint aplikasi untuk memulihkan atau merotasi kredensial. JWT hanya diperlukan untuk endpoint **Manajemen Akun** dalam spesifikasi ini; lalu lintas API verifikasi menggunakan `api_key` yang berjangka panjang, bukan JWT. ## Konvensi - Semua body permintaan dan respons berupa JSON (`Content-Type: application/json`). - **Gunakan alamat email asli yang dapat menerima pesan saat menguji `POST /programmatic/register/`.** Endpoint ini mengirimkan kode verifikasi secara sinkron, sehingga alamat pada domain pengujian yang dicadangkan (`@example.com`, `@example.org`, `@*.test`, `@*.example`, `@*.invalid`) ditolak oleh pengiriman email dan permintaan mengembalikan `500`. Ganti placeholder `you@yourdomain.com` dalam contoh dengan kotak masuk yang benar-benar dapat Anda baca. - Error validasi mengembalikan HTTP `400` dengan salah satu dari dua format: `{"field": ["message", ...]}` untuk masalah tingkat kolom, atau `{"detail": "message"}` untuk error aturan bisnis. Sejumlah kecil validator (kekuatan kata sandi saat mendaftar, kedaluwarsa kode saat verifikasi email) saat ini merespons dengan array sederhana `["message"]` alih-alih bentuk dengan kunci kolom -- ini adalah inkonsistensi sisi server yang diketahui, sehingga kode klien harus menerima kedua bentuk tersebut. - Error autentikasi kembali sebagai `{"detail": "..."}` dengan HTTP `401` (bearer token tidak valid) atau `403` (bearer token tidak ada / hak istimewa tidak memadai). - Respons batas laju menyertakan kolom `wait` dengan durasi cooldown dalam detik. servers: - url: https://apx.didit.me/auth/v2 description: Server autentikasi produksi security: [] tags: - name: Programmatic Auth description: >- Siklus hidup akun dengan email dan kata sandi: daftar, verifikasi, masuk. Mengembalikan `access_token` JWT yang Anda gunakan untuk endpoint Manajemen Akun, ditambah (saat verifikasi) `client_id` dan `api_key` aplikasi pertama Anda. - name: Account Management description: >- Endpoint terautentikasi (JWT bearer) yang mencantumkan organisasi dan membuat, mengambil, atau memperbarui aplikasi. Gunakan endpoint ini untuk memulihkan atau merotasi `api_key` yang Anda gunakan untuk mengautentikasi panggilan API verifikasi. paths: /programmatic/verify-email/: post: tags: - Programmatic Auth summary: Verifikasi Email dan Terbitkan Kredensial description: >- Langkah 2 onboarding. Menukarkan kode 6 karakter dengan akun terverifikasi, org+app default, dan pasangan JWT. Simpan `api_key` yang dikembalikan. operationId: programmatic_verify_email requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/VerifyEmailRequest' examples: Default: summary: Kirim kode dari email pendaftaran value: email: you@yourdomain.com code: A3K9F2 responses: '200': description: >- Email terverifikasi. Respons berisi token untuk API autentikasi ini ditambah `client_id` dan `api_key` aplikasi yang baru. Simpan `api_key` dengan aman — ini adalah kredensial berumur panjang yang digunakan oleh setiap panggilan API verifikasi. content: application/json: schema: $ref: '#/components/schemas/VerifyEmailResponse' examples: Success: value: access_token: eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9... refresh_token: eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9... expires_in: 86400 organization: uuid: a1b2c3d4-5678-90ab-cdef-111111111111 name: developer application: uuid: b2c3d4e5-6789-01bc-defg-222222222222 name: developer client_id: S9LIYGSoWNuGMLHsvEt9dQ api_key: sk_live_example_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx data_location: eu '400': description: >- Kesalahan validasi. Envelope yang dituju adalah `{"field": ["..."]}` untuk masalah tingkat kolom dan `{"detail": "..."}` untuk kesalahan aturan bisnis (misalnya pengguna tidak ditemukan). Kesalahan kode salah atau kedaluwarsa saat ini merespons dengan array biasa `["Invalid or expired verification code."]` -- inkonsistensi sisi server yang sudah diketahui; perlakukan sebagai `{"code": ["..."]}` hingga diperbaiki. content: application/json: schema: $ref: '#/components/schemas/ValidationError' examples: MissingFields: summary: Isi kosong value: email: - This field is required. code: - This field is required. CodeTooShort: summary: Kode kurang dari 6 karakter value: code: - Ensure this field has at least 6 characters. InvalidEmail: summary: Email salah format value: email: - Enter a valid email address. InvalidCode: summary: Kode salah atau kedaluwarsa value: - Invalid or expired verification code. UserNotFound: summary: Tidak ada akun yang masih dalam proses untuk email tersebut value: detail: User not found. '429': description: >- Layanan sedang memeriksa kata sandi atau kode sebanyak mungkin secara bersamaan untuk sementara waktu. Dikirim dengan header `Retry-After: 5`; coba lagi setelah jumlah detik yang ditentukan. content: application/json: schema: $ref: '#/components/schemas/RateLimitError' examples: PasswordChecksBusy: summary: >- Terlalu banyak pemeriksaan kata sandi yang sedang berlangsung value: detail: >- Too many sign-in attempts are being processed right now. Please try again in a few seconds. security: - {} x-codeSamples: - lang: curl label: cURL source: >- curl -X POST https://apx.didit.me/auth/v2/programmatic/verify-email/ \ -H "Content-Type: application/json" \ -d '{ "email": "you@yourdomain.com", "code": "A3K9F2" }' - lang: python label: Python source: |- from didit import Didit # This call needs no API key. client = Didit() result = client.account.verify_email( email="you@yourdomain.com", code="A3K9F2", ) print(result) - lang: javascript label: Node.js source: |- import Didit from "@didit-protocol/sdk-node"; // This call needs no API key. const didit = new Didit(); const result = await didit.account.verifyEmail({ email: "you@yourdomain.com", code: "A3K9F2", }); console.log(result); - lang: go label: Go source: "ctx := context.Background()\n// This call needs no API key.\nclient := didit.NewClient()\n\nresult, err := client.Account.VerifyEmail(ctx, didit.VerifyEmailRequest{\n\tEmail: \"you@yourdomain.com\",\n\tCode: \"A3K9F2\",\n})\nif err != nil {\n\tlog.Fatal(err)\n}\nfmt.Printf(\"%+v\\n\", result)" - lang: java label: Java source: >- import me.didit.Didit; import me.didit.types.VerifyEmailRequest; // This call needs no API key. Didit client = new Didit(); var result = client.account().verifyEmail(VerifyEmailRequest.builder() .email("you@yourdomain.com") .code("A3K9F2") .build()); System.out.println(result); - lang: php label: PHP source: |- account->verifyEmail([ 'email' => 'you@yourdomain.com', 'code' => 'A3K9F2', ]); print_r($result->toArray()); - lang: ruby label: Ruby source: |- require "didit" # This call needs no API key. didit = Didit::Client.new result = didit.account.verify_email( email: "you@yourdomain.com", code: "A3K9F2" ) puts result.to_h - lang: csharp label: .NET source: >- using System; using System.Text.Json; using Didit; // This call needs no API key. using var client = new DiditClient(); var result = await client.Account.VerifyEmailAsync(new VerifyEmailRequest { Email = "you@yourdomain.com", Code = "A3K9F2", }); Console.WriteLine(JsonSerializer.Serialize(result)); components: schemas: VerifyEmailRequest: type: object required: - email - code properties: email: type: string format: email description: Email yang digunakan selama `POST /programmatic/register/`. example: you@yourdomain.com code: type: string minLength: 6 maxLength: 6 description: >- Kode alfanumerik 6 karakter dari email verifikasi. Kode kedaluwarsa 10 menit setelah kode terbaru dikirim. example: A3K9F2 VerifyEmailResponse: type: object properties: access_token: type: string description: >- JWT bertanda tangan RS256. Gunakan sebagai `Authorization: Bearer ` untuk endpoint Manajemen Akun di `apx.didit.me/auth/v2`. refresh_token: type: string description: Refresh token yang dipasangkan dengan access token. expires_in: type: integer description: Masa berlaku token akses dalam detik (default 86400). example: 86400 organization: $ref: '#/components/schemas/OrganizationSummary' application: $ref: '#/components/schemas/ApplicationCredentialsSummary' ValidationError: description: >- Isi kesalahan validasi. Envelope yang diharapkan adalah pemetaan `{field: ["message", ...]}` untuk kesalahan tingkat kolom atau envelope kunci tunggal `{detail: "..."}` untuk kesalahan aturan bisnis. Sejumlah kecil validator (kekuatan kata sandi saat mendaftar, validitas kode pada verifikasi email) saat ini merespons dengan array polos `["message"]` -- inkonsistensi sisi server yang sudah diketahui. Skema di bawah ini mempertahankan cabang array polos tersebut sehingga kode klien yang dihasilkan dari spesifikasi ini mendeserialisasi respons saat ini, namun kode klien baru harus memperlakukannya sebagai bentuk dengan kunci kolom yang relevan (`{password: [...]}` atau `{code: [...]}`) dan kontrak server akan disesuaikan ke bentuk tersebut. oneOf: - type: object additionalProperties: type: array items: type: string example: email: - Enter a valid email address. - type: object properties: detail: type: string example: detail: An account with this email already exists. - type: array items: type: string example: - Invalid or expired verification code. RateLimitError: type: object description: >- Respons batas laju atau penguncian progresif. `wait` adalah waktu tunggu dalam hitungan detik. properties: detail: type: string example: >- Too many login attempts from this IP address. Please wait before trying again. OrganizationSummary: type: object description: >- Bentuk organisasi minimal yang dikembalikan secara inline oleh `POST /programmatic/verify-email/`. properties: uuid: type: string format: uuid example: a1b2c3d4-5678-90ab-cdef-111111111111 name: type: string example: developer ApplicationCredentialsSummary: type: object description: >- Bentuk aplikasi minimal yang dikembalikan secara inline oleh `POST /programmatic/verify-email/`. Simpan `api_key` segera. properties: uuid: type: string format: uuid example: b2c3d4e5-6789-01bc-defg-222222222222 name: type: string example: developer client_id: type: string example: S9LIYGSoWNuGMLHsvEt9dQ api_key: type: string description: >- Gunakan ini sebagai `x-api-key` pada setiap panggilan API verifikasi. Kunci baru dimulai dengan `sk_live_` (aplikasi produksi) atau `sk_test_` (aplikasi sandbox), diikuti oleh 43 karakter yang aman untuk URL (huruf, digit, `-`, dan `_`). Kunci yang dibuat sebelum format ini tidak memiliki awalan dan tetap berfungsi tanpa perubahan. example: sk_live_example_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx data_location: $ref: '#/components/schemas/ApplicationDataLocation' ApplicationDataLocation: type: string enum: - eu - au - mx description: >- Tempat data verifikasi aplikasi disimpan dan diproses, dipilih saat aplikasi dibuat. `eu` adalah Uni Eropa (Irlandia), sebagai default. `au` (Australia, Sydney) dan `mx` (Meksiko) akan segera hadir: permintaan yang mencantumkannya akan menghasilkan respons 400 `This data location is not available yet.` Aplikasi Sandbox suatu organisasi selalu berada di Uni Eropa. example: eu ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.