Validează un CNP

Corpul cererii

Se trimite ca JSON, în corpul cererii (Content-Type: application/json) — nu în şirul de interogare.

{
    "cnp": "1800101410013"
}

{
    "cnp": "2990230412345"
}

{
    "cnp": "5041225410010"
}

Parametri de interogare

Cum se comportă

• Corpul are un singur câmp, cnp (șir, obligatoriu, cel mult 20 de caractere). Câmpurile din corp nu apar în tabelul de parametri, de aceea sunt descrise aici.
• De ce POST. Într-un GET, CNP-ul ar ajunge în logurile de acces ale serverului, în istoricul browserului și în antetul Referer al paginii următoare — trei locuri din care nu-l mai poți scoate. Ruta echivalentă pe GET răspunde 405 și trimite aici.
• Zero retenție. CNP-ul nu se scrie nicăieri: nici în bază, nici în loguri, nici într-o cheie de cache. Răspunsul nici nu repetă valoarea primită — valoare e mereu (ascuns), fiindcă apelantul o are deja, iar noi n-avem motiv s-o punem într-un corp care poate ajunge în logurile lui. Nici mesajele de eroare nu o repetă.
• Componentele sunt DERIVATE din codul trimis, nu căutate undeva: data nașterii, sexul și județul sunt literalmente scrise în CNP. Nu confirmă că persoana există.
• Nu există endpoint de generare de CNP-uri valide, nici „pentru testare". Un generator ar fi util mai ales cuiva care vrea să treacă de o validare, nu cuiva care vrea să valideze.
• Codurile de județ din CNP nu sunt nici SIRUTA, nici indicativele auto: e ordinea alfabetică a județelor de la 1978. Călărași și Giurgiu, înființate în 1981, au primit 51 și 52. Codul 47 e Sectorul Agricol Ilfov, care a existat între 1981 și 1997 și apare în CNP-urile emise atunci.
• La prima cifră 7 sau 8 (rezidenți străini) și 9 (fără cetățenie română), secolul nu e determinat de cod, deci data nașterii nu se poate deduce — lipsește din componente, ceea ce e corect, nu o scăpare.

La ce folosește

• Prinzi o greșeală de tastare la completarea unui formular, înainte de a trimite datele mai departe.
• Verifici coerența unui dosar: data nașterii declarată trebuie să se potrivească cu cea din CNP.
• Afli vârsta unei persoane din codul pe care îl ai deja, fără să întrebi o bază de date.

Structura răspunsului

Toate câmpurile de mai jos sunt în data.

Exemple de răspuns

{
    "data": {
        "tip": "cnp",
        "valoare": "(ascuns)",
        "valid": true,
        "componente": {
            "data_nasterii": "1980-01-01",
            "varsta": 46,
            "sex": "masculin",
            "judet_nastere": "București — Sectorul 1",
            "cod_judet": "41",
            "rezident_strain": false,
            "fara_cetatenie_romana": false
        },
        "observatie": "Componentele sunt DERIVATE din CNP-ul trimis — nu vin dintr-o bază de date și nu confirmă că persoana există. CNP-ul nu se stochează și nu se loghează nicăieri."
    }
}

{
    "data": {
        "tip": "cnp",
        "valoare": "(ascuns)",
        "valid": false,
        "motive": [
            "data nașterii 1999-02-30 nu există",
            "cifra de control nu se potrivește"
        ]
    }
}

{
    "data": {
        "tip": "cnp",
        "valoare": "(ascuns)",
        "valid": false,
        "motive": [
            "cifra de control nu se potrivește"
        ]
    }
}

Coduri de eroare

Toate erorile au aceeași formă. eroare.cod e stabil și e cel după care trebuie să ramifici în cod — nu după textul din mesaj, care se poate schimba.

{
    "eroare": {
        "cod": "validare",
        "mesaj": "Câmpul cnp lipsește sau e prea lung. Mesajul NU repetă valoarea primită."
    }
}