Endpoints Generales
A continuación se detallan los endpoints generales de la API de Amadeus Magister para la consulta de información básica. Estos endpoints son útiles para obtener datos como los términos y condiciones, lista de países, tipos de documentos y más.
Obtener Términos y Condiciones
Este endpoint devuelve la URL de los términos y condiciones de uso de la aplicación Amadeus Magister que deben ser aceptados por el usuario en el proceso de inscripción.
Request
curl https://dominio.amadeusmagister.com/api/v1/general/terms \
--header 'Authorization: Bearer <API_KEY>'
Response
{
"status": "success",
"data": "https://amadeusmagister.com/terminos-condiciones-app"
}
Listar Países
Este endpoint devuelve una lista de países disponibles en el sistema, usando el estándar ISO 3166-1 alpha-2 (ejemplo: es para España, fr para Francia).
Nota importante: La lista de países es obligatoria para completar ciertos procesos, como la inscripción de alumnos o la configuración de perfiles de usuario.
Si el pais deseado no se encuentra disponible, se recomienda contactar con el soporte técnico de Amadeus Magister.
Request
curl https://dominio.amadeusmagister.com/api/v1/general/countries \
--header 'Authorization: Bearer <API_KEY>'
Response
{
"status": "success",
"data": [
"es",
"fr",
"de",
"pt"
]
}
Tipos de Documento
Este endpoint devuelve los tipos de documentos válidos para la inscripción (DNI, Pasaporte, etc).
Request
curl https://dominio.amadeusmagister.com/api/v1/general/document_types \
--header 'Authorization: Bearer <API_KEY>'
Response
{
"status": "success",
"data": [
"dni",
"nie",
"passport",
"nif"
]
}