WTF ¿Son APIs?

Si eres un profesional en activo, probablemente has escuchado a tus compañeros de trabajo hablar de APIs , , , , , , , endpoints , , , , , , , , , . ¿Qué diablos significa y cuál es la diferencia entre ellos?

¿Qué es una API?

Una API , o interfaz de programa de aplicación, es algo que permite que diferentes aplicaciones se comuniquen entre sí. Un Web Service es un tipo de API que se comunica a través de Internet. generalmente, cuando las aplicaciones se comunican entre sí, hay un intercambio de peticiones y respuestas …

  • Request es pedir algo
  • Respuesta es la respuesta a una solicitud
    La Aplicación A envía la solicitud a la Aplicación B. La Aplicación B envía la respuesta a la Aplicación A. Similar a la solicitud de algo en la vida real, es posible que no obtenga la respuesta que desea o espera. A veces tienes éxito y a veces no. Un ejemplo de esto sería buscar algo en Google. Cuando usted escribe algo en el motor de búsqueda y presiona enter, éste realiza una solicitud de API. La mayoría de las veces, Google devuelve una respuesta con millones de resultados, pero a veces no es capaz de encontrar nada, como veremos en la siguiente sección, hay frases específicas que los técnicos de hoy en día utilizan cuando hablan de APIs. Ahora tú también puedes estar al tanto!

    Solicitudes

    • “Make / Fire an API call” : hacer una petición.
    • “Make a GET request” : hacer una petición para obtener datos.
    • “Make a POST request” : realizar una petición para crear datos.
    • “Make a PUT request” : realizar una petición de actualización de datos.
    • “Endpoint” : la url, por ejemplo (https://twitter.com/songthamtung).
    • “Hit the endpoint” : realizar una petición en la url especificada.

    Respuesta

    • “200” : El código de respuesta HTTP para el éxito.
    • “301” : El código de respuesta HTTP para Redirect.
    • “400”: El código de respuesta HTTP para Bad Request.
    • 401 “: El código de respuesta HTTP para No Autorizado.
    • “403”: El código de respuesta HTTP para Prohibido.
    • “404” : El código de respuesta HTTP de No encontrado.
    • “500” : El código de respuesta HTTP para el error interno del servidor.
    • “504” : El código de respuesta HTTP para Timeout.

    Autenticación

    • “OAUTH”: una forma para que las aplicaciones otorguen permiso con el uso de tokens.
    • “Token” : una forma de autenticación, similar al nombre de usuario/contraseña.
    • “Refrescar el token” : los tokens pueden expirar y expiran. Si va a obtener un 401, considere la posibilidad de actualizar su token de API.

    General

    • “¿Tienen un API? ¿Su aplicación tiene alguna forma de comunicarse con nuestra aplicación?
    • “Open API” : disponible para uso público.
    • “Closed API” : no disponible para uso público.
    • “Límite de API” : algunas APIs tienen un límite sobre el número de peticiones que se pueden hacer dentro de un período determinado, por ejemplo (1000 peticiones al día).
    • CRUD “: Crear, Leer, Actualizar y Eliminar.
    • “Pruébalo con Postman” : Postman es una herramienta de desarrollo de API impresionante.
    • “Header” : explica el tipo de datos que se envían.
    • “Cuerpo” : los datos que se envían.
    • “GUID”: Identificador globalmente único que se utiliza para registros distintivos, por ejemplo (e20f5d52-5490-4523-87c5-af46dadfe7c1).
    • “JSON” : un tipo de formato de datos caracterizado por {“key”: “value”}”.
    • “XML” : un tipo de formato de datos caracterizado por el valor
    • “REST(ful) API” : un tipo de API que utiliza restricciones de transferencia de estado de representación.
    • “SOAP API” : un tipo de API que utiliza Simple Object Access Protocol y está basado en XML.
    • “GraphQL” : un lenguaje de consulta para APIs.
    • “Check their documentation” : la mayoría de las APIs tienen una página de referencia sobre cómo empezar, autenticación y métodos que soporta.

    Conclusión

    A los técnicos les encanta usar palabras técnicas. Esto no se hace para confundir o excluir a personas ajenas, sino para comunicar ideas, problemas y soluciones de manera rápida y efectiva:

    “¡Sí! ¡La respuesta del API devolvió un 200!”

    “Intenta crear un nuevo usuario. Golpear el endpoint de usuario y hacer una petición POST”

    Esperamos que ahora sea capaz de entender las dos frases anteriores. Si tienes otra forma de comunicarte sobre las APIs o si tienes alguna pregunta con los ejemplos de arriba, sólo tienes que dejar un comentario a continuación para hacérmelo saber. Originalmente publicado en A Cloud Guru.

Etiquetas

ApiStartupCodificaciónServidorProgramaciónHackingConsejoConsejosLas últimas historias técnicas

Comentarios

Continúe la discusión