{
  "info": {
    "_postman_id": "1bff3f5d-ef6d-4a2c-9624-87cca919f155",
    "name": "Socket Studio · API de Cédula con foto",
    "description": "Consulta de cédula ecuatoriana con fotografía.\n\n**Cómo usarla**\n1. Importa este archivo en Postman.\n2. Abre la colección → pestaña **Variables** y pega tu token en `token` (columna *Current value*).\n3. Cambia `cedula` si quieres consultar otra y pulsa **Send**.\n\nEl token va en la cabecera `Authorization: Bearer {{token}}`; la colección ya la envía sola.\n\nDocumentación completa (respuestas, errores, límites y ejemplos de código): https://socket-studio.com/api-docs.html",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "auth": {
    "type": "bearer",
    "bearer": [
      {
        "key": "token",
        "value": "{{token}}",
        "type": "string"
      }
    ]
  },
  "event": [
    {
      "listen": "prerequest",
      "script": {
        "type": "text/javascript",
        "exec": [
          "if (!pm.collectionVariables.get(\"token\")) {",
          "  console.warn(\"Falta el token: pégalo en la variable \\\"token\\\" de la colección (pestaña Variables).\");",
          "}"
        ]
      }
    }
  ],
  "variable": [
    {
      "key": "base_url",
      "value": "https://apicedula.datecu.link",
      "type": "string"
    },
    {
      "key": "cedula",
      "value": "1724718158",
      "type": "string"
    },
    {
      "key": "token",
      "value": "",
      "type": "string"
    }
  ],
  "item": [
    {
      "name": "Consulta cédula con foto",
      "event": [
        {
          "listen": "test",
          "script": {
            "type": "text/javascript",
            "exec": [
              "if (pm.response.code === 403) {",
              "  console.warn(\"403: token vacío, vencido o no corresponde a este producto. Pégalo en la variable \\\"token\\\" de la colección (pestaña Variables). Detalle: https://socket-studio.com/api-docs.html#errores\");",
              "}",
              "pm.test(\"Responde 200\", function () { pm.response.to.have.status(200); });",
              "pm.test(\"La cédula existe (no vino null)\", function () { pm.expect(pm.response.json()).to.not.equal(null); });",
              "pm.test(\"Incluye la foto\", function () { var j = pm.response.json(); pm.expect(j && j.foto).to.be.a(\"string\").and.not.empty; });"
            ]
          }
        }
      ],
      "request": {
        "method": "GET",
        "header": [
          {
            "key": "Accept",
            "value": "application/json",
            "type": "text"
          }
        ],
        "url": {
          "raw": "{{base_url}}/consulta-cedula/consulta/{{cedula}}",
          "host": [
            "{{base_url}}"
          ],
          "path": [
            "consulta-cedula",
            "consulta",
            "{{cedula}}"
          ]
        },
        "description": "Devuelve la ficha completa de la persona, incluida la fotografía en base64 (campo `foto`).\n\n- Cédula inexistente: responde 200 con el cuerpo `null`.\n- Límite de velocidad (existe para evitar ataques): 150 consultas cada 5 minutos por IP. Al superarlo responde 429 con la cabecera `Retry-After`.\n- Configura un timeout de 60 s: una cédula nueva puede tardar más porque se pide a las fuentes oficiales.\n\nDocumentación completa: https://socket-studio.com/api-docs.html"
      },
      "response": [
        {
          "name": "200 · Cédula encontrada (valores ficticios)",
          "originalRequest": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{base_url}}/consulta-cedula/consulta/{{cedula}}",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "consulta-cedula",
                "consulta",
                "{{cedula}}"
              ]
            },
            "description": "Devuelve la ficha completa de la persona, incluida la fotografía en base64 (campo `foto`).\n\n- Cédula inexistente: responde 200 con el cuerpo `null`.\n- Límite de velocidad (existe para evitar ataques): 150 consultas cada 5 minutos por IP. Al superarlo responde 429 con la cabecera `Retry-After`.\n- Configura un timeout de 60 s: una cédula nueva puede tardar más porque se pide a las fuentes oficiales.\n\nDocumentación completa: https://socket-studio.com/api-docs.html"
          },
          "status": "OK",
          "code": 200,
          "_postman_previewlanguage": "json",
          "header": [
            {
              "key": "Content-Type",
              "value": "application/json; charset=utf-8"
            }
          ],
          "cookie": [],
          "body": "{\n  \"identificacion\": \"1712345675\",\n  \"nombres\": \"APELLIDO1 APELLIDO2 NOMBRE1 NOMBRE2\",\n  \"codigoDactilar\": \"V0000V0000\",\n  \"fechaNacimiento\": \"01/01/1990\",\n  \"lugarNacimiento\": \"PICHINCHA/QUITO/GONZALEZ SUAREZ\",\n  \"nacionalidad\": \"ECUATORIANA\",\n  \"estadoCivil\": \"SOLTERO\",\n  \"genero\": \"HOMBRE\",\n  \"nombrePadre\": \"APELLIDO NOMBRE\",\n  \"nombreMadre\": \"APELLIDO NOMBRE\",\n  \"foto\": \"/9j/4AAQSkZJRgABAQAAAQABAAD/2wBD…\"\n}"
        },
        {
          "name": "200 · Cédula no encontrada",
          "originalRequest": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{base_url}}/consulta-cedula/consulta/{{cedula}}",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "consulta-cedula",
                "consulta",
                "{{cedula}}"
              ]
            },
            "description": "Devuelve la ficha completa de la persona, incluida la fotografía en base64 (campo `foto`).\n\n- Cédula inexistente: responde 200 con el cuerpo `null`.\n- Límite de velocidad (existe para evitar ataques): 150 consultas cada 5 minutos por IP. Al superarlo responde 429 con la cabecera `Retry-After`.\n- Configura un timeout de 60 s: una cédula nueva puede tardar más porque se pide a las fuentes oficiales.\n\nDocumentación completa: https://socket-studio.com/api-docs.html"
          },
          "status": "OK",
          "code": 200,
          "_postman_previewlanguage": "json",
          "header": [
            {
              "key": "Content-Type",
              "value": "application/json; charset=utf-8"
            }
          ],
          "cookie": [],
          "body": "null"
        },
        {
          "name": "403 · Sin token o token no aceptado",
          "originalRequest": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{base_url}}/consulta-cedula/consulta/{{cedula}}",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "consulta-cedula",
                "consulta",
                "{{cedula}}"
              ]
            },
            "description": "Devuelve la ficha completa de la persona, incluida la fotografía en base64 (campo `foto`).\n\n- Cédula inexistente: responde 200 con el cuerpo `null`.\n- Límite de velocidad (existe para evitar ataques): 150 consultas cada 5 minutos por IP. Al superarlo responde 429 con la cabecera `Retry-After`.\n- Configura un timeout de 60 s: una cédula nueva puede tardar más porque se pide a las fuentes oficiales.\n\nDocumentación completa: https://socket-studio.com/api-docs.html"
          },
          "status": "Forbidden",
          "code": 403,
          "_postman_previewlanguage": "json",
          "header": [
            {
              "key": "Content-Type",
              "value": "application/json; charset=utf-8"
            }
          ],
          "cookie": [],
          "body": "{\n  \"error\": \"Acceso denegado o límite de consultas alcanzado. Necesitas un token válido y un plan premium vigente. Revisa los planes en https://socket-studio.com/api-cedula-ruc.html\",\n  \"plan\": \"premium\",\n  \"mas_info\": \"https://socket-studio.com/api-cedula-ruc.html\"\n}"
        },
        {
          "name": "429 · Límite de velocidad superado (150 cada 5 min por IP)",
          "originalRequest": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{base_url}}/consulta-cedula/consulta/{{cedula}}",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "consulta-cedula",
                "consulta",
                "{{cedula}}"
              ]
            },
            "description": "Devuelve la ficha completa de la persona, incluida la fotografía en base64 (campo `foto`).\n\n- Cédula inexistente: responde 200 con el cuerpo `null`.\n- Límite de velocidad (existe para evitar ataques): 150 consultas cada 5 minutos por IP. Al superarlo responde 429 con la cabecera `Retry-After`.\n- Configura un timeout de 60 s: una cédula nueva puede tardar más porque se pide a las fuentes oficiales.\n\nDocumentación completa: https://socket-studio.com/api-docs.html"
          },
          "status": "Too Many Requests",
          "code": 429,
          "_postman_previewlanguage": "json",
          "header": [
            {
              "key": "Content-Type",
              "value": "application/json; charset=utf-8"
            }
          ],
          "cookie": [],
          "body": "{\n  \"status\": 429,\n  \"error\": \"Demasiadas solicitudes desde esta IP. Intente más tarde.\"\n}"
        }
      ]
    },
    {
      "name": "Variantes sin foto",
      "description": "Rutas que devuelven la ficha sin la fotografía (respuesta más liviana).",
      "item": [
        {
          "name": "Ficha sin foto (info)",
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "if (pm.response.code === 403) {",
                  "  console.warn(\"403: token vacío, vencido o no corresponde a este producto. Pégalo en la variable \\\"token\\\" de la colección (pestaña Variables). Detalle: https://socket-studio.com/api-docs.html#errores\");",
                  "}",
                  "pm.test(\"Responde 200\", function () { pm.response.to.have.status(200); });"
                ]
              }
            }
          ],
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{base_url}}/consulta-cedula/consulta/info/{{cedula}}",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "consulta-cedula",
                "consulta",
                "info",
                "{{cedula}}"
              ]
            },
            "description": "La misma ficha de la persona, sin la fotografía."
          },
          "response": []
        },
        {
          "name": "Solo nombres (free)",
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "if (pm.response.code === 403) {",
                  "  console.warn(\"403: token vacío, vencido o no corresponde a este producto. Pégalo en la variable \\\"token\\\" de la colección (pestaña Variables). Detalle: https://socket-studio.com/api-docs.html#errores\");",
                  "}",
                  "pm.test(\"Responde 200\", function () { pm.response.to.have.status(200); });"
                ]
              }
            }
          ],
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{base_url}}/consulta-cedula/consulta/free/{{cedula}}",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "consulta-cedula",
                "consulta",
                "free",
                "{{cedula}}"
              ]
            },
            "description": "Devuelve únicamente los nombres de la persona."
          },
          "response": []
        },
        {
          "name": "Fecha de nacimiento (datebirth)",
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "if (pm.response.code === 403) {",
                  "  console.warn(\"403: token vacío, vencido o no corresponde a este producto. Pégalo en la variable \\\"token\\\" de la colección (pestaña Variables). Detalle: https://socket-studio.com/api-docs.html#errores\");",
                  "}",
                  "pm.test(\"Responde 200\", function () { pm.response.to.have.status(200); });"
                ]
              }
            }
          ],
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json",
                "type": "text"
              }
            ],
            "url": {
              "raw": "{{base_url}}/consulta-cedula/consulta/datebirth/{{cedula}}",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "consulta-cedula",
                "consulta",
                "datebirth",
                "{{cedula}}"
              ]
            },
            "description": "Devuelve la fecha de nacimiento."
          },
          "response": []
        }
      ]
    }
  ]
}
