Crear integración de API

En este tutorial, se crean 2 integraciones de API

  • GetAllCountries devuelve una lista de países
  • GetChildren: devuelve elementos secundarios inmediatos del país o estado representado por geonameId

GetAllCountries: configuración de integración de API

  • Configuración de integración de API

    • Nombre para mostrar: GetAllCountries → una etiqueta para esta API en su sistema.

    • URL de API: https://secure.geonames.org/countryInfoJSON - el punto final al que llama.

    • Método HTTP: GET - está realizando una petición GET simple.

    • Tipo de contenido: JSON - la respuesta se espera en formato JSON.

  • Opciones:

    • Cifrado obligatorio sin marcar - sin capa de cifrado más allá de HTTPS.

    • Ejecutar en cliente comprobado - la llamada se ejecuta desde el cliente/explorador, no desde el lado del servidor.

  • Tipo de autenticación

    • Ninguno - dado que la API GeoNames no requiere claves OAuth o API en los encabezados
  • Entrada:

    • La sección de entrada define lo que se envía a la API
    • nombre de usuario → tipo: cadena, enviado en la consulta, predeterminado: gbedekar.
    • Cada solicitud añade ?username=gbedekar a la dirección URL
  • Salida

    • La salida define qué campos de la respuesta JSON se van a extraer y utilizar.
      La respuesta de GeoNames tiene este aspecto:

    json-response

    • Se asignaron dos campos desde dentro de la matriz geonames:

      geonames[*].geonameId → como número

      geonames[*].countryName → como una cadena

      [*] significa que se repite en cada país de la matriz.

get-all-countries

GetChildren

Solicita a GeoNames los elementos secundarios inmediatos del lugar cuyo geonamesId se pasa como parámetro de consulta

  • Configuración de integración de API

    • Nombre para mostrar: GetAllCountries → una etiqueta para esta API en su sistema.

    • URL de API: https://secure.geonames.org/children → el punto final al que llama.

    • Método HTTP: GET → realiza una petición GET simple.

    • Tipo de contenido: JSON → se espera una respuesta en formato JSON.

  • Opciones:

    • Cifrado obligatorio sin marcar → ninguna capa de cifrado que no sea HTTPS.

    • Ejecutar en el cliente comprobado → la llamada se ejecuta desde el cliente o el explorador, no desde el servidor.

  • Tipo de autenticación

    • Ninguno - dado que la API GeoNames no requiere claves OAuth o API en los encabezados
  • Entrada:

    • Define lo que se envía a la API
    • nombre de usuario → tipo: Cadena, enviado en la Consulta, predeterminado: gbedekar.
    • Cada solicitud añade ?username=gbedekar a la dirección URL
    • geonameId -> tipo: Cadena. Devuelve los elementos secundarios del país o estado representado por el elemento geonameId
    • tipo =>Cadena. Si se establece en json, la respuesta se devuelve en formato JSON.
  • Salida

    • Define qué campos de la respuesta JSON se van a extraer y utilizar.
      La respuesta de GeoNames tiene este aspecto:

    json-response

    • Se asignaron dos campos desde dentro de la matriz geonames:

      geonames[*].geonameId → como número

      geonames[*].name → como una Cadena

      [*] significa que se repite en cada país de la matriz.

get-children

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab