{"openapi":"3.1.0","info":{"title":"API DNI","version":"1.0.0","description":"Consulta de DNI peruano. Devuelve nombres y apellidos del titular."},"servers":[{"url":"https://api-dni-ruc.gd.pe"}],"paths":{"/api/dni/{dni}":{"get":{"summary":"Consulta un DNI peruano (8 dígitos).","parameters":[{"name":"dni","in":"path","required":true,"schema":{"type":"string","pattern":"^\\d{8}$"}}],"responses":{"200":{"description":"DNI encontrado.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DniOk"}}}},"400":{"description":"DNI inválido."},"404":{"description":"DNI no encontrado."},"502":{"description":"Error del proveedor externo."},"503":{"description":"No hay tokens disponibles."}}}},"/api/health":{"get":{"summary":"Estado del servicio","responses":{"200":{"description":"OK"}}}}},"components":{"schemas":{"DniOk":{"type":"object","properties":{"success":{"type":"boolean","const":true},"source":{"type":"string","enum":["cache","provider"],"description":"cache → BD interna · provider → llamada a peruapi.com."},"data":{"type":"object","properties":{"dni":{"type":"string"},"cliente":{"type":"string"},"nombres":{"type":"string"},"apellido_paterno":{"type":"string"},"apellido_materno":{"type":"string"},"mensaje":{"type":"string"},"code":{"type":"string"}}}}}}}}