스페인 DNI, NIE, NIF 검증 API API 레퍼런스
스페인 DNI, NIE, NIF/CIF 번호를 검증합니다. 이 레퍼런스를 사용해 작업을 선택하고 문서화된 응답 계약을 통합하세요.
작업
GET /v1/national-id/validate
GET
/v1/national-id/validate
크레딧: 1
쿼리 매개변수
| 매개변수 | 유형 | 필수 |
|---|---|---|
| id | string | 필수 |
| country |
string
허용된 값
ES
기본값
ES
|
선택 사항 |
응답 필드
| 필드 | 유형 |
|---|---|
country |
string |
input |
string |
normalized |
string | null |
valid |
boolean |
type |
string | null |
entity_type |
string | null |
holder |
string | null |
checks |
object |
checks.format |
boolean |
checks.control |
boolean | null |
expected_control |
string | null |
errors[] |
string[] |
예제 요청
curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/national-id/validate?id=example-id&country=ES"const response = await fetch("https://domscan.net/v1/national-id/validate?id=example-id&country=ES", {
headers: { "X-API-Key": process.env.DOMSCAN_API_KEY },
});
const data = await response.json();
console.log(data);import os
import requests
response = requests.get(
"https://domscan.net/v1/national-id/validate?id=example-id&country=ES",
headers={"X-API-Key": os.environ["DOMSCAN_API_KEY"]},
)
print(response.json())package main
import (
"fmt"
"io"
"net/http"
"os"
)
func main() {
req, err := http.NewRequest(http.MethodGet, "https://domscan.net/v1/national-id/validate?id=example-id&country=ES", nil)
if err != nil {
panic(err)
}
req.Header.Set("X-API-Key", os.Getenv("DOMSCAN_API_KEY"))
resp, err := http.DefaultClient.Do(req)
if err != nil {
panic(err)
}
defer resp.Body.Close()
data, err := io.ReadAll(resp.Body)
if err != nil {
panic(err)
}
fmt.Println(resp.Status, string(data))
}require "json"
require "net/http"
uri = URI("https://domscan.net/v1/national-id/validate?id=example-id&country=ES")
request = Net::HTTP::Get.new(uri)
request["X-API-Key"] = ENV.fetch("DOMSCAN_API_KEY")
response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
http.request(request)
end
puts JSON.pretty_generate(JSON.parse(response.body))예제 응답
{
"country": "ES",
"input": "B-58378431",
"normalized": "B58378431",
"valid": true,
"type": "cif",
"entity_type": "sociedad_responsabilidad_limitada",
"holder": null,
"checks": {
"format": true,
"control": true
},
"expected_control": null,
"errors": []
}
HTTP 상태 코드
200성공400잘못된 요청401인증되지 않음402결제 필요429요청 과다