Postman 入门

postmant

Postman 是一款优秀的 API 开发环境。由于 Elasticsearch 通过 REST API 提供服务的,所以在测试和练习 Elasticsearch 开发时, Postman 是非常合适的工具。

postman view
Postman 页面布局

如果 Elasticsearch 设置了密码,需要点击 Authorization,认证方式 TYPE 选择 base Auth,设置用户名密码。

postman view
Postman 页面布局

点击发送请求,得到返回信息。

{
  "name": "MacBook-Pro.local",
  "cluster_name": "elasticsearch",
  "cluster_uuid": "zTr3Oy4XQqKfumywlDkBOA",
  "version": {
    "number": "7.7.1",
    "build_flavor": "default",
    "build_type": "tar",
    "build_hash": "ad56dce891c901a492bb1ee393f12dfff473a423",
    "build_date": "2020-05-28T16:30:01.040088Z",
    "build_snapshot": false,
    "lucene_version": "8.5.1",
    "minimum_wire_compatibility_version": "6.8.0",
    "minimum_index_compatibility_version": "6.0.0-beta1"
  },
  "tagline": "You Know, for Search"
}
插入数据
postman insert data
Postman 发送数据

请求方式设置 Put,请求地址设置 127.0.0.1:9200/locale/_doc/1,Headers 添加 Content-Type:application/json, body 选择 raw 格式,内容如下:

{
    "name": "东方明珠广播电视塔",
    "Description": "东方明珠广播电视塔,位于上海市浦东陆家嘴的未来主义建筑,与外滩隔黄浦江相望,原名上海广播电视塔,上海市民也常简称其为东方明珠。东方明珠由当时华东建筑设计研究院设计,1991年动工,1994年落成,总高468米。在1994年至2007年间,是中国大陆地区的最高建筑,2007年被上海环球金融中心超越。东方明珠自落成以后便成为上海天际线的组成部分之一,是上海的地标性建筑,同时也是中国国家5A级旅游景区。 ",
    "tags": [
        "东方明珠",
        "景点"
    ],
    "location": {
        "lat": 31.239886,
        "lon": 121.499673
    }
}

发送请求,得到返回信息:

{
    "_index": "locale",
    "_type": "_doc",
    "_id": "1",
    "_version": 1,
    "result": "created",
    "_shards": {
        "total": 2,
        "successful": 1,
        "failed": 0
    },
    "_seq_no": 0,
    "_primary_term": 1
}
查询数据
postman get data
Postman 查询数据

请求方式设置 get,请求地址设置 127.0.0.1:9200/locale/_doc/1,Headers 添加 Content-Type:application/json。发送请求,得到返回信息:

{
    "_index":"locale",
    "_type":"_doc",
    "_id":"1",
    "_version":1,
    "_seq_no":0,
    "_primary_term":1,
    "found":True,
    "_source":{
        "name":"东方明珠广播电视塔",
        "Description":"东方明珠广播电视塔,位于上海市浦东陆家嘴的未来主义建筑,与外滩隔黄浦江相望,原名上海广播电视塔,上海市民也常简称其为东方明珠。东方明珠由当时华东建筑设计研究院设计,1991年动工,1994年落成,总高468米。在1994年至2007年间,是中国大陆地区的最高建筑,2007年被上海环球金融中心超越。东方明珠自落成以后便成为上海天际线的组成部分之一,是上海的地标性建筑,同时也是中国国家5A级旅游景区。 ",
        "tags":[
            "东方明珠",
            "景点"
        ],
        "location":{
            "lat":31.239886,
            "lon":121.499673
        }
    }
}
搜索数据
postman search data
Postman 搜索数据

请求方式设置 get,请求地址设置 127.0.0.1:9200/locale/_search,headers 添加 Content-Type:application/json。发送请求,body 类型选择 raw,内容如下:

{
  "query": { "match_all": {} }
}

发送请求,得到返回信息:

{
    "took": 160,
    "timed_out": false,
    "_shards": {
        "total": 1,
        "successful": 1,
        "skipped": 0,
        "failed": 0
    },
    "hits": {
        "total": {
            "value": 1,
            "relation": "eq"
        },
        "max_score": 1.0,
        "hits": [
            {
                "_index": "locale",
                "_type": "_doc",
                "_id": "1",
                "_score": 1.0,
                "_source": {
                    "name": "东方明珠广播电视塔",
                    "Description": "东方明珠广播电视塔,位于上海市浦东陆家嘴的未来主义建筑,与外滩隔黄浦江相望,原名上海广播电视塔,上海市民也常简称其为东方明珠。东方明珠由当时华东建筑设计研究院设计,1991年动工,1994年落成,总高468米。在1994年至2007年间,是中国大陆地区的最高建筑,2007年被上海环球金融中心超越。东方明珠自落成以后便成为上海天际线的组成部分之一,是上海的地标性建筑,同时也是中国国家5A级旅游景区。 ",
                    "tags": [
                        "东方明珠",
                        "景点"
                    ],
                    "location": {
                        "lat": 31.239886,
                        "lon": 121.499673
                    }
                }
            }
        ]
    }
}