> For the complete documentation index, see [llms.txt](https://docs.1980tic.us/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.1980tic.us/api-de-desarrolladores/apiv2.md). # APIV2 La URL para hacer uso de API v2 cambia a . El protocolo HTTPS es OBLIGATORIO Esta versión de API seguirá las convenciones de RESTful cuando seaposible, y la mayoría de las operaciones pueden ser realizadas a través de solicitudes GET, POST, PUT y DELETE. Los cuerpos de las solicitudes y las respuestas se codifican como JSON. ## Autenticación Se hace uso de un Token de Acceso API para autenticar las solicitudes. Puedes ver y gestionar tu token de acceso en el módulo Configuración > Integración > API para desarrolladores. Puedes generar hasta 10 tokens de acceso por espacio de trabajo. Cada organización está limitada a generar un máximo de 10 tokens de acceso. La autenticación se pasa a través del encabezado de Autorización con cada solicitud. ## Tasa de límites Se estableció una limitación en la cantidad de solicitudes que se pueden enviar por cada end-point. Los límites se aplican a nivel de organización. Las respuestas de la API contienen cabeceras de límite de velocidad útiles para comprobar las solicitudes restantes. | Nombre | Descripción | | ----------------------- | ---------------------------------------------------------------------- | | `Retry-After` | Cantidad de segundos antes de que puedas volver a enviar una solicitud | | `X-RateLimit-Limit` | Cantidad de solicitudes permitidas para este end-point | | `X-RateLimit-Remaining` | Cantidad de solicitudes restantes disponibles en este end-point | ## Límites | Nombre de API | Endpoint | Solicitudes por segundo | | ---------------------------------------- | --------------------------------------------- | ----------------------- | | Enviar un mensaje | `/contact/{identifier}/message` | 10 | | Obtener un mensaje | `/contact/{identifier}/message/{messageId}` | 15 | | Crear un comentario | `/contact/{identifier}/comment` | 10 | | Obtener un contacto | `/contact/{identifier}` | 10 | | Crear, actualizar o eliminar un contacto | `/contact/{identifier}` | 5 | | Fusionar dos contactos | `/contact/merge` | 5 | | Crear o actualizar un contacto | `/contact/create_or_update/{identifier}` | 5 | | Añadir o eliminar etiquetas | `/contact/{identifier}/tag` | 5 | | Listar canales por contacto | `/contact/{identifier}/channels` | 5 | | Obtener el canal de un contacto | `/contact/{identifier}/channel/{channelId}` | 10 | | Asignar/Desasignar una conversación | `/contact/{identifier}/conversation/assignee` | 5 | | Abrir/Cerrar una conversación | `/contact/{identifier}/conversation/status` | 5 | | Listar canales en un espacio | `/space/channel` | 5 | | Listar notas de cierre | `/space/closing_notes` | 5 | | Listar usuarios por espacio | `/space/user` | 5 | | Obtener un usuario de un espacio | `/space/user/{id}` | 10 | | Crear campo de contacto | `/space/contact_field` | 5 | | Obtener campo de contacto | `/space/contact_field/{id}` | 10 | | Listar campos de contacto | `/space/contact_field` | 5 | ## Códigos de respuesta HTTP | Codigo de estado | Descripción | | --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | 200 Ok | La solicitud se ha realizado con éxito y se ha proporcionado la respuesta adecuada. | | 201 Created | La solicitud se ha cumplido, dando lugar a la creación de un nuevo recurso. | | 400 Bad request | Hay un error en el lado del cliente y, como resultado, el servidor no puede devolver una respuesta. Por ejemplo, el correo electrónico, el teléfono o el ID del contacto no son válidos. | | 401 Unauthorised | El token de acceso no es válido. | | 404 Not Found | Dado el token de acceso utilizado, el recurso no existe. | | 429 Too many requests | Esta solicitud excede el número de solicitudes permitidas. Reduzca la velocidad y vuelva a intentarlo. | | 502/504 timeouts | El servidor ascendente no ha proporcionado una respuesta oportuna al segundo servidor, que actualmente sirve de pasarela o proxy. Como resultado, no puede proporcionar una respuesta al cliente. | | 503 | El servidor no puede procesar la solicitud porque está sobrecargado o está en mantenimiento. |