Solo pasarela de API de DataPower

Mecanismos de solicitud soportados por puntos finales de GraphQL

API Connect da soporte a diversos mecanismos para enviar solicitudes a puntos finales de API de proxy de GraphQL .

Puede utilizar cualquiera de los mecanismos siguientes para enviar solicitudes a los puntos finales /graphql y /graphql/cost en una API de proxy de GraphQL:

  • GET: la consulta de GraphQL se debe especificar en un parámetro de consulta de URL denominado query.
    Por ejemplo:
    https://hostname/basepath/graphql?query={accounts(limit:100){name{first,last}}}
    El ejemplo siguiente incluye las propiedades variables y operationName, con codificación de URL:
    https://hostname/basepath/graphql?query=query%20fetchAccounts%20($limit:%20Int)%20{accounts(limit:%20$limit)%20{name{first,last}}}&variables={"limit":100}&operationName=fetchAccounts
  • POST con un cuerpo codificado en JSON: la cabecera Content-Type debe establecerse en application/json y la consulta GraphQL se debe enviar en la clave query del objeto JSON.
    Por ejemplo:
    {
      "query": "query fetchAccounts ($limit: Int) {accounts(limit: $limit) {name{first,last}}}",
      "variables": {"limit": 100},
      "operationName": "fetchAccounts"
    }

    Las variables y operationName son opcionales. Para obtener más información, consulta la sección sobre solicitudes POST en la documentación de GraphQL, disponible en https://graphql.org/..

  • POST con contenido de graphql: la cabecera Content-Type debe establecerse en application/graphql; todo el cuerpo de POST se trata como la consulta de GraphQL
Nota: Para una solicitud enviada al punto final /graphql , la API de proxy GraphQL siempre envía la solicitud al servidor GraphQL de fondo como un POST con un cuerpo codificado en JSON, por lo que el servidor GraphQL de fondo debe soportar este mecanismo de lo contrario la llamada falla.