Códigos de estado HTTP
Los códigos de estado de respuesta HTTP son números de tres dígitos que retorna un servidor en respuesta a una solicitud realizada por un cliente al servidor.
2xx — Éxito
La clase de códigos de estado 2xx (Exitoso) indica que la solicitud del cliente fue recibida, entendida y aceptada correctamente.
200 Éxito
El código de estado de respuesta correcta HTTP 200 OK indica que una solicitud se ha completado con éxito. A continuación se muestra un ejemplo de una solicitud con código de estado 200 al obtener información de la cuenta:
{
"id": 123123123,
"name": "yourname",
"subdomain": "yourdomain",
"created_at": 1739794993,
"created_by": 0,
"updated_at": 17234645,
"updated_by": 0,
"current_user_id": 123423,
"country": "NL",
"currency": "EUR",
"currency_symbol": "€",
"_links": {
"self": {
"href": "https://subdomain.kommo.com/api/v4/account"
}
}
}201 Creado
El código de estado de respuesta correcta HTTP 201 Created indica que la solicitud HTTP ha dado lugar a la creación de una entidad. A continuación se muestra un ejemplo de código de estado 201 al crear un campo personalizado:
{
"id": 1016236,
"name": "Client Type",
"type": "select",
"account_id": 34389139,
"code": null,
"sort": 500,
"is_api_only": false,
"enums": [
{
"id": 867968,
"value": "New",
"sort": 500
},
{
"id": 867970,
"value": "Regular",
"sort": 500
},
{
"id": 867972,
"value": "VIP",
"sort": 500
}
],
"group_id": null,
"required_statuses": [],
"is_deletable": true,
"is_predefined": false,
"entity_type": "leads",
"tracking_callback": null,
"remind": null,
"triggers": [],
"currency": null,
"hidden_statuses": [],
"chained_lists": null,
"_links": {
"self": {
"href": "https://subdomain.kommo.com/api/v4/leads/custom_fields/1016236"
}
}
}204 Sin contenido
El código de estado de respuesta correcta HTTP 204 No Content indica que una solicitud se ha completado correctamente, pero el recurso no contiene contenido. Por ejemplo, puedes enviar una solicitud para obtener la lista de fuentes de una integración, pero recibirás un código de estado 204 si no existe ninguna.
4xx — Error del cliente
La clase de códigos de estado (Error del cliente) indica que parece que el cliente ha cometido un error. Significa que la solicitud tiene una sintaxis incorrecta o no puede ser procesada.
400 Solicitud incorrecta
El código de estado de respuesta de error del cliente HTTP 400 Bad Request ndica que el servidor no procesará la solicitud debido a algo que considera un error del cliente. La causa de una respuesta 400 suele deberse a una sintaxis de solicitud mal formada, un formato de mensaje de solicitud inválido o un enrutamiento engañoso de la solicitud.
{
"validation-errors": [
{
"request_id": "0",
"errors": [
{
"code": "NotSupportedChoice",
"path": "custom_fields_values.0.field_id",
"detail": "The value you selected is not a valid choice."
},
{
"code": "InvalidType",
"path": "status_id",
"detail": "This value should be of type array."
}
]
}
],
"title": "Bad Request",
"type": "https://httpstatus.es/400",
"status": 400,
"detail": "Request validation failed"
}{
"title": "Bad Request",
"type": "https://httpstatus.es/400",
"status": 400,
"detail": "Request data can not be empty"
}401 No autorizado
El código de estado de respuesta de error del cliente HTTP 401 Unauthorized indica que una solicitud no fue exitosa porque carece de credenciales de autenticación válidas para el recurso solicitado. En Kommo, puedes obtener este código de estado si utilizas datos de cuenta inválidos, tokens expirados o un método de autorización no compatible.
{
"title": "Unauthorized",
"type": "https://httpstatus.es/401",
"status": 401,
"detail": "Invalid user name or password"
}402 Pago requerido
El código de estado de error del cliente HTTP 402 Payment Required indica que el período de pago o de prueba de tu cuenta de Kommo ha finalizado y necesitas renovarlo.
{
"title": "Payment Required",
"type": "https://httpstatus.es/402",
"status": 402,
"detail": "Payment required"
}404 No encontrado
El código de estado de respuesta de error del cliente HTTP 404 Not Found indica que el servidor no puede encontrar el recurso solicitado. En este caso, se intentó obtener información de un recurso inexistente /example.
{
"title": "Not Found",
"type": "https://httpstatus.es/404",
"status": 404,
"detail": "Cannot GET https://subdomain.kommo.com/example"
}{
"status": 0,
"error_code": 404,
"error_type": "ORIGIN_NOT_REGISTERED",
"error_description": "NOT_FOUND"
}405 Método no permitido
El código de estado de respuesta de error del cliente HTTP 405 Method Not Allowed indica que el servidor reconoce el método de la solicitud, pero el recurso de destino no lo admite. Si utilizas un método no disponible para una solicitud en particular, recibirás una respuesta 405.
{
"title": "Method Not Allowed",
"type": "https://httpstatus.es/405",
"status": 405,
"detail": "Method Not Allowed"
}422 Entidad no procesable
El código de estado de respuesta de error del cliente HTTP 422 Unprocessable Content indica que el servidor entendió el tipo de contenido de la solicitud y que la sintaxis era correcta, pero no pudo procesar las instrucciones. A continuación se muestra un ejemplo de la respuesta al intentar agregar más de 250 leads en una sola solicitud.
{
"title": "Unprocessable Entity",
"type": "https://httpstatus.es/422",
"status": 422,
"detail": "Limit 250 per page"
}429 Demasiadas solicitudes
El código de estado de respuesta de error del cliente HTTP 429 Too Many Requests indica que el cliente ha enviado demasiadas solicitudes en un período de tiempo determinado. Si recibes el 429 demasiadas veces, tu cuenta puede ser bloqueada y obtendrás una respuesta 403 en cualquier solicitud a la API. Familiarízate con nuestros límites si recibes este código de estado.
A continuación se muestra la respuesta que puedes recibir si superas el límite de 7 solicitudes por segundo por IP.
{
"title": "Too Many Requests",
"type": "https://httpstatus.es/429",
"status": 429,
"detail": "You have sent too many requests in a given amount of time. Please try again later.",
"retry_after": 300
}403 Prohibido
El código de estado de respuesta de error del cliente HTTP 403 Forbidden indica que el servidor entendió la solicitud, pero se negó a procesarla. En Kommo, puedes recibir el código de estado 403 si tu cuenta fue bloqueada a nivel de API (consulta el código de estado 429), o si envías un X-Signature inválido para los métodos de la API de Chats.
{
"status": 0,
"error_code": 403,
"error_type": "ORIGIN_INVALID_SIGNATURE",
"error_description": "invalid signature"
}403 Forbidden5xx — Error del servidor
500 Error interno del servidor
El código de estado de respuesta de error del servidor HTTP 500 Internal Server Error indica que el servidor encontró una condición inesperada que le impidió completar la solicitud. Si ves esta respuesta, por favor, contacta a nuestro equipo de soporte.
{
"title": "ErrInternalServer",
"status": 500,
"detail": "Our team are probably already working on the elimination of the problem",
"trace_id": "8e9b1e47-1ea4-111f0-a4f9-0031163e1de759"
}Updated 27 days ago