1 /*
2  *  Make.org Core API
3  *  Copyright (C) 2018 Make.org
4  *
5  * This program is free software: you can redistribute it and/or modify
6  *  it under the terms of the GNU Affero General Public License as
7  *  published by the Free Software Foundation, either version 3 of the
8  *  License, or (at your option) any later version.
9  *
10  *  This program is distributed in the hope that it will be useful,
11  *  but WITHOUT ANY WARRANTY; without even the implied warranty of
12  *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
13  *  GNU Affero General Public License for more details.
14  *
15  *  You should have received a copy of the GNU Affero General Public License
16  *  along with this program.  If not, see <https://www.gnu.org/licenses/>.
17  *
18  */
19 
20 package org.make.api.technical
21 
22 import akka.http.scaladsl.server.Directives
23 import com.github.swagger.akka.SwaggerHttpService
24 import com.github.swagger.akka.model.{Contact, Info}
25 import io.swagger.models.Scheme
26 import io.swagger.models.auth.{OAuth2Definition, SecuritySchemeDefinition}
27 
28 import scala.jdk.CollectionConverters._
29 import scalaoauth2.provider.OAuthGrantType
30 
31 class MakeDocumentation(override val apiClasses: Set[Class[_]], ssl: Boolean)
32     extends SwaggerHttpService
33     with Directives {
34 
35   override def info: Info = Info(
36     title = "Make.org API",
37     description = "The following definition represents the Make.org API.",
38     contact = Some(Contact(name = "Technical team", url = "https://make.org/FR/contact", email = "technique@make.org"))
39   )
40 
41   override def schemes: List[Scheme] =
42     if (ssl) {
43       List(Scheme.HTTPS)
44     } else {
45       List(Scheme.HTTP)
46     }
47 
48   override val securitySchemeDefinitions: Map[String, SecuritySchemeDefinition] = Map("MakeApi" -> {
49     val definition = new OAuth2Definition()
50     definition.setFlow(OAuthGrantType.IMPLICIT)
51     definition.setAuthorizationUrl("/oauth/authenticate")
52     definition.setType("oauth2")
53     definition.setScopes(Map("user" -> "application user", "admin" -> "application admin").asJava)
54     definition
55   })
56 
57 }