承接各类司法、汽车、个人、企业、等政务类数据接口的开发和定制，一手源头渠道，全网最低价。咨询微信：Ajazzo
全国婚姻状态查询 API/SDK
计费
￥ 0.00元/次
本接口来源合法，由民政总局官方提供API/SDK，已为数十家企业提供接入服务，接入商可基于查询者姓名 和 身份证号码 实时查询个人婚姻状态、以服务婚恋、交友、信审、电商、相亲、网恋、婚姻自查、招聘、金融等行业小程序/APP以满足企业实名认证需求场景。
接口测试
开户咨询
立即扫码咨询
基本信息
访问本HTTPS接口的入参格式，需要先申请获得“全国婚姻状态查询”marriage接口的秘钥。 其中 name（姓名）、card_no(身份证号码) 和 secret_key（秘钥）为必传的字段： 其中 secret_key 秘钥，需咨询技术开户
使用方法参考：参考以下
接口地址：https://hunyinapi.com/api/pincc/marriage (获取新接口)
请求方式：POST/ GET（代码示例）
返回格式：JSON
请求参数
Header：secret_key（ 秘钥ID，咨询微信获取 ）
| 参数名 | 类型 | 必选 | 值范围 | 描述 |
|---|---|---|---|---|
| name | string | 是 | 08位 | 姓名 |
| card_no | string | 是 | 18位 | 身份证号码 |
请求结果
{
"data": [
{
"maritalStatus": "2"
}
],
"msg": "成功",
"code": 0
}
// 婚姻状态 0:尚未登记；1:已结婚；2:已离异；3、冷静期
| 婚姻类型 | 婚姻状态 | 描述 |
|---|---|---|
| 未登记 | 0 | 未在民政局登记 或 单身状态 |
| 已结婚 | 1 | 已经结婚了 |
| 已离异 | 2 | 已经离婚了 |
| 冷静期 | 3 | 30天冷静期内 |
错误代码
{
"msg": "秘钥有误",
"code": 1001
}
| 错误类型 | 错误code | 状态码 | 值范围 | 错误描述 |
|---|---|---|---|---|
| 秘钥有误 | 1001 | 200 | - | 是否输入正确 、有空格 或 正常开户 |
| 积分不足 | 1002 | 200 | - | 积分不足，可充值解决。 |
| 尚未认证 | 1003 | 200 | - | 若企业未认证，需进行认证后操作。 |
DEMO示例
POST /api/pincc/marriage?card_no=身份证号码&name=姓名 HTTP/1.1
Host: 47.108.164.167:8787
secret_key:
