--- swagger: "2.0" info: x-ibm-name: atmlocations title: ATM Locations version: 1.3.1 x-santander-atlas-id: ATMS_APIM_V01R04 x-santander-atlas-description: API de ATMS x-santander-api-status: SANDBOX_REAL description: "[EN CONSTRUCCION - Mock en PaaS y Selección de catalogo Sandbox en variable]\n***\n### Funcionalidad\n\nBusca cajeros a partir de unas coordenadas GPS y una distancia.\n\n- Dirección del cajero\n- Distancia hasta el cajero\n- Lista información adicional de los cajeros en caso de disponer de ella\n\n### Información adicional\n\n| | *ATMs API* | \n|---|---|\n| *Protocolo* | TSL 1.2 |\n| *Autenticación* | OAUTH2.0 Client Credentials. Más información [aquí](https://developers-sandbox.bancosantander.es/canales-digitales/sb/autenticacion) |\n| *Scopes* | atms.read |\n| *Acceso* | Gratis sin suscripción requerida |\n***\n\n### Funcionality\n\nFind ATM location from GPS coordinates and range.\n\n- Adress of ATM\n- Distance to ATM\n- List information about Santander Bank ATMs if available\n\n### Aditional information\n\n| | *ATMs API* | \n|---|---|\n| *Protocol* | TSL 1.2 |\n| *Authentication* | OAUTH2.0 Client Credentials. More information [here](https://developers-sandbox.bancosantander.es/canales-digitales/sb/autenticacion) |\n| *Scopes* | atms.read |\n| *Access* | Free without suscription required |\n***" contact: url: https://www.bancosantander.es email: atenclie@gruposantander.com name: Customer Support schemes: - https basePath: /atm consumes: - application/json produces: - application/json securityDefinitions: client_id: type: apiKey description: Sólo consumo por un client-id de aplicación suscrito a la API/Productod in: header name: X-IBM-Client-Id OAuth2_Client-Credentials: type: oauth2 description: Servidor Oauth Corporativo del Banco Santander flow: application scopes: atms.read: Permitir la lectura de info sobre geolocalización de cajeros tokenUrl: https://auth.sandbox.corp.bsch/sos/oauth/token paths: /locations: get: responses: 200: description: OK schema: $ref: '#/definitions/Atms' 400: description: Bad Request schema: $ref: '#/definitions/Error' 401: description: Unauthorized schema: $ref: '#/definitions/Error' 403: description: Forbidden schema: $ref: '#/definitions/Error' 404: description: Not Found schema: $ref: '#/definitions/Error' 500: description: Internal Server Error schema: $ref: '#/definitions/Error' description: "### Requisitos\n\nTodos los parámetros son obligatorios.\n\n| | *Tipo de parámetro* | *Descripción* | *Ejemplo* | \n|-----|-----|-----|-----|\n| *lat* | Query | Latitud | 40.4128625761 |\n| *lng* | Query | Longitud | -3.69997754518 |\n| *radius* | Query | Radio de búsqueda (Km) | 0.1 |\n| *Authorization* | Header | Token de autenticación válido para consumición de la API obtenido del servidor OAuth (uuid) | Bearer 620ef659-9eb4-483b-8daa-eb68a3270a71 |\n| *x-ibm-client-id* | Header | Client id de la aplicación que consume la api (uuid | 58af6ddc-eeb7-42fe-b9e3-64afdb3513fc |\n \n***\n### Requirements\n\nAll parameters are required.\n\n| | *Located in* | *Description* | *Example* | \n|-----|-----|-----|-----|\n| *lat* | Query | Latitude | 40.4128625761 |\n| *lng* | Query | Longitude | -3.69997754518 |\n| *radius* | Query | Search distance (Km) | 0.1 |\n| *Authorization* | Header | Valid authorization token header obtained from OAuth Server (uuid) | Bearer 620ef659-9eb4-483b-8daa-eb68a3270a71 |\n| *x-ibm-client-id* | Header | Application client-id (uuid) | 58af6ddc-eeb7-42fe-b9e3-64afdb3513fc |\n***" operationId: GET_atms parameters: - name: lat type: number required: true in: query description: Latitude format: double - name: lng type: number required: true in: query description: Longitude format: double - name: radius type: number required: true in: query description: Search distance in kilometers format: double - name: Authorization type: string required: true in: header description: Token de autenticación válido para consumición de la API obtenido del servidor OAuth - name: x-santander-client-id type: string required: true in: header description: Client id de la aplicación suscrita que consume la api summary: Devuelve un listado de cajeros dado un rango definido por los parámetros de entrada. x-santander-security: - OAuth2_Client-Credentials: - atms.read x-ibm-configuration: testable: true enforced: true phase: identified definitions: Atms: properties: atms: type: array items: properties: name: type: string description: name currentDistance: type: string description: currentDistance coordinates: type: object properties: lat: type: string description: lat long: type: string description: long description: coordinates location: type: object properties: address: type: string description: address zipCode: type: string description: zipCode city: type: string description: city description: location description: List of ATMs additionalProperties: false description: List of ATMs found for specific coordinates required: - atms ListAtms: type: array items: $ref: '#/definitions/Atm' description: List of ATMs Atm: properties: name: type: string example: cj0004 description: Name of the ATM currentDistance: type: string example: "0.18998718555555292" description: Current distance to the ATM coordinates: $ref: '#/definitions/Coordinates' description: Geological coordinates of the ATM location: $ref: '#/definitions/Location' description: Location details of the ATM additionalProperties: false description: Geografical details of a specific ATM Coordinates: properties: lat: type: string example: "42.4167146837" description: Geographic coordinate that specifies the vertical position on Earth's surface long: type: string example: "-1.70039853406" description: Geographic coordinate that specifies the horizontal position on Earth's surface additionalProperties: false description: Geographic coordinates specified as latitude and longitude Location: properties: address: type: string example: CALLE ALCALA, 24 description: Address at the geo-location zipCode: type: string example: "28014" description: Zip code at the geo-location city: type: string example: MADRID description: City at the geo-location additionalProperties: false description: Location details corresponding to the geographic coordinates. Error: title: ' ' type: object description: Information about an error that occurs during the API execution. properties: httpCode: type: string example: "401" description: HTTP Status of the error. httpMessage: type: string example: Invalid Authorization Credentials description: Error message that is sent moreInformation: type: string example: Unauthorized request. Bad authorization credentials description: More information related to the errors. security: - client_id: [] x-ibm-endpoints: - endpointUrl: https://apis-sandbox.bancosantander.es/canales-digitales/sb type: - production ...