> For the complete documentation index, see [llms.txt](https://docs.tabiya.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.tabiya.org/tabiya-documentation/es/nuestra-pila-tecnologica/inclusive-livelihoods-taxonomy/open-taxonomy-platform/open-taxonomy-platform-api.md). # API de la plataforma de taxonomía abierta Los mercados laborales son diversos y cambian rápidamente, por lo que una taxonomía útil debe poder localizarse y adaptarse de manera transparente. Conoce más sobre la API que impulsa nuestra plataforma de taxonomía abierta. ## Descripción general y formato La [Plataforma de taxonomía abierta](/tabiya-documentation/es/nuestra-pila-tecnologica/inclusive-livelihoods-taxonomy/open-taxonomy-platform.md) La API proporciona acceso seguro a modelos de taxonomía, ocupaciones, habilidades y sus respectivos grupos, lo que permite una integración fluida con sus aplicaciones. La URL base para todas las solicitudes de la API es [https://taxonomy.tabiya.tech/taxonomy/api-doc/swagger/](https://taxonomy.tabiya.tech/api-doc/swagger/). Para garantizar una comunicación estandarizada, todas las solicitudes y respuestas (excepto las cargas de archivos) utilizan el formato JSON, lo que facilita la integración con cualquier entorno de programación moderno. ## Credenciales y autenticación #### Prerrequisitos Antes de que pueda integrarse con las API, debe obtener credenciales de los administradores de la plataforma. **Solicite credenciales** a través de la dirección de correo electrónico dedicada en esta [página](https://docs.tabiya.org/#discover-tabiyas-work). Según el método de autenticación que elija, recibirá: * **Claves de API**: Una única `X-API-Key` * **OAuth M2M:** Una `URL del servidor de autorización`, `ID de cliente`, y `Secreto de cliente` #### Prefijos de ruta de la API Todas las API de socios usan el siguiente prefijo de ruta: * `/api/partner` para claves de API * `/api/app` Para tokens JWT recibidos mediante OAuth M2M. #### Métodos de autenticación Admitimos dos métodos de autenticación. Elija el que se ajuste a sus requisitos de seguridad. #### Claves de API Las claves de API proporcionan un mecanismo de autenticación sencillo, adecuado para integraciones básicas. **Uso** Incluya la clave de API en cada solicitud usando el `X-API-Key` encabezado HTTP. **Ejemplo:-** ```bash curl -X GET \\ https://taxonomy.tabiya.tech/api/partner/info \\ -H "X-API-Key: YOUR_API_KEY" ``` #### OAuth 2.0 de máquina a máquina (M2M) OAuth 2.0 de máquina a máquina es el método recomendado para una comunicación segura y automatizada entre servicios mediante tokens de acceso de corta duración **Paso 1** Envíe una solicitud HTTP `POST` a **URL del servidor de autorización** usando el `ID de cliente` y `Secreto de cliente`. **Ejemplo** ```bash curl -X POST YOUR_AUTHORIZATION_SERVER_URL \\ -H "Content-Type: application/x-www-form-urlencoded" \\ -d "grant_type=client_credentials&client_id=YOUR_CLIENT_ID&client_secret=YOUR_CLIENT_SECRET" ``` El servidor de autorización responde con un token de acceso: ```json { "access_token": "YOUR_ACCESS_TOKEN", "token_type": "Bearer", "expires_in": 3600 } ``` Para más detalles, consulte la documentación sobre el token de autenticación en la parte de intercambio de credenciales de cliente por [token de acceso](https://oauth.net/2/access-tokens/). * **Paso 2** Envíe una solicitud a la API con el token de acceso del resultado anterior. ```bash curl -X GET \\ https://taxonomy.tabiya.tech/api/app/info \\ -H "Authorization: Bearer YOUR_ACCESS_TOKEN" ``` Para más detalles, consulte la [Ámbitos, M2M y servidores de recursos](https://docs.aws.amazon.com/cognito/latest/developerguide/cognito-user-pools-define-resource-servers.html) documentación en AWS. ## Acceso directo a la especificación OpenAPI Hay dos métodos de acceso disponibles para las especificaciones de la API. El método principal es a través de la documentación interactiva Swagger UI, que permite explorar y probar en vivo todos los endpoints. Fundamentalmente, para los desarrolladores que buscan configurar rápidamente sus clientes, se proporciona un enlace directo e independiente al archivo de especificación JSON de OpenAPI v3. Este enlace es esencial para los desarrolladores que desean importar toda la definición de la API en herramientas como Postman o Insomnia (usando la *opción Importar > Enlace*), acelerando la configuración mediante la generación automática de todas las definiciones de endpoints, parámetros y esquemas: * Enlace de la especificación OpenAPI: * Enlace de Swagger UI: * Enlace de ReDoc UI: --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://docs.tabiya.org/tabiya-documentation/es/nuestra-pila-tecnologica/inclusive-livelihoods-taxonomy/open-taxonomy-platform/open-taxonomy-platform-api.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.