1
|
package eu.dnetlib.datasource.publisher;
|
2
|
|
3
|
import java.util.List;
|
4
|
|
5
|
import eu.dnetlib.datasource.publisher.model.BrowseTerm;
|
6
|
import eu.dnetlib.datasource.publisher.model.DatasourceResponse;
|
7
|
import eu.dnetlib.datasource.publisher.model.Response;
|
8
|
import eu.dnetlib.datasource.publisher.model.db.Api;
|
9
|
import eu.dnetlib.datasource.publisher.model.db.Datasource;
|
10
|
import eu.dnetlib.datasource.publisher.model.db.SearchInterfacesEntry;
|
11
|
import io.swagger.annotations.ApiOperation;
|
12
|
import io.swagger.annotations.ApiResponse;
|
13
|
import io.swagger.annotations.ApiResponses;
|
14
|
|
15
|
@io.swagger.annotations.Api(value = "datasources", description = "the datasource manager API")
|
16
|
public interface DatasourcesApi {
|
17
|
|
18
|
@ApiOperation(value = "list identifiers", notes = "List the Datasource identifiers.", response = List.class)
|
19
|
@ApiResponses(value = {
|
20
|
@ApiResponse(code = 200, message = "OK", response = String[].class),
|
21
|
@ApiResponse(code = 500, message = "unexpected error", response = Response.class) })
|
22
|
List<String> listIds(int page, int size) throws ApiException;
|
23
|
|
24
|
@ApiOperation(value = "get datasource by id", notes = "Returns Datasource details.", response = DatasourceResponse.class)
|
25
|
@ApiResponses(value = {
|
26
|
@ApiResponse(code = 200, message = "OK", response = DatasourceResponse[].class),
|
27
|
@ApiResponse(code = 500, message = "unexpected error", response = Response.class) })
|
28
|
DatasourceResponse getDs(String id);
|
29
|
|
30
|
@ApiOperation(value = "search datasources by name", notes = "Returns list of Datasource details.", response = DatasourceResponse[].class)
|
31
|
@ApiResponses(value = {
|
32
|
@ApiResponse(code = 200, message = "OK", response = DatasourceResponse[].class),
|
33
|
@ApiResponse(code = 500, message = "unexpected error", response = Response.class) })
|
34
|
List<DatasourceResponse> searchByName(String name, int page, int size);
|
35
|
|
36
|
@ApiOperation(value = "search datasources by contact email", notes = "Returns list of Datasource details.", response = DatasourceResponse[].class)
|
37
|
@ApiResponses(value = {
|
38
|
@ApiResponse(code = 200, message = "OK", response = DatasourceResponse[].class),
|
39
|
@ApiResponse(code = 500, message = "unexpected error", response = Response.class) })
|
40
|
List<DatasourceResponse> searchByContactemail(String contactemail, int page, int size);
|
41
|
|
42
|
@ApiOperation(value = "search datasources by country", notes = "Returns list of Datasource details.", response = DatasourceResponse[].class)
|
43
|
@ApiResponses(value = {
|
44
|
@ApiResponse(code = 200, message = "OK", response = DatasourceResponse[].class),
|
45
|
@ApiResponse(code = 500, message = "unexpected error", response = Response.class) })
|
46
|
List<DatasourceResponse> searchByCountry(String country, int page, int size);
|
47
|
|
48
|
@ApiOperation(value = "search among datasource APIs", notes = "Returns Datasource Api details.", response = SearchInterfacesEntry[].class)
|
49
|
@ApiResponses(value = {
|
50
|
@ApiResponse(code = 200, message = "OK", response = SearchInterfacesEntry[].class),
|
51
|
@ApiResponse(code = 500, message = "unexpected error", response = Response.class) })
|
52
|
List<SearchInterfacesEntry> searchInterface(String field, String value);
|
53
|
|
54
|
@ApiOperation(value = "terms and count for the given field", notes = "Returns the list of BrowseTerms.", response = BrowseTerm[].class)
|
55
|
@ApiResponses(value = {
|
56
|
@ApiResponse(code = 200, message = "OK", response = BrowseTerm[].class),
|
57
|
@ApiResponse(code = 500, message = "unexpected error", response = Response.class) })
|
58
|
List<? extends BrowseTerm> browseField(String field) throws ApiException;
|
59
|
|
60
|
@ApiOperation(value = "get the list of API for a given datasource", notes = "Returns the list of API for a given datasource.", httpMethod = "GET", response = Api[].class)
|
61
|
@ApiResponses(value = {
|
62
|
@ApiResponse(code = 200, message = "OK", response = Api[].class),
|
63
|
@ApiResponse(code = 500, message = "unexpected error", response = Response.class) })
|
64
|
List<Api> getApi(String dsId) throws ApiException;
|
65
|
|
66
|
@ApiOperation(value = "delete an API", notes = "delete an API", httpMethod = "DELETE")
|
67
|
@ApiResponses(value = {
|
68
|
@ApiResponse(code = 200, message = "OK"),
|
69
|
@ApiResponse(code = 500, message = "unexpected error") })
|
70
|
void deleteApi(String apiId) throws ApiException;
|
71
|
|
72
|
@ApiOperation(value = "adds an API to one Datasource", notes = "adds an API to one Datasource", httpMethod = "POST")
|
73
|
@ApiResponses(value = {
|
74
|
@ApiResponse(code = 200, message = "OK"),
|
75
|
@ApiResponse(code = 500, message = "unexpected error") })
|
76
|
void addApi(Api api) throws ApiException;
|
77
|
|
78
|
@ApiOperation(value = "set the managed status for a given datasource", notes = "set the managed status for a given datasource", httpMethod = "POST")
|
79
|
@ApiResponses(value = {
|
80
|
@ApiResponse(code = 200, message = "OK"),
|
81
|
@ApiResponse(code = 500, message = "unexpected error") })
|
82
|
void setManaged(String id, boolean managed);
|
83
|
|
84
|
@ApiOperation(value = "adds a new datasource", notes = "adds a new datasource", httpMethod = "POST")
|
85
|
@ApiResponses(value = {
|
86
|
@ApiResponse(code = 200, message = "OK"),
|
87
|
@ApiResponse(code = 500, message = "unexpected error") })
|
88
|
void saveDatasource(Datasource datasource) throws ApiException;
|
89
|
|
90
|
@ApiOperation(value = "updates a datasource official name", notes = "updates a datasource official name", httpMethod = "POST")
|
91
|
@ApiResponses(value = {
|
92
|
@ApiResponse(code = 200, message = "OK"),
|
93
|
@ApiResponse(code = 500, message = "unexpected error") })
|
94
|
void updateOfficialname(String dsId, String officialname) throws ApiException;
|
95
|
|
96
|
@ApiOperation(value = "updates a datasource english name", notes = "updates a datasource english name", httpMethod = "POST")
|
97
|
@ApiResponses(value = {
|
98
|
@ApiResponse(code = 200, message = "OK"),
|
99
|
@ApiResponse(code = 500, message = "unexpected error") })
|
100
|
void updateEnglishname(String dsId, String english) throws ApiException;
|
101
|
|
102
|
@ApiOperation(value = "updates a datasource latitude", notes = "updates a datasource latitude", httpMethod = "POST")
|
103
|
@ApiResponses(value = {
|
104
|
@ApiResponse(code = 200, message = "OK"),
|
105
|
@ApiResponse(code = 500, message = "unexpected error") })
|
106
|
void updateLatitude(String dsId, Double latitude) throws ApiException;
|
107
|
|
108
|
@ApiOperation(value = "updates a datasource longitude", notes = "updates a datasource longitude", httpMethod = "POST")
|
109
|
@ApiResponses(value = {
|
110
|
@ApiResponse(code = 200, message = "OK"),
|
111
|
@ApiResponse(code = 500, message = "unexpected error") })
|
112
|
void updateLongitude(String dsId, Double longitude) throws ApiException;
|
113
|
|
114
|
}
|