> ## 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 > Didit을 통해 브라질 공식 데이터베이스(Polícia Federal)에서 연방 범죄 기록을 조회합니다. 건당 $0.20부터, 계약 및 최소 사용량 없음. 연방 경찰의 CPF 기준 범죄 경력 증명서를 요청하고, 기록 없음 상태로 발급되었는지 알려 주며, 증명서상의 성명과 생년월일을 제출된 값과 비교합니다. 증명서를 온라인으로 발급할 수 없는 경우 결과는 검토 대상이 됩니다. Didit은 이 서비스를 `POST /v3/database-validation/` endpoint로 제공하므로, 제출된 데이터를 공식 출처와 대조하고 정규화된 일치 결과를 받을 수 있습니다. ## 적용 범위 * **적용 범위:** \~ 100% * **국가:** 브라질 * **서비스 ID:** `bra_antecedentes_criminais_pf` * **데이터 도메인:** 형사 * **카테고리:** NationalCriminal ## 입력값 | 필드 | 필수 | 예시 | | - | -: | - | | `tax_number` | 예 | `12345678909` | | `first_name` | 예 | `John` | | `last_name` | 예 | `Doe` | | `date_of_birth` | 아니요 | `1990-01-01` | | `vendor_data` | 아니요 | `user-1234` | * **필수 입력값:** `tax_number`, `first_name`, `last_name` * **선택 입력값:** `date_of_birth`, `vendor_data` * **동의:** 필수 * **워크플로 사용 가능 여부:** 워크플로에서 사용 가능 * **적용 범위:** \~ 100% * **가격:** 성공한 쿼리당 \$0.20 ## 본문 파라미터 **issuing\_state** `string` *required* (default: BRA) 이 데이터베이스 서비스의 ISO 3166-1 alpha-3 국가 코드입니다. 예시: `BRA` **services** `string` *required* (default: bra\_antecedentes\_criminais\_pf) 이 서비스 ID를 포함하는 배열입니다. 서비스를 고정하면 요청이 이 정확한 데이터베이스 범위 안에서만 처리됩니다. 예시: `bra_antecedentes_criminais_pf` **consent** `boolean` *required* (default: true) 이 서비스에 대한 최종 사용자의 명시적 동의입니다. 예시: `true` **tax\_number** `string` *required* (default: 12345678909) 납세자 번호 또는 세무 식별 번호입니다. 예시: `12345678909` **first\_name** `string` *required* (default: John) 검증할 이름입니다. 예시: `John` **last\_name** `string` *required* (default: Doe) 검증할 성입니다. 예시: `Doe` **date\_of\_birth** `string` (default: 1990-01-01) `YYYY-MM-DD` 형식의 생년월일입니다. 예시: `1990-01-01` **vendor\_data** `string` (default: user-1234) 내부 사용자 ID 등 해당 개인을 가리키는 안정적인 사용자 참조값입니다. Didit은 이 값을 사용해 단독 검사를 같은 최종 사용자와 연결하고 중복 탐지 노이즈를 줄입니다. 예시: `user-1234` ## 입력 규칙 및 검증 참고 사항 * 브라질 CPF(정확히 11자리 숫자) * `tax_number`에는 숫자만 포함되어야 합니다. 요청을 보내기 전에 공백, 하이픈, 구두점을 제거하십시오. * `tax_number`는 정확히 11자여야 합니다. * `tax_number`는 `\d{3}\.?\d{3}\.?\d{3}-?\d{2}`와 일치해야 합니다. ## 호출 방법 ```bash cURL theme={null} curl -X POST "https://verification.didit.me/v3/database-validation/" \ -H "x-api-key: YOUR_API_KEY" \ -F "issuing_state=BRA" \ -F "services=bra_antecedentes_criminais_pf" \ -F "vendor_data=user-1234" \ -F "consent=true" \ -F "tax_number=12345678909" \ -F "first_name=John" \ -F "last_name=Doe" \ -F "date_of_birth=1990-01-01" ``` ```python Python theme={null} from didit import Didit # Reads DIDIT_API_KEY. client = Didit() result = client.database_validation.validate( issuing_state="BRA", services=["bra_antecedentes_criminais_pf"], consent=True, first_name="John", last_name="Doe", date_of_birth="1990-01-01", tax_number="12345678909", vendor_data="user-1234", ) print(result) ``` ```javascript Node.js theme={null} import Didit from "@didit-protocol/sdk-node"; // Reads DIDIT_API_KEY. const didit = new Didit(); const result = await didit.databaseValidation.validate({ issuing_state: "BRA", services: ["bra_antecedentes_criminais_pf"], consent: true, first_name: "John", last_name: "Doe", date_of_birth: "1990-01-01", tax_number: "12345678909", vendor_data: "user-1234", }); console.log(result); ``` ```go Go theme={null} ctx := context.Background() // Reads DIDIT_API_KEY. client := didit.NewClient() result, err := client.DatabaseValidation.Validate(ctx, didit.DatabaseValidationValidateParams{ IssuingState: "BRA", Services: didit.Some([]string{"bra_antecedentes_criminais_pf"}), Consent: didit.Bool(true), FirstName: didit.String("John"), LastName: didit.String("Doe"), DateOfBirth: didit.String("1990-01-01"), TaxNumber: didit.String("12345678909"), VendorData: didit.String("user-1234"), }) if err != nil { log.Fatal(err) } fmt.Printf("%+v\n", result) ``` ```java Java theme={null} import java.time.LocalDate; import java.util.List; import me.didit.Didit; import me.didit.types.DatabaseValidationValidateParams; // Reads DIDIT_API_KEY. Didit client = new Didit(); var result = client.databaseValidation().validate(DatabaseValidationValidateParams.builder() .issuingState("BRA") .services(List.of("bra_antecedentes_criminais_pf")) .consent(true) .firstName("John") .lastName("Doe") .dateOfBirth(LocalDate.parse("1990-01-01")) .taxNumber("12345678909") .vendorData("user-1234") .build()); System.out.println(result); ``` ```php PHP theme={null} databaseValidation->validate([ 'issuing_state' => 'BRA', 'services' => ['bra_antecedentes_criminais_pf'], 'consent' => true, 'first_name' => 'John', 'last_name' => 'Doe', 'date_of_birth' => '1990-01-01', 'tax_number' => '12345678909', 'vendor_data' => 'user-1234', ]); print_r($result->toArray()); ``` ```ruby Ruby theme={null} require "didit" # Reads DIDIT_API_KEY. didit = Didit::Client.new result = didit.database_validation.validate( issuing_state: "BRA", services: ["bra_antecedentes_criminais_pf"], consent: true, first_name: "John", last_name: "Doe", date_of_birth: "1990-01-01", tax_number: "12345678909", vendor_data: "user-1234" ) puts result.to_h ``` ```csharp .NET theme={null} using System; using System.Text.Json; using Didit; // Reads DIDIT_API_KEY. using var client = new DiditClient(); var result = await client.DatabaseValidation.ValidateAsync(new DatabaseValidationValidateParams { IssuingState = "BRA", Services = new string[] { "bra_antecedentes_criminais_pf" }, Consent = true, FirstName = "John", LastName = "Doe", DateOfBirth = "1990-01-01", TaxNumber = "12345678909", VendorData = "user-1234", }); Console.WriteLine(JsonSerializer.Serialize(result)); ``` 성공한 모든 호출은 HTTP `200`을 반환합니다. 실제로 무슨 일이 일어났는지는 **`outcome_code`** 필드로 확인할 수 있습니다. 예를 들어 실제 생체 불일치(`BIOMETRIC_NO_MATCH`)와 읽을 수 없었던 셀피(`BIOMETRIC_IMAGE_UNUSABLE`)를 구분합니다. 표시되는 `status`는 기본 기능 상태이며, 구성한 [부분 일치 / 불일치 작업](https://docs.didit.me/ko/core-technology/database-validation/database-validation-warnings.md)에 따라 재정의될 수 있습니다. **`MATCH`** 레지스트리에서 신원을 확인했으며, 검사한 모든 필드가 일치했습니다. ```json 200 OK — MATCH theme={null} { "request_id": "req_01H…", "status": "Approved", "issuing_state": "BRA", "match_type": "full_match", "validations": [ { "outcome_code": "MATCH", "service_id": "bra_antecedentes_criminais_pf", "service_name": "Brazil - Federal Criminal Record (Polícia Federal)", "source_data": { "certificate_number": "000000000000", "certificate_status": "NADA CONSTA", "certificate_valid_until": "2027-01-03", "criminal_record_found": false, "date_of_birth": "1990-01-01", "first_name": "JOHN", "full_name": "JOHN DOE", "identification_number": "12345678909", "last_name": "DOE" }, "validation": { "date_of_birth": "full_match", "full_name": "full_match", "identification_number": "full_match" } } ] } ``` **`PARTIAL_MATCH`** 식별 번호는 찾았지만 개인 정보 필드 하나 이상(보통 이름 또는 생년월일)이 완전히 일치하지 않았습니다. ```json 200 OK — PARTIAL_MATCH theme={null} { "request_id": "req_01H…", "status": "In Review", "issuing_state": "BRA", "match_type": "partial_match", "validations": [ { "outcome_code": "PARTIAL_MATCH", "service_id": "bra_antecedentes_criminais_pf", "service_name": "Brazil - Federal Criminal Record (Polícia Federal)", "source_data": { "certificate_number": "000000000000", "certificate_status": "NADA CONSTA", "certificate_valid_until": "2027-01-03", "criminal_record_found": false, "date_of_birth": "1990-01-01", "first_name": "JOHN", "full_name": "JOHN DOE", "identification_number": "12345678909", "last_name": "DOE" }, "validation": { "date_of_birth": "full_match", "full_name": "no_match", "identification_number": "full_match" } } ] } ``` **`NO_MATCH`** 레지스트리에서 제출된 데이터와 일치하는 결과가 없습니다. ```json 200 OK — NO_MATCH theme={null} { "request_id": "req_01H…", "status": "Declined", "issuing_state": "BRA", "match_type": "no_match", "validations": [ { "outcome_code": "NO_MATCH", "service_id": "bra_antecedentes_criminais_pf", "service_name": "Brazil - Federal Criminal Record (Polícia Federal)", "source_data": { "date_of_birth": "NO_MATCH", "full_name": "NO_MATCH", "identification_number": "NO_MATCH" }, "validation": { "date_of_birth": "no_match", "full_name": "no_match", "identification_number": "no_match" } } ] } ``` **`INCONCLUSIVE`** 연방 경찰이 증명서를 온라인으로 발급하지 않았습니다. 기록 또는 동명이인 문제를 직접 해결해야 할 때 이런 결과가 나옵니다. 어느 쪽으로도 결론을 내리지 않습니다. ```json 200 OK — INCONCLUSIVE theme={null} { "request_id": "req_01H…", "status": "In Review", "issuing_state": "BRA", "match_type": null, "validations": [ { "outcome_code": "INCONCLUSIVE", "service_id": "bra_antecedentes_criminais_pf", "service_name": "Brazil - Federal Criminal Record (Polícia Federal)", "source_data": { "certificate_status": "NOT_ISSUED", "identification_number": "12345678909" }, "validation": {} } ] } ``` ## 반환 데이터 `source_data`에 노출되는 정확한 필드는 레지스트리가 반환하는 내용에 따라 달라집니다. `bra_antecedentes_criminais_pf`의 생성된 예시는 현재 다음 정규화된 구조를 문서화하고 있습니다. * `certificate_number` * `certificate_status` * `certificate_valid_until` * `criminal_record_found` * `date_of_birth` * `first_name` * `full_name` * `identification_number` * `last_name` ## 요금 및 SLA 브라질 - 연방 범죄 경력(Polícia Federal) 조회는 Didit이 검증 출처로부터 확정적인 결과를 받은 경우에만 과금됩니다. * **호출당 가격:** \$0.20 USD * **과금:** 성공한 쿼리당 과금됩니다. 레지스트리에 연결할 수 없는 경우, 필수 필드가 누락된 경우, 또는 요청이 출처에 도달하기 전에 거부된 경우에는 과금되지 않습니다. * **지연 시간:** 일반적인 p95 \< 2 s * **가용성:** Didit 측 기준 분기당 99.9%이며, 연계된 원천 데이터 소스의 가용성은 국가와 데이터셋에 따라 다릅니다. ## 이어서 읽기 * [브라질 데이터베이스 검증 개요](https://docs.didit.me/api-reference/database-validation/brazil.md) * [데이터베이스 검증 개요](https://docs.didit.me/ko/core-technology/database-validation/overview.md) * [결과 코드](https://docs.didit.me/ko/core-technology/database-validation/database-validation-outcome-codes.md) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.