Web中的应用程序编程接口(API)是一组函数调用或其他编程指令，用于访问该特定Web应用程序中的软件组件。例如，Facebook API通过访问来自Facebook的数据或其他功能来帮助开发人员创建应用程序；它可以是出生日期或状态更新。
Elasticsearch提供了一个REST API，JSON可以通过HTTP访问该API。Elasticsearch使用一些约定，我们现在将对其进行讨论。
API中的大多数操作，主要是搜索和其他操作，都是针对一个或多个索引的。这有助于用户只需执行一次查询，就可以在多个位置或所有可用数据中进行搜索。许多不同的符号用于在多个索引中执行操作。我们将在本章中讨论其中的一些。
POST /index1,index2,index3/_search
{
"query":{
"query_string":{
"query":"any_string"
}
}
}来自index1, index2, index3的JSON对象中包含any_string。
POST /_all/_search
{
"query":{
"query_string":{
"query":"any_string"
}
}
}来自所有索引的JSON对象，其中包含any_string。
POST /school*/_search
{
"query":{
"query_string":{
"query":"CBSE"
}
}
}来自所有索引的JSON对象，这些索引始于其中包含CBSE的学校。
另外，您也可以使用以下代码-
POST /school*,-schools_gov /_search
{
"query":{
"query_string":{
"query":"CBSE"
}
}
}JSON对象来自所有以“ school”开头的索引，但不是来自school_gov并包含CBSE的索引。
还有一些URL查询字符串参数-
ignore_unavailable−如果index(es)URL中不存在一个或多个，则不会发生错误或将停止任何操作。例如，school索引存在，但book_shops不存在。
POST /school*,book_shops/_search
{
"query":{
"query_string":{
"query":"CBSE"
}
}
}{
"error":{
"root_cause":[{
"type":"index_not_found_exception", "reason":"no such index",
"resource.type":"index_or_alias", "resource.id":"book_shops",
"index":"book_shops"
}],
"type":"index_not_found_exception", "reason":"no such index",
"resource.type":"index_or_alias", "resource.id":"book_shops",
"index":"book_shops"
},"status":404
}考虑以下代码-
POST /school*,book_shops/_search?ignore_unavailable = true
{
"query":{
"query_string":{
"query":"CBSE"
}
}
}来自所有索引的JSON对象，这些索引始于其中包含CBSE的学校。
true如果带有通配符的URL没有索引，则此参数的值将防止错误。例如，没有以schools_pri开头的索引-
POST /schools_pri*/_search?allow_no_indices = true
{
"query":{
"match_all":{}
}
}{
"took":1,"timed_out": false, "_shards":{"total":0, "successful":0, "failed":0},
"hits":{"total":0, "max_score":0.0, "hits":[]}
}此参数决定通配符是否需要扩展为开放索引或封闭索引，或同时执行这两者。此参数的值可以是打开和关闭的，也可以是没有。
例如，封闭索引学校-
POST /schools/_close
{"acknowledged":true}考虑以下代码-
POST /school*/_search?expand_wildcards = closed
{
"query":{
"match_all":{}
}
}{
"error":{
"root_cause":[{
"type":"index_closed_exception", "reason":"closed", "index":"schools"
}],
"type":"index_closed_exception", "reason":"closed", "index":"schools"
}, "status":403
}Elasticsearch提供了根据日期和时间搜索索引的功能。我们需要以特定格式指定日期和时间。例如，accountdetail-2015.12.30，索引将存储2015年12月30日的银行帐户详细信息。可以执行数学运算以获取特定日期或日期和时间范围的详细信息。
日期数学索引名称的格式-
<static_name{date_math_expr{date_format|time_zone}}>
/<accountdetail-{now-2d{YYYY.MM.dd|utc}}>/_searchstatic_name是表达式的一部分，在每个日期的数学索引（如客户明细）中都保持不变。date_math_expr包含数学表达式，该数学表达式像now-2d一样动态确定日期和时间。date_format包含将日期写入诸如YYYY.MM.dd之类的索引中的格式。如果今天是2015年12月30日，则<accountdetail- {now-2d {YYYY.MM.dd}}>将返回accountdetail-2015.12.28。
| 表达 | 解析为 |
|---|---|
| <accountdetail-{now-d}> | accountdetail-2015.12.29 |
| <accountdetail-{now-M}> | accountdetail-2015.11.30 |
| <accountdetail-{now{YYYY.MM}}> | accountdetail-2015.12 |
现在，我们将看到Elasticsearch中提供的一些常用选项，这些选项可用于获取指定格式的响应。
我们可以通过添加URL查询参数（即pretty = true）来在格式良好的JSON对象中获得响应。
POST /schools/_search?pretty = true
{
"query":{
"match_all":{}
}
}……………………..
{
"_index" : "schools", "_type" : "school", "_id" : "1", "_score" : 1.0,
"_source":{
"name":"Central School", "description":"CBSE Affiliation",
"street":"Nagan", "city":"paprola", "state":"HP", "zip":"176115",
"location": [31.8955385, 76.8380405], "fees":2000,
"tags":["Senior Secondary", "beautiful campus"], "rating":"3.5"
}
}
………………….此选项可以将统计响应更改为人类可读形式（如果human = true）或计算机可读形式（如果human = false）。例如，如果human = true，则distance_kilometer = 20KM；如果human = false，则distance_meter = 20000，此时需要其他计算机程序使用响应。
通过将它们添加到field_path参数中，我们可以过滤对较少字段的响应。例如，
POST /schools/_search?filter_path = hits.total
{
"query":{
"match_all":{}
}
}{"hits":{"total":3}}