1	<?php
2	/**
3	* This program is free software: you can redistribute it and/or modify
4	* it under the terms of the GNU General Public License as published by
5	* the Free Software Foundation, either version 3 of the License, or
6	* (at your option) any later version.
7	*
8	* This program is distributed in the hope that it will be useful,
9	* but WITHOUT ANY WARRANTY; without even the implied warranty of
10	* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
11	* GNU General Public License for more details.
12	*
13	* You should have received a copy of the GNU General Public License
14	* along with this program.  If not, see <http://www.gnu.org/licenses/>.
15	*/
16
17	namespace ORES;
18
19	use RuntimeException;
20
21	/**
22	* Service interface for retrieving score data from API.
23	*
24	* @license GPL-3.0-or-later
25	*/
26	interface ServiceScoreLookup {
27
28	/**
29	* Method to retrieve scores of given revision and models
30	*
31	* @param int|int[] $revisions Single or multiple revision IDs
32	* @param string|string[]|null $models Single or multiple model names. If
33	* left empty, all configured models are queried.
34	* @param bool $precache either the request is made for precaching or not
35	*
36	* @return array Results in the form returned by ORES API
37	* @throws RuntimeException
38	*/
39	public function getScores( $revisions, $models = null, $precache = false );
40
41	}