{"success":true,"api_info":{"name":"BuhoLegal API - Expedientes","version":"1.0","base_url":"/api/v1","description":"API para gestión de expedientes y consulta de acuerdos judiciales","authentication":"Token de autenticación requerido en header: Authorization: Token <your-token>","swagger_docs":"/api/v1/schema/","test_dashboard":"/dashboard/"},"endpoints":{"expedientes":[{"method":"POST","url":"/api/v1/expedientes/create/<entidad>/","description":"Crear un nuevo expediente para seguimiento","parameters":{"url_params":{"entidad":"federal|cdmx|estado_mexico|guanajuato|etc"},"required_body":["expediente","nombre","juzgado_id"],"optional_body":["asunto","notas","tipo_expediente"]},"example_request":{"expediente":"123/2025","nombre":"Mi expediente federal","juzgado_id":1533,"tipo_expediente":"60","asunto":"Amparo indirecto"},"example_response":{"success":true,"message":"Expediente creado exitosamente","data":{"id":123,"expediente":"123/2025"}}},{"method":"GET","url":"/api/v1/expedientes/list/","description":"Listar todos mis expedientes guardados","parameters":{"query_params":{"entidad":"opcional - filtrar por entidad"}},"example_response":{"success":true,"data":[{"id":1,"expediente":"123/2025","nombre":"Mi expediente"}],"total":1}},{"method":"PUT","url":"/api/v1/expedientes/edit/<id>/","description":"Editar un expediente existente","parameters":{"url_params":{"id":"ID del expediente a editar"},"optional_body":["nombre","asunto","notas"]}},{"method":"DELETE","url":"/api/v1/expedientes/delete/<id>/","description":"Eliminar un expediente","parameters":{"url_params":{"id":"ID del expediente a eliminar"}}}],"catalogos":[{"method":"GET","url":"/api/v1/circuitos-federales/","description":"Obtener lista de circuitos judiciales federales (1-32)","parameters":"Ninguno","example_response":{"success":true,"data":[{"id":1,"nombre":"Primer Circuito"}],"total":32}},{"method":"GET","url":"/api/v1/organismos-federales/<id_circuito>/","description":"Obtener organismos (juzgados) de un circuito específico","parameters":{"url_params":{"id_circuito":"ID del circuito (1-32)"}},"example_response":{"success":true,"data":[{"id":1533,"nombre":"Juzgado Primero de Distrito"}],"circuito_id":1}},{"method":"GET","url":"/api/v1/fuentes/","description":"Obtener lista de entidades/fuentes disponibles","example_response":{"success":true,"data":[{"id":"federal","nombre":"Federal"},{"id":"cdmx","nombre":"Ciudad de México"}]}},{"method":"GET","url":"/api/v1/juzgados/<entidad>/","description":"Obtener juzgados de una entidad estatal","parameters":{"url_params":{"entidad":"cdmx|estado_mexico|guanajuato|etc"}}}],"acuerdos":[{"method":"GET","url":"/api/v1/mis-acuerdos/","description":"Buscar acuerdos de MIS expedientes guardados","parameters":{"query_params":{"expediente_id":"opcional - ID específico de expediente","entidad":"opcional - filtrar por entidad","fecha_desde":"opcional - formato YYYY-MM-DD","fecha_hasta":"opcional - formato YYYY-MM-DD"}},"example_response":{"success":true,"data":[{"expediente":"123/2025","fecha":"2025-09-08","sintesis":"Acuerdo"}],"total":1}}]},"common_errors":{"400":{"description":"Parámetros faltantes o inválidos","example":{"success":false,"error_type":"validation_error","message":"Parámetros faltantes o inválidos","details":{"missing_parameters":[{"param":"expediente","type":"string"}]}}},"401":{"description":"No autenticado - Token faltante o inválido","example":{"detail":"Authentication credentials were not provided."}},"404":{"description":"Recurso no encontrado","example":{"success":false,"error_type":"resource_not_found","message":"No existe el circuito federal con ID 999"}},"500":{"description":"Error interno del servidor","example":{"success":false,"error_type":"internal_server_error","message":"Error interno del servidor"}}},"authentication_example":{"header":"Authorization: Token abc123def456","login_endpoint":"/api/v1/users/login/","obtain_token":"POST con username/password para obtener token"},"useful_tips":["Usa el dashboard en /dashboard/ para probar los endpoints interactivamente","Consulta la documentación Swagger completa en /api/v1/schema/","Para expedientes federales: primero obtén circuitos, luego organismos","Para expedientes estatales: obtén juzgados de la entidad directamente","Todos los endpoints requieren autenticación excepto este de ayuda","Los IDs de circuitos van del 1 al 32","Las fechas deben enviarse en formato YYYY-MM-DD"]}