Verificar Profesional

Consulta la información de habilitación de un profesional de la salud.

Endpoint POST /v1/profesional/verificar

Requiere los encabezados de autenticación descritos en autenticacion.md.

Parámetros (body JSON)

Campo	Tipo	Obligatorio	Ejemplo	Descripción
documento	string	Sí	"20123456"	Número de documento (DNI) del profesional.
jurisdiccion (opcional)	string	—	"02"	Código de jurisdicción (2 dígitos) para filtrar búsqueda.

Ejemplo - curl

curl -X POST "https://api.asystir.com/v1/profesional/verificar" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: TU_API_KEY" \
  -H "X-API-Secret: TU_API_SECRET" \
  -d '{"documento":"20123456","jurisdiccion":"02"}'

Ejemplo - JavaScript (fetch)

await fetch("https://api.asystir.com/v1/profesional/verificar", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "X-API-Key": "TU_API_KEY",
    "X-API-Secret": "TU_API_SECRET"
  },
  body: JSON.stringify({ documento: "20123456", jurisdiccion: "02" })
})
.then(r => r.json())
.then(console.log);

Ejemplo - Visual Basic .NET

Imports System.Net.Http
Imports System.Text
Imports System.Threading.Tasks

Public Async Function VerificarProfesional() As Task
    Dim client As New HttpClient()
    client.DefaultRequestHeaders.Add("X-API-Key", "TU_API_KEY")
    client.DefaultRequestHeaders.Add("X-API-Secret", "TU_API_SECRET")

    Dim json = "{""documento"":""20123456"",""jurisdiccion"":""02""}"
    Dim content = New StringContent(json, Encoding.UTF8, "application/json")
    Dim resp = Await client.PostAsync("https://api.asystir.com/v1/profesional/verificar", content)
    Dim body = Await resp.Content.ReadAsStringAsync()
    Console.WriteLine(body)
End Function

Respuesta de éxito (200)

{
  "success": true,
  "data": {
    "documento": "20123456",
    "nombre": "María",
    "apellido": "Gómez",
    "matricula": "43822",
    "refeps_id": "541034610959",
    "jurisdiccion": "02",
    "especialidad": "Medicina General",
    "activo": true
  }
}

Errores comunes

• 400 Bad Request — Body mal formado o campo documento ausente.
• 404 Not Found — Profesional no encontrado.
• 401/403 — Credenciales inválidas o sin permisos.
• 500 Internal Server Error — Error del servicio externo de validación (REFEPS/SISA).

Notas

• La respuesta puede incluir múltiples identificadores en refeps_id si corresponde.
• Este endpoint realiza llamadas a servicios oficiales (REFEPS, SISA). Los tiempos pueden variar; implemente timeout en el cliente.