{"id":16253468,"url":"https://github.com/lindseyb/tarot-api","last_synced_at":"2025-03-16T13:30:44.582Z","repository":{"id":49161963,"uuid":"375543345","full_name":"LindseyB/tarot-api","owner":"LindseyB","description":"A simple tarot API","archived":false,"fork":false,"pushed_at":"2025-03-10T22:45:05.000Z","size":21522,"stargazers_count":54,"open_issues_count":0,"forks_count":4,"subscribers_count":4,"default_branch":"main","last_synced_at":"2025-03-10T23:30:28.438Z","etag":null,"topics":["api","ruby","sinatra","tarot","tarot-cards","tarot-readings"],"latest_commit_sha":null,"homepage":"https://tarot-api.com","language":"Ruby","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/LindseyB.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"MIT-LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-06-10T02:15:13.000Z","updated_at":"2025-03-10T22:45:07.000Z","dependencies_parsed_at":"2024-02-29T23:25:06.990Z","dependency_job_id":"45f3c009-b9e5-43fd-ab5a-98ef00ce29f8","html_url":"https://github.com/LindseyB/tarot-api","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LindseyB%2Ftarot-api","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LindseyB%2Ftarot-api/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LindseyB%2Ftarot-api/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LindseyB%2Ftarot-api/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/LindseyB","download_url":"https://codeload.github.com/LindseyB/tarot-api/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243815564,"owners_count":20352189,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["api","ruby","sinatra","tarot","tarot-cards","tarot-readings"],"created_at":"2024-10-10T15:17:29.689Z","updated_at":"2025-03-16T13:30:43.223Z","avatar_url":"https://github.com/LindseyB.png","language":"Ruby","readme":"# Tarot Api\n\n## Requests\n\n`GET /` [[run]](https://tarot-api.com)\n\nReturns an array of every card\n\n`GET /cards` [[run]](https://tarot-api.com/cards)\n\nReturns an array of every card\n\n`GET /cards/[suit]/[rank]` [[run]](https://tarot-api.com/cards/swords/10)\n\n| argument | values                                                                      | required |\n|----------|-----------------------------------------------------------------------------|----------|\n| suit     | one of: swords, wands, cups, coins, or major                                | yes      |\n| rank     | one of: king, queen, 1-10 for swords/wands/cups/pentacles or 0-21 for major | yes      |\n\nReturns a single card in the form of\n\n| field                | type             | description                                                                                 |\n|----------------------|------------------|---------------------------------------------------------------------------------------------|\n| meanings             | hash             |                                                                                             |\n| meanings[\"upright\"]  | array of strings | meanings for this card in the upright position                                              |\n| meanings[\"reversed\"] | array of strings | meanings for this card in the reverse position                                              |\n| name                 | string           | the name of the card written out in words                                                   |\n| rank                 | string or int    | rank of the card in the suit up to 21 for major arcana, king through 10 for all other suits |\n| suit                 | string           | major, wands, cups, swords, or pentacles                                                    |\n| planet               | string           | planet associated with this card                                                            |\n| signs                | array of strings | astrological sign(s) associated with this card                                              |\n| element              | string           | element associated with this card                                                           |\n\n\n### Example\n\n`GET /cards/swords/10`\n\n\u003cdetails\u003e\n  \u003csummary\u003e\n    returns the following JSON\n  \u003c/summary\u003e\n\n  ```JSON\n   {\n      \"name\": \"Ten of Swords\",\n      \"rank\": 10,\n      \"suit\": \"swords\",\n      \"planet\": null,\n      \"element\": \"air\",\n      \"sign\": [\n         \"gemini\",\n         \"libra\",\n         \"aquarius\"\n      ],\n      \"meanings\": {\n         \"upright\": [\n            \"failure\",\n            \"defeat\",\n            \"deep wounds\",\n            \"loss\",\n            \"crisis\",\n            \"betrayal\"\n         ],\n         \"reversed\": [\n            \"recovery\",\n            \"rebirth\",\n            \"moving on\",\n            \"restoration\"\n         ]\n      }\n   }\n  ```\n\u003c/details\u003e\n\n`GET /draw/[n]` [[run]](https://tarot-api.com/draw/3)\n\nReturns n randomly selected cards\n\n| argument | values       | required |\n|----------|--------------|----------|\n| n        | positive int | yes      |\n\n`GET /find/[name]` [[run]](https://tarot-api.com/find/The%20Magician)\n\nReturns the card by the specified name. Note that the numbers will be spelled out\n\n| argument | values                                     | required |\n|----------|--------------------------------------------|----------|\n| name     | string name of the card (eg: The Magician) | yes      |\n\n\n`GET /suits` [[run]](https://tarot-api.com/suits)\n\nReturns an array of all the suits of the tarot with key information\n\n`GET /suits/[suit]/cards` [[run]](https://tarot-api.com/suits/cups/cards)\n\nReturns an array of all the cards in a given suit\n\n| argument | values                                     | required |\n|----------|--------------------------------------------|----------|\n| suit     | string name of the suit (eg: cups )        | yes      |\n\n\n`GET /suits/[suit]` [[run]](https://tarot-api.com/suits/cups)\n\n| argument | values                                     | required |\n|----------|--------------------------------------------|----------|\n| suit     | string name of the suit (eg: cups )        | yes      |\n\nReturns a single suit in the form of\n\n| field                | type             | description                                                                                 |\n|----------------------|------------------|---------------------------------------------------------------------------------------------|\n| name                 | string           | the name of the tarot suit                                                                  |\n| element              | string           | the element associated with this tarot suit                                                 |\n| direction            | string           | the cardinal direction associated with this tarot suit                                      |\n| season               | string           | the season associated with this tarot suit                                                  |\n| time                 | string           | the time of day associated with this tarot suit                                             |\n| signs                | array of strings | astrological signs associated with this suit                                                |\n| keywords             | array of strings | words associated with this suit                                                             |\n\n\n## Testing\n\n  ```bash\n  bundle exec rake test\n  ```\n\n## Getting Started\n\n  ```bash\n  bundle install\n  bundle exec rackup\n  ```\n\n## Deploying\n\n  ```bash\n  gcloud config set project tarot-api-316423 # set the correct project\n  gcloud app deploy                          # deploy the app\n  gcloud app logs tail -s default            # tail the logs to make sure things are gucci\n  ```\n\n  🍦\n\n## Thanks\n\n* Sinatra API template https://github.com/noplay/sinatra-api-template\n* Initial tarot corpus https://github.com/dariusk/corpora\n* Rider-Waite tarot images https://luciellaes.itch.io/rider-waite-smith-tarot-cards-cc0\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flindseyb%2Ftarot-api","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flindseyb%2Ftarot-api","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flindseyb%2Ftarot-api/lists"}