trevorblades/countries

🌎 Public GraphQL API for information about countries

Trevor Blades' website

Hello adventurer! This site is where I show off the work that I've done in the past and write posts about features that I've built in the past. It's built using Gatsby and React, and my posts are authored using MDX.

Please take a look around and check out some of the techniques I used to build the site. If you have any questions about the techniques used, hit me up on Twitter and ask away.

countries's Issues

Would it not be a better reflection of the dataset, if currency was an array?

413 Payload Too Large

Hi,

I've been working on a GraphQL project and testing it with the Countries API, https://countries.trevorblades.com/
Recently I started getting an error like this for queries of more than 3 or 4 levels deep:

  "message": "Query depth limit exceeded.",
  "extensions": {
    "code": "GCDN_QUERY_DEPTH_LIMIT",
    "httpStatusCode": 413
  }

I'm just wondering if this was an intentional change to the API, or a mistake - I can run a local instance of the API if needed.

400 Error, Cross Origin Access Safari Mac

[Error] Origin https://0.0.0.0:44 is not allowed by Access-Control-Allow-Origin. Status code: 400
[Error] Fetch API cannot load https://countries.trevorblades.com/graphql due to access control checks.

Issue with the 'name' Field in GraphQL Playground and the Need for README Update"

I am encountering an issue in GraphQL Playground despite the query being shown as an example in the README file. It seems like the name field has been removed from the filter parameters, so it may require an update to the README file. Below, I'm providing the error message along with the query:

GraphQL Query:

query ListCountriesThatBeginWithTheLetterA {
  countries(filter: { name: { regex: "^A" } }) {
    code
    name
    currency
  }
}

Error Message:

{
  "errors": [
    {
      "message": "Field \"name\" is not defined by type \"CountryFilterInput\".",
      "locations": [
        {
          "line": 2,
          "column": 22
        }
      ]
    }
  ]
}

the README.md link
the playground link

Cannot read properties of undefined (reading 'toString')

Query:
{ countries(filter: {code: {eq: "US"}}) { states { name value: code } } }

Response:
{ "errors": [ { "message": "Cannot read properties of undefined (reading 'toString')", "locations": [ { "line": 2, "column": 3 } ], "path": [ "countries" ], "extensions": { "code": "INTERNAL_SERVER_ERROR", "stacktrace": [ "TypeError: Cannot read properties of undefined (reading 'toString')", " at isVanillaObject (/var/task/netlify/functions/graphql/graphql.js:50619:107)", " at createQueryOperations (/var/task/netlify/functions/graphql/graphql.js:50864:14)", " at createQueryOperation (/var/task/netlify/functions/graphql/graphql.js:50850:18)", " at createDefaultQueryOperation (/var/task/netlify/functions/graphql/graphql.js:51293:16)", " at createDefaultQueryTester (/var/task/netlify/functions/graphql/graphql.js:51302:18)", " at resolve (/var/task/netlify/functions/graphql/graphql.js:58100:42)", " at field.resolve (/var/task/netlify/functions/graphql/graphql.js:54949:22)", " at executeField (/var/task/netlify/functions/graphql/graphql.js:8987:24)", " at executeFields (/var/task/netlify/functions/graphql/graphql.js:8962:24)", " at executeOperation (/var/task/netlify/functions/graphql/graphql.js:8933:18)" ] } } ], "data": null }

Query Returning null?

I'm trying to filter the countries by continent. i.e List the countries as per the continent. I am getting a null and it does'nt make much sense why its not working:

This is my query:

query { countries(filter: {continent: {eq: "Africa"}}){ name, capital } }

Add England, Scotland, Wales and Northern Ireland

Is it possible to add England, Scotland, Wales and Northern Ireland in the list of coutries?

Proposition: add static documentation

Hello! I am the maintainer of a documentation tool called Magidoc, a tool that generates static GraphQL API documentation references.

I would like to propose to integrate Magidoc into your great project to build a static API reference. This would allow users to easily get an overview of the whole API, but also other documentation that may be useful to use your API. You could even move all your examples or any other content you want there, since Magidoc supports Custom pages.

If you want to see an example, here is a link to a demo website.

I am also willing to help you integrate it if you want, and this could be hosted on any static content host: so can be GitHub pages, Netlify, Vercel, or anything else you want.

Let me know what you think about the idea, and feel free to close the issue if you're not interested.

Additonal functionalities

Hello, great api. I would like to ask if it is possible to add new functionalities such filtering countries by continent. It would be a great addition

Finish Render migration

Once the new Render DNS changes have propagated, make sure to remove the Heroku Procfile!

Surprising response data

Just some ideas for future improvements. See code with comments below.

---

Input A:

query CountryA {
  country(code: "NO") {
    languages {
      code
      name
      native
      rtl
    }
  }
}

Output A:

{
  "data": {
    "country": {
      "languages": [
         ...
        {
          "code": "nb",
          "name": null,    // missing data in data-source?
          "native": null,   // missing data in data-source?
          "rtl": false
        },
        ...
      ]
    }
  }
}

---

Input B:

query CountryB {
  country(code: "AQ") {
    capital
    currency
  }
}

Output B:

{
  "data": {
    "country": {
      "capital": "",   // should be nullable?
      "currency": ""  // should be nullable?
    }
  }
}

API is down

Website Down

The https://countries.trevorblades.com/ website isn't sending a response back. Just wanted to let you know since I was following a tutorial and needed it.

How to render the emojiU on react component?

How to render the country emojiU on react component?

Batching requests is not supported anymore

It was working in September when we developed the functionality for the gql Python client.

Could it be possible to bring that functionality back?

In the meantime, I'm disabling those tests on our side.

400 Bad Request for websockets endpoint

Hi,

I am the maintainer of the graphql-python/gql client and we make a great use of your countries website for our examples in our documentation. A big thanks for your website which provides a stable backend when we need to do some simple tests sometimes.

It has been brought to my attention recently that all the examples involving the websockets protocol are not working anymore (the http protocol continues to work fine).

Now we always receive a 400 Bad Request response when trying to connect to the websockets endpoint.

If I try to run the following code with gql version 3.1.0:

import asyncio                                                                                                          
import logging                                                                                                          
                                                                                                                        
from gql import Client, gql                                                                                             
from gql.transport.websockets import WebsocketsTransport                                                                
                                                                                                                        
logging.basicConfig(level=logging.DEBUG)                                                                                
                                                                                                                        
                                                                                                                        
async def main():                                                                                                       
                                                                                                                        
    transport = WebsocketsTransport(                                                                                    
        url="wss://countries.trevorblades.com/graphql",                                                                 
        subprotocols=[WebsocketsTransport.APOLLO_SUBPROTOCOL],                                                          
    )                                                                                                                   
                                                                                                                        
    async with Client(                                                                                                  
        transport=transport, fetch_schema_from_transport=True,                                                          
    ) as session:                                                                                                       
                                                                                                                        
        # Execute single query                                                                                          
        query = gql(                                                                                                    
            """                                                                                                         
            query getContinents {                                                                                       
              continents {                                                                                              
                code                                                                                                    
                name                                                                                                    
              }                                                                                                         
            }                                                                                                           
        """                                                                                                             
        )                                                                                                               
        result = await session.execute(query)                                                                           
        print(result)                                                                                                   
                                                                                                                        
                                                                                                                        
asyncio.run(main())

Then I receive the following result:

DEBUG:asyncio:Using selector: EpollSelector
DEBUG:gql.transport.websockets:connect: starting
DEBUG:websockets.client:= connection is CONNECTING
DEBUG:websockets.client:> GET /graphql HTTP/1.1
DEBUG:websockets.client:> Host: countries.trevorblades.com
DEBUG:websockets.client:> Upgrade: websocket
DEBUG:websockets.client:> Connection: Upgrade
DEBUG:websockets.client:> Sec-WebSocket-Key: ZK9W8vXCkiwnBMzyG0UnSA==
DEBUG:websockets.client:> Sec-WebSocket-Version: 13
DEBUG:websockets.client:> Sec-WebSocket-Extensions: permessage-deflate; client_max_window_bits
DEBUG:websockets.client:> Sec-WebSocket-Protocol: graphql-ws
DEBUG:websockets.client:> User-Agent: Python/3.8 websockets/10.2
DEBUG:websockets.client:< HTTP/1.1 400 Bad Request
DEBUG:websockets.client:< access-control-allow-origin: *
DEBUG:websockets.client:< content-type: text/html; charset=utf-8
DEBUG:websockets.client:< content-length: 18
DEBUG:websockets.client:< etag: W/"12-7JEJwpG8g89ii7CR/6hhfN27Q+k"
DEBUG:websockets.client:< date: Mon, 11 Apr 2022 19:33:55 GMT
DEBUG:websockets.client:< connection: keep-alive
DEBUG:websockets.client:< keep-alive: timeout=5
DEBUG:websockets.client:< server: Fly/523fc696 (2022-04-06)
DEBUG:websockets.client:< via: 1.1 fly.io
DEBUG:websockets.client:< fly-request-id: 01G0D1X9FAAFXFHY58RRYJ6WGX-fra
DEBUG:websockets.client:! failing connection with code 1006
DEBUG:websockets.client:x closing TCP connection
DEBUG:websockets.client:= connection is CLOSED
Traceback (most recent call last):
  File "docs/code_examples/websockets_async.py", line 36, in <module>
    asyncio.run(main())
  File "/home/leszek/miniconda3/envs/gql-dev/lib/python3.8/asyncio/runners.py", line 43, in run
    return loop.run_until_complete(main)
  File "/home/leszek/miniconda3/envs/gql-dev/lib/python3.8/asyncio/base_events.py", line 616, in run_until_complete
    return future.result()
  File "docs/code_examples/websockets_async.py", line 17, in main
    async with Client(
  File "/home/leszek/miniconda3/envs/gql-dev/lib/python3.8/site-packages/gql/client.py", line 580, in __aenter__
    await self.transport.connect()
  File "/home/leszek/miniconda3/envs/gql-dev/lib/python3.8/site-packages/gql/transport/websockets_base.py", line 491, in connect
    self.websocket = await asyncio.wait_for(
  File "/home/leszek/miniconda3/envs/gql-dev/lib/python3.8/asyncio/tasks.py", line 483, in wait_for
    return fut.result()
  File "/home/leszek/miniconda3/envs/gql-dev/lib/python3.8/asyncio/tasks.py", line 684, in _wrap_awaitable
    return (yield from awaitable.__await__())
  File "/home/leszek/miniconda3/envs/gql-dev/lib/python3.8/site-packages/websockets/legacy/client.py", line 650, in __await_impl_timeout__
    return await asyncio.wait_for(self.__await_impl__(), self.open_timeout)
  File "/home/leszek/miniconda3/envs/gql-dev/lib/python3.8/asyncio/tasks.py", line 483, in wait_for
    return fut.result()
  File "/home/leszek/miniconda3/envs/gql-dev/lib/python3.8/site-packages/websockets/legacy/client.py", line 658, in __await_impl__
    await protocol.handshake(
  File "/home/leszek/miniconda3/envs/gql-dev/lib/python3.8/site-packages/websockets/legacy/client.py", line 328, in handshake
    raise InvalidStatusCode(status_code, response_headers)
websockets.exceptions.InvalidStatusCode: server rejected WebSocket connection: HTTP 400

It has been a while that I tested this so this could have been the case for a long time already.

sadfadsffdsa

asdfadsljkadsflkj

Add a license

Hey man. I'm building a course on GraphQL and I'd love to use this as an example, but I need this repo to have a license in order to do that. Is this something you'd be willing to do?

Optional fields & arguments

Hi!
Is there a reason why all fields and arguments are optional?

I'm writing GraphQL example for Seed and it makes code unnecessary complex because we have to take into account all valid possibilities.

Thank you.