├── LICENSE └── README.md /LICENSE: -------------------------------------------------------------------------------- 1 | MIT License 2 | 3 | Copyright (c) 2018 Amadeus for Developers 4 | 5 | Permission is hereby granted, free of charge, to any person obtaining a copy 6 | of this software and associated documentation files (the "Software"), to deal 7 | in the Software without restriction, including without limitation the rights 8 | to use, copy, modify, merge, publish, distribute, sublicense, and/or sell 9 | copies of the Software, and to permit persons to whom the Software is 10 | furnished to do so, subject to the following conditions: 11 | 12 | The above copyright notice and this permission notice shall be included in all 13 | copies or substantial portions of the Software. 14 | 15 | THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR 16 | IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, 17 | FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE 18 | AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER 19 | LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, 20 | OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE 21 | SOFTWARE. 22 | -------------------------------------------------------------------------------- /README.md: -------------------------------------------------------------------------------- 1 | # Hackathon Starter 2 | 3 | Have you been in a hackathon in the past? Time flies! We have prepared this quick reference document for you to get familiar with our APIs. 4 | 5 | Happy Hacking! 6 | 7 | # Table of Contents 8 | 9 | - [Getting Started](#getting-started) 10 | - [APIs](#apis) 11 | - [SDKs](#sdks) 12 | - [Cheat sheet](#cheat-sheet) 13 | - [Guides](#tutorials-and-guides) 14 | - [Postman](#postman) 15 | - [Examples](#examples) 16 | - [Data Collection](#data-collection) 17 | - [FAQ](#faq) 18 | - [Contributing](#contributing) 19 | 20 | 21 | ## Getting Started 22 | 23 | First of all, you need to create an account: 24 | 25 | 1. Go to [our portal](https://developers.amadeus.com) and click on [register](https://developers.amadeus.com/create-account). 26 | 2. Fill in the form using a valid email address and click on the `Create account` button. A confirmation email will be sent to the email address you have just registered. 27 | 3. Open your mail and click on `Activate your account`. 28 | 29 | What's next? Our [get started guide](https://developers.amadeus.com/get-started/get-started-with-self-service-apis-335) contains detailed information about how to get your API key and make your first API call. 30 | 31 | The APIs use [OAuth2](https://en.wikipedia.org/wiki/OAuth) as authentication mechanism. The [authorization guide](https://amadeus4dev.github.io/developer-guides/API-Keys/authorization/) provides deep technical information on how to get a token in order to perform API calls. 32 | 33 | ## APIs 34 | 35 | | Category 36 | | ----------------------------------------------- 37 | | [Flights](https://developers.amadeus.com/self-service/category/flights) 38 | | [Destination Experiences](https://developers.amadeus.com/self-service/category/destination-experiences) 39 | | [Cars and Transfers](https://developers.amadeus.com/self-service/category/cars-and-transfers) 40 | | [Market insights](https://developers.amadeus.com/self-service/category/market-insights) 41 | | [Hotels](https://developers.amadeus.com/self-service/category/hotels) 42 | | [Itinerary management](https://developers.amadeus.com/self-service/category/itinerary-management) 43 | 44 | ## SDKs 45 | 46 | Because there is life beyond `curl`. 47 | 48 | - [Python](https://github.com/amadeus4dev/amadeus-python) 49 | - [Java](https://github.com/amadeus4dev/amadeus-java) 50 | - [Node](https://github.com/amadeus4dev/amadeus-node) 51 | 52 | ## Cheat sheet 53 | 54 | We normally bring some printed copies to the hackathons, but for your convenience check out the [web version](https://possible-quilt-2ff.notion.site/Cheat-sheet-e059caf4fcd342b78705f9f3d6f88f1d). 55 | 56 | Let's save the planet! 57 | 58 | ## Tutorials and guides 59 | 60 | In the [Developer Guides](https://amadeus4dev.github.io/developer-guides/examples/prototypes/) you can find tutorials to help you make the most of our APIs. 61 | 62 | You can also find a list of [blog articles](https://developers.amadeus.com/blog/category/tutorials?page=1&count=5) and [videos](https://www.youtube.com/channel/UCwI48vMwtiE-hra2RAtk1PQ) to help you build travel apps with several Amadeus APIs and technologies. 63 | 64 | ## Postman 65 | 66 | If you love [Postman](https://www.getpostman.com/) as we do, you'll be glad to see [our public Postman workspace](https://www.postman.com/amadeus4dev/workspace/amadeus-for-developers-s-public-workspace/collection/2672636-27471449-d2ca-a8c4-1399-6b0cfbddd079). 67 | 68 | New to Postman? Don't miss the [How to play with Self-Service APIs with no code](https://developers.amadeus.com/blog/how-to-play-with-self-service-apis-with-no-code-using-postman) article in our blog. 69 | 70 | ## Examples 71 | 72 | Explore all the self-contained [code examples](https://amadeus4dev.github.io/developer-guides/examples/code-example/) as well as [prototypes](https://amadeus4dev.github.io/developer-guides/examples/prototypes/). 73 | 74 | ## Data collection 75 | 76 | During the hackathon you'll use the `Test environment`, which means that our APIs are using cached data. You can find which data is available on the [data collection](http://github.com/amadeus4dev/data-collection) repository. 77 | 78 | ## FAQ 79 | 80 | * **When I go to the portal I see two API catalogs: Self-Service and Enterprise. Which one should I use during the Hackathon?** 81 | 82 | Amadeus for Developers includes two different offers: Self-Service and 83 | Enterprise, each meeting different customer needs. During the Hackathon you 84 | will use [Self-Service APIs](https://developers.amadeus.com/self-service/) as 85 | Enterprise is tailored to companies with scale needs and leading brands in the 86 | travel industry. 87 | 88 | * **When I create an *application* on the portal I see two environments: Test and Production. What's that?** 89 | 90 | The Test environment is the default environment for all new applications. This 91 | is where you will enjoy a fixed free number of free API call quota per month. 92 | When you reach the limit, you will receive an error message. No worries because 93 | you have enough calls for the Hackathon! 94 | 95 | Once you feel that your application is ready to be deployed to the Real World™, 96 | you will want to move it to the Production environment. There is no need to move to 97 | production in a Hackathon unless you are willing to pay! 98 | 99 | ## Contributing 100 | 101 | If something is wrong, confusing or you miss information, please let us know. Send your `pull request` or create an `issue` in the repository. 102 | --------------------------------------------------------------------------------