REST 数据源
最后更新于
最后更新于
REST是构建API最常用的风格。REST API无处不在。您自己的应用程序很可能依赖它。
使用飞布，你可以将OpenAPI规范指定的任何REST API转换为GraphQL API。通过这种方式，您可以像对待其他GraphQL API一样对待它，甚至可以将它与其他API拼接在一起。
新建数据源 -> REST API，设置参数，如名称、OAS文件和rest端点。一般OAS文件中共包含rest端点信息，系统自动解析OAS并填写rest端点默认值。
OAS（全称OpenAPI Specification），旧称Swagger Specification，是一个开放式、跨语言、跨平台的API描述语言，用于定义RESTful API的接口，包括请求、响应、模型、错误代码等内容。它提供了一种标准化的方法来描述API，可以使API设计和实现更加明确和一致，提高API的可读性和可维护性。
简单来说，OAS是一个强类型的函数定义，里面包含了API接口的所有元数据描述。
飞布引擎能够将其解析为GraphQL Schema（子图），并以名称作为命名空间，合并到“超图”中。
当配置基于http的数据源(如GraphQL或OpenAPI)时，你可以配置飞布服务器是否以及如何将头发送到源。
有两种模式来区分，静态和动态。使用静态模式，可以设置静态标头，如API密钥或令牌。动态标头允许您根据客户端请求设置标头。
上图也是一个如何配置静态头文件的例子。
值：字面量
环境变量：读取环境变量
针对该REST数据源，飞布将始终发送X-API-KEY:xxxx请求头。由于该信息存储在服务器上，因此是一种与受保护数据源进行通讯的安全方式。
某些场景，REST数据源的授权头会过期失效，需要动态生成授权信息。针对该用例有两种解决方案：
动态头（转发自客户端）：客户端设置请求头，经过飞布服务端，透传到上游数据源
授权钩子：在钩子中编写脚本的方式，动态生成授权头，透传至上游数据源，见 数据源前置钩子
下面是一个动态头示例：
第一个参数是要添加的头的名称。第二个参数是要从客户端请求中获取值的头的名称。使用此配置，我们将发送带有客户端请求的Authorization头的值的报头X-Authorization。
\
