alerts.beta
Background - API1Created with Sketch.

Códigos de Respuesta HTTP

La API de Hotmart utiliza el estándar de códigos de respuesta HTTP para indicar el éxito o falla de cada solicitud. En caso de error, además del código de respuesta HTTP, enviamos también un objeto JSON con un mensaje descriptivo del error y su tipo.

Por lo general, los códigos en el intervalo 2xx indican éxito.

Operaciones que resultan en un error que ocurrió de parte del cliente (ej.: token de acceso inválido) van a retornar un código en el intervalo 4xx e indican que la solicitud es de alguna forma inválida. Si recibes un error 4xx, te recomendamos que leas nuestro glosario de errores, para obtener más contexto que te ayude a solucionar el problema.

Ya los códigos de error en el intervalo 5xx sugieren un problema con los servicios de la API de Hotmart.

Si tienes dudas o no consigues resolver tu problema, no dejes de entrar en contacto con nuestro equipo de soporte, si es posible enviando la solicitud completa que estás intentando realizar y el error recibido. Así, nuestro equipo podrá ayudarte a encontrar una solución lo más rápido posible.

Retorno

  • errorstring

    El tipo de error retornado. Puede ser uno de los valores:

    invalid_token, token_expired, unauthorized, unauthorized_client, invalid_parameter, invalid_value_parameter, invalid_value_headers, not_found, too_many_requests ou internal_server_error.

  • error_descriptionstring

    Un mensaje de fácil comprensión que ofrece más detalles sobre el error.

  • error_uristring

    Un link para nuestra documentación donde podrás encontrar más sobre el código de error recibido.

Response
{
   "error": "unauthorized",
   "error_description": "Full authentication is required to access this resource."
   "error_uri": "https://developers.hotmart.com/docs/pt-BR/start/http-response-codes/"
}

Sumario de estatus HTTP

EstatusTipo de errorDefinición
200 - OK-Código de éxito. Todo ha ocurrido como se planeó.
201 - Created-Similar al 200, pero se refiere a un retorno cuando un nuevo recurso ha sido criado.
400 - Bad Requestinvalid_parameterLa solicitud enviada es, de alguna forma, inválida.
invalid_value_parameterLa solicitud enviada posee el valor de la queryString, de alguna forma, inválido.
invalid_value_headersLa solicitud enviada tiene el valor del header de alguna forma inválido.
401 - UnauthorizedunauthorizedEs necesario estar autentificado para proseguir con la solicitud. Este error normalmente ocurre cuando el token de acceso no fue pasado como parámetro, o hay algún problema en el nombre del parámetro pasado en el Header de la solicitud.
token_expiredEl token de acceso pasado como parámetro expiró.
invalid_tokenEl token de acceso pasado como parámetro es, de alguna forma, inválido.
403 - Forbiddenunauthorized_clientEl usuario no posee permisos para proseguir con la solicitud.
404 - Not Foundnot_foundLa URL solicitada no ha sido encontrada y es de alguna forma inválida.
429 - Too Many Requeststoo_many_requestsMuchas solicitudes han sido realizadas en un período corto de tiempo. Para saber más sobre nuestros límites, ve nuestra sección de Rate Limit .
500 - Server Errorinternal_server_errorHa ocurrido algún error interno no esperado y no ha sido posible completar la solicitud.

isPageUseful.question