e-Devlet Kapısı 数据 API：KPS 身份与服务目录

T.C. Cumhurbaşkanlığı Siber Güvenlik Başkanlığı · 身份

e-Devlet Kapısı 是土耳其国家电子政务门户的官方 Android 应用，由 T.C. Cumhurbaşkanlığı Siber Güvenlik Başkanlığı 发布。它将政务服务搜索、办事事项收藏、“我的城市”机构列表、个人信息以及条码或二维码文档核验整合到手机端，部分办事事项通过内嵌的服务或支付网页打开。登录方式包括 e-Devlet 密码，以及结合 PIN 码和短信确认的 TCKK 身份证 NFC 验证，同时支持双因素登录的推送审批。土耳其境内及海外的土耳其公民，包括居住在德国的公民，可通过手机使用这些公共服务。

KPS 身份记录将 kimlikNo、adSoyad 与 acikAdres 中的登记地址、kpsSonGuncellemeTarihi 中的登记信息更新日期，以及 epostaVerified、cepTelVerified 等验证标记关联起来。在账户持有人授权的前提下，入职办理团队可以用这些字段匹配身份并预填表单。身份证验证记录还包含 token、challenge 和 smsRequired；账户设置则通过 ikiAsamaOtpAcikMi 表示双因素认证状态。

服务目录将 serviceName、serviceCode 与 institutionName 配对，搜索结果则使用 hizmetAdi 和 hizmetKodu。市政门户可按 cityCode 归集机构，展示 serviceCount 中的可用服务数量，再关联对应办事事项。文档核验流程可使用返回的 barkodluBelge HTML。推送审批将 did、tid 与 approvalType、resultCode 和服务器时间 time 关联。openData Studio 将这些目录与验证数据结构转化为可调用的开放数据，用于公共服务集成；账户专属记录仍须获得用户授权。

应用截图

API 端点一览

以下端点与请求/响应示例均依据应用界面推导重构，为示意说明，并非实际抓包。

政务服务目录

POST /v1/services/list opendata

加载服务目录卡片，包含 serviceName、serviceCode、institutionName 以及打开所选办事事项的链接。

认证方式：登录阶段提交表单，不携带会话 Cookie。login 标记表示会话状态。

return
login
data
baseUrl
content
conceptServices
serviceDomainURLs
resultCode
resultMessage
resultText
configPath
explanation
question
iconName
institutionCode
institutionName
link
serviceCode
serviceName
serviceDomainType

POST /v1/services/list HTTP/1.1
Content-Type: application/x-www-form-urlencoded

get=get&appVersion=<app-version>&operatingSystem=Android&language=tr&mode=demo

{
  "return": true,
  "login": 1,
  "data": {
    "baseUrl": "<service-root>",
    "content": [
      {
        "configPath": "<service-reference>",
        "explanation": "Example government procedure",
        "question": "",
        "iconName": "<service-icon>",
        "institutionCode": 101,
        "institutionName": "Example public institution",
        "link": "<service-link>",
        "serviceCode": 1001,
        "serviceName": "Example service",
        "serviceDomainType": 1
      }
    ],
    "conceptServices": [],
    "serviceDomainURLs": [],
    "resultCode": 0,
    "resultMessage": "OK",
    "resultText": "OK"
  }
}

政务服务搜索

POST /v1/services/search opendata

按文本搜索政务服务目录，返回办事事项名称、服务与机构代码，以及移动端服务链接引用。

认证方式：登录阶段提交表单，不携带会话 Cookie。login 标记表示会话状态。

return
login
data
baseUrl
serviceDomainURLs
content
hizmetAdi
hizmetKodu
kurumAdi
kurumKodu
kurumTipi
mobilHizmetKlasoru
mobilHizmetURL
iconName
url
serviceDomainType

POST /v1/services/search HTTP/1.1
Content-Type: application/x-www-form-urlencoded

isMobile=true&aranan=example&appVersion=<app-version>&operatingSystem=Android&language=tr&mode=demo

{
  "return": true,
  "login": 1,
  "data": {
    "baseUrl": "<service-root>",
    "serviceDomainURLs": [],
    "content": [
      {
        "hizmetAdi": "Example civil-registry service",
        "hizmetKodu": "1002",
        "kurumAdi": "Example registry institution",
        "kurumKodu": "102",
        "kurumTipi": "merkezi",
        "mobilHizmetKlasoru": "<service-folder>",
        "mobilHizmetURL": "<service-link>",
        "iconName": "<service-icon>",
        "url": "<service-link>",
        "serviceDomainType": 1
      }
    ]
  }
}

按城市查询机构（我的城市）

POST /v1/agencies/by-city opendata

按 cityCode 列出市政单位和机构，提供 institutionName 及可用服务数量，用于“我的城市”目录。

认证方式：登录阶段提交表单，不携带会话 Cookie。login 标记表示会话状态。

return
login
data
resultCode
content
kod
baseUrl
institutionCode
institutionName
serviceCount
totalCount
sectionCode
cityCode
categoryCode
iconName

POST /v1/agencies/by-city HTTP/1.1
Content-Type: application/x-www-form-urlencoded

get=get&categoryCode=2&cityCode=34&appVersion=<app-version>&operatingSystem=Android&language=tr&mode=demo

{
  "return": true,
  "login": 1,
  "data": {
    "resultCode": 0,
    "content": [
      {
        "institutionCode": 3401,
        "institutionName": "Example municipality",
        "serviceCount": 12,
        "totalCount": 12,
        "sectionCode": 2,
        "cityCode": 34,
        "categoryCode": 2,
        "iconName": "<municipality-icon>"
      }
    ],
    "kod": 0,
    "baseUrl": "<service-root>"
  }
}

添加或取消服务收藏

POST /v1/services/favorites/update opendata

使用 favori 和 hizmetKodu 在首页收藏列表中添加或移除服务，并返回更新后的服务卡片。

认证方式：登录阶段提交表单，不携带会话 Cookie。login 标记表示会话状态。

return
login
data
baseUrl
content
resultCode
resultMessage
resultText
configPath
explanation
iconName
institutionCode
institutionName
link
serviceCode
serviceName
serviceDomainType
favori
hizmetKodu

POST /v1/services/favorites/update HTTP/1.1
Content-Type: application/x-www-form-urlencoded

favori=add&hizmetKodu=1001&appVersion=<app-version>&operatingSystem=Android&language=tr&mode=demo

{
  "return": true,
  "login": 1,
  "data": {
    "baseUrl": "<service-root>",
    "content": [
      {
        "configPath": "<service-reference>",
        "explanation": "Example government procedure",
        "iconName": "<service-icon>",
        "institutionCode": 101,
        "institutionName": "Example public institution",
        "link": "<service-link>",
        "serviceCode": 1001,
        "serviceName": "Example service",
        "serviceDomainType": 1
      }
    ],
    "resultCode": 0,
    "resultMessage": "OK",
    "resultText": "OK"
  }
}

公民 KPS 个人资料

POST /v1/account/profile/read osint

返回已登录用户的 KPS 身份、登记地址、手机及邮箱验证标记，以及账户双因素认证状态，供“个人信息”页面使用。

认证方式：需要已认证的会话 Cookie（w3a）和已保存的 User-Agent。login 值为 0 时表示需要登录。

return
login
data
kullaniciBilgisi
kimlikBilgisi
adresBilgisi
kisiselBilgiler
kimlikNo
ad
soyad
adSoyad
cinsiyet
dogumTarih
babaAd
anaAd
dogumYer
medeniHal
adresNo
kpsSonGuncellemeTarihi
acikAdres
ceptelUlkeKodu
ceptel
eposta
epostaVerified
cepTelVerified
yuzyuzeTelVerfied
twoFactorLogin
twoFactorUser
canShowBanner
ikiAsamaOtpAcikMi

POST /v1/account/profile/read HTTP/1.1
Cookie: w3a=<session-cookie>
User-Agent: <stored-user-agent>
Content-Type: application/x-www-form-urlencoded

appVersion=<app-version>&operatingSystem=Android&language=tr&mode=demo

{
  "return": true,
  "login": 1,
  "data": {
    "kullaniciBilgisi": {
      "kimlikBilgisi": {
        "kimlikNo": "<identity-number>",
        "ad": "<given-name>",
        "soyad": "<family-name>",
        "adSoyad": "<full-name>",
        "cinsiyet": "<sex-code>",
        "dogumTarih": "<birth-date>",
        "babaAd": "<father-name>",
        "anaAd": "<mother-name>",
        "dogumYer": "<birthplace>",
        "medeniHal": "<marital-status>",
        "adresNo": "<address-number>",
        "kpsSonGuncellemeTarihi": "<updated-date>"
      },
      "adresBilgisi": {
        "acikAdres": "<registered-address>",
        "kpsSonGuncellemeTarihi": "<updated-date>"
      },
      "kisiselBilgiler": {
        "ceptelUlkeKodu": "90",
        "ceptel": "<masked-phone>",
        "eposta": "<email-address>",
        "epostaVerified": "E",
        "cepTelVerified": "E",
        "yuzyuzeTelVerfied": "H"
      }
    },
    "twoFactorLogin": true,
    "twoFactorUser": 1,
    "canShowBanner": 1,
    "ikiAsamaOtpAcikMi": 1
  }
}

NFC TCKK 令牌与质询

POST /v1/identity/card/challenge osint

启动 TCKK 芯片登录，返回 NFC 读卡步骤所需的 token 和 challenge。

认证方式：建立会话前的登录表单使用 uuid、authCode 和身份证 PIN 码。此步骤无需会话 Cookie。

return
login
data
uuid
authCode
pin
token
challenge
sonucKodu
sonucAciklamasi

POST /v1/identity/card/challenge HTTP/1.1
Content-Type: application/x-www-form-urlencoded

uuid=<device-uuid>&authCode=<authorization-code>&pin=<card-pin>&operatingSystem=Android&appVersion=<app-version>&language=tr&mode=demo

{
  "return": true,
  "login": 0,
  "data": {
    "token": "<card-token>",
    "challenge": "<card-challenge>",
    "sonucKodu": "0",
    "sonucAciklamasi": "OK"
  }
}

NFC TCKK 身份证验证

POST /v1/identity/card/verify osint

提交 TCKK 芯片数据组和 signedData，随后返回是否需要短信确认，以及接收短信的脱敏手机号。

认证方式：建立会话前的登录表单使用身份证质询步骤中的 token、uuid 及身份证验证证明，不携带会话 Cookie。

return
login
data
seriNo
token
uuid
file1
file2
file3
signedData
sonucKodu
sonucAciklamasi
smsRequired
cepTel
ulkeKodu
isSMSSent
smsDuration

POST /v1/identity/card/verify HTTP/1.1
Content-Type: application/x-www-form-urlencoded

seriNo=<card-serial>&token=<card-token>&uuid=<device-uuid>&file1=<chip-group-1>&file2=<chip-group-2>&file3=<chip-group-3>&signedData=<signed-card-proof>&operatingSystem=Android&appVersion=<app-version>&language=tr&mode=demo

{
  "return": true,
  "login": 0,
  "data": {
    "sonucKodu": "0",
    "sonucAciklamasi": "OK",
    "smsRequired": true,
    "cepTel": "<masked-phone>",
    "ulkeKodu": "90",
    "isSMSSent": true,
    "smsDuration": 120
  }
}

NFC TCKK 短信确认

POST /v1/identity/card/confirm osint

使用 NFC token 校验短信验证码，完成基于芯片的登录。

认证方式：建立会话前的登录表单使用之前的身份证 token、uuid 和短信确认码。

return
login
data
messageArr
uuid
token
smsCode

POST /v1/identity/card/confirm HTTP/1.1
Content-Type: application/x-www-form-urlencoded

uuid=<device-uuid>&token=<card-token>&smsCode=<sms-code>&operatingSystem=Android&appVersion=<app-version>&language=tr&mode=demo

{
  "return": true,
  "login": 1,
  "data": {},
  "messageArr": [
    "Example confirmation successful"
  ]
}

条码或二维码文档核验
POST /v1/documents/verify opendata
核验已签发文档的条码或二维码，返回 barkodluBelge HTML；流程也可请求关联的核验字段。
认证方式：需要已认证的会话 Cookie（w3a）和已保存的 User-Agent。login 值为 0 时表示需要登录。查询核验字段还接收 field 和 sorgulananBarkod。
- return
- login
- data
- messageArr
- barkodluBelge
- qr
- os
- field
- sorgulananBarkod
```
POST /v1/documents/verify HTTP/1.1
Cookie: w3a=<session-cookie>
Content-Type: application/x-www-form-urlencoded

qr=<document-qr>&os=Android&appVersion=<app-version>&language=tr&mode=demo
```
```
{
  "return": true,
  "login": 1,
  "data": {
    "barkodluBelge": "<html><body>Illustrative document verification result</body></html>"
  },
  "messageArr": []
}
```
推送 OTP 审批
POST /v1/access/approvals/submit osint
使用设备标识、交易标识、otp 和 approvalType 确认或拒绝登录推送审批，返回 resultCode 和服务器时间。
认证方式：与设备关联的 OTP 表单使用 did、tid、t、otp 及审批选项，不携带会话 Cookie。
- did
- tid
- t
- otp
- op
- approvalType
- operatingSystem
- appVersion
- language
- mode
- resultCode
- time
```
POST /v1/access/approvals/submit HTTP/1.1
Content-Type: application/x-www-form-urlencoded

did=<device-id>&tid=<transaction-id>&t=<push-token>&otp=<one-time-code>&op=approve&approvalType=1&operatingSystem=Android&appVersion=<app-version>&language=tr&mode=demo
```
```
{
  "resultCode": "0",
  "time": "2026-10-27T12:00:00Z"
}
```
退出会话
POST /v1/account/session/end osint
结束当前已登录会话，返回表示退出结果的 login 和 return 标记。
认证方式：需要已认证的会话 Cookie（w3a）和已保存的 User-Agent。login 值为 0 时表示需要登录。
- login
- return
- appVersion
- operatingSystem
- language
- mode
```
POST /v1/account/session/end HTTP/1.1
Cookie: w3a=<session-cookie>
Content-Type: application/x-www-form-urlencoded

appVersion=<app-version>&operatingSystem=Android&language=tr&mode=demo
```
```
{
  "login": 0,
  "return": true
}
```

数据类别

身份信息
政务服务
文档核验
双因素认证

数据使用场景与案例

基于 KPS 身份信息的员工入职
雇主从已登录的个人资料中提取 kimlikNo、adSoyad、dogumTarih 和 acikAdres，用于预填合同，并关联 TCKK 芯片身份验证记录中的 token、challenge 和 smsRequired，避免重新录入人口登记摘录（nüfus）的内容。
市政服务目录
城市门户同步“我的城市”中的 institutionName、cityCode 和 serviceCount，再关联搜索结果里的 hizmetAdi 与 hizmetKodu，让居民直接进入对应办事事项，无需浏览整个目录。
已签发文档的条码核验
登记人员提交扫描得到的二维码并展示 barkodluBelge，确认人口登记证明或学历证明的打印件是否仍然有效；所用的 field 与 sorgulananBarkod 列表与应用内扫描器展示的内容一致。
服务台推送 OTP 审批
服务台使用 giris 审批调用中的 did、tid、otp 和 approvalType，结合个人资料中的 ikiAsamaOtpAcikMi，核对哪些设备完成了双因素登录。

常见问题

个人资料中包含哪些身份字段？

已登录用户的个人资料将登记身份信息归入 kullaniciBilgisi.kimlikBilgisi，包括 kimlikNo、ad、soyad、adSoyad、cinsiyet、dogumTarih、babaAd、anaAd、dogumYer、medeniHal、adresNo 和 kpsSonGuncellemeTarihi。地址及联系方式部分包含 acikAdres、ceptel、eposta 及其验证标记。个人资料、文档核验和退出登录使用会话 Cookie 及已保存的 User-Agent。这些账户专属记录需要账户持有人授权；示例使用占位值，不包含个人真实信息。

TCKK NFC 登录与推送 OTP 审批有何不同？

NFC 登录先使用 uuid、authCode 和身份证 PIN 码获取 token 与 challenge。身份证验证阶段提交 seriNo、芯片文件 file1 至 file3 以及 signedData。若 smsRequired 为 true，则使用 smsCode 确认已有的 token 和 uuid，完成基于芯片的登录。目录请求和建立会话前的 NFC 阶段遵循登录流程，不携带会话 Cookie。推送审批是独立的设备关联流程，使用 did、tid、otp 和 approvalType，并在响应中返回 resultCode 与 time。响应中如包含 login 标记，它表示会话状态；值为 0 表示当前没有有效的已登录会话，不一定意味着建立会话前的 NFC 步骤失败。

哪些字段支持可搜索的市政服务目录？

目录条目将 serviceName、serviceCode 与 institutionName 及服务链接配对。文本搜索结果提供 hizmetAdi、hizmetKodu、kurumAdi 和 kurumKodu。“我的城市”记录还包含 cityCode、categoryCode 和 serviceCount，便于门户按城市归集机构，并关联对应办事事项。

文档核验会返回什么？这些示例是官方服务吗？

文档核验流程接收 qr，并通过 barkodluBelge 返回文档 HTML，同时返回状态和消息字段。它也可使用 field 和 sorgulananBarkod 请求核验字段详情。这里展示的是结果示例，并非真实公民文档。本页所有仅含路径的 API 模型和样例值都是集成示例，而非官方生产服务地址。它们展示目录、身份与验证数据结构，不提供生产地址或访问凭据，也不授予访问任何人个人记录或审批验证码的权限。

与 e-Devlet Kapısı 相似的应用

e-Nabız — e-Nabız 是土耳其卫生部的个人健康应用，公民在 enabiz.gov.tr 通过 e-Devlet 开通后，本人及经授权的亲属或医生可查看诊断、检查、影像、用药、疫苗和过敏等记录。
GİB — GİB 是土耳其税务总局（Gelir İdaresi Başkanlığı）的手机应用，用于查看并缴纳该局征收的税、费和罚款，以及查阅登记、车辆和电子归档发票等信息。
Cimer Mobil — Cimer Mobil 是土耳其总统府传播局下属总统传播中心（CİMER）的应用，供公民向公共机构提交并跟踪投诉、申请、建议和信息公开请求；CİMER 也接受通过 e-Devlet 提交的申请。
mygov — mygov 是阿塞拜疆创新与数字发展署的应用，用于办理政务服务并联系主管部门；turkiye.gov.tr 将 my.gov.az 门户列为姊妹电子政务入口。
Absher — Absher 是沙特内政部的电子政务应用和门户，2010 年上线，覆盖证件更新、预约、朝觐许可、求职和报案等服务。
Singpass — Singpass 是新加坡的国家数字身份，用于登录政府和商业服务、当面核验身份、电子签名，以及查看官方个人资料。
Pak Identity — Pak Identity 是巴基斯坦 NADRA 的应用，供公民在线办理国民身份证（CNIC）和海外身份证（NICOP）的申领、变更、更新和补办，并在应用内采集照片、指纹、签名及完成缴费。
DigiLocker — DigiLocker 是印度电子和信息技术部的电子证照夹，已绑定 Aadhaar 的用户可存储和分享执照、车辆记录、证明和成绩单，并对文件进行电子签名。

需要集成这个 App 的数据 API？

我们可为任意指定 App 交付定制集成——源码交付 USD 500 起，或托管 API 按调用计费。告诉我们您需要的数据即可。

每个项目均签 NDA 与 SOW
3–7 天交付
验收通过后才付款
仅在授权范围内作业

获取报价

e-Devlet Kapısı 数据 API：KPS 身份与服务目录

应用截图

API 端点一览

政务服务目录

政务服务搜索

按城市查询机构（我的城市）

添加或取消服务收藏

公民 KPS 个人资料

NFC TCKK 令牌与质询

NFC TCKK 身份证验证

NFC TCKK 短信确认

条码或二维码文档核验

推送 OTP 审批

退出会话

数据类别

数据使用场景与案例

基于 KPS 身份信息的员工入职

市政服务目录

已签发文档的条码核验

服务台推送 OTP 审批

常见问题

与 e-Devlet Kapısı 相似的应用

更多身份类应用

Duo Mobile

Налоги ФЛ

相关主题

需要集成这个 App 的数据 API？

e-Devlet Kapısı 数据 API：KPS 身份与服务目录

应用截图

API 端点一览

政务服务目录

政务服务搜索

按城市查询机构（我的城市）

添加或取消服务收藏

公民 KPS 个人资料

NFC TCKK 令牌与质询

NFC TCKK 身份证验证

NFC TCKK 短信确认

条码或二维码文档核验

推送 OTP 审批

退出会话

数据类别

数据使用场景与案例

基于 KPS 身份信息的员工入职

市政服务目录

已签发文档的条码核验

服务台推送 OTP 审批

常见问题

相关应用

与 e-Devlet Kapısı 相似的应用

更多身份类应用

Duo Mobile

Налоги ФЛ

相关主题

需要集成这个 App 的数据 API？