animethemes-api-docs/docs/graphql/guide/getting-started/index.md

title

title
Getting Started

Getting Started

---

The AnimeThemes API selectively implements the GraphQL Tool.

Here we will provide an overview of where the AnimeThemes API adheres to or deviates from the specification.

It is recommended that you learn how to wrap a GraphQL API.

Content Negotiation

The AnimeThemes API needs a Content-Type header.

# A simple curl request works like this.
curl -X POST
    -H "Content-Type: application/json"
    -d "{\"query\": \"{ animePaginator { data { name } } }\"}"
    https://graphql.animethemes.moe/

Document Structure

Top Level

The AnimeThemes API specifies a custom data wrap for top-level members that use pagination.

The following query

query {
    animePaginator {
        data {
            name
        }
    }
}

will return the JSON:

{
    "data": {
        "animePaginator": {
            "data": [
                {
                    "name": ".hack//Liminality"
                },
                ...
            ]
        }
    }
}

Singular Query

In case you want to return a single object, there are a few types that allow it. The following example returns the first anime with the slug hibike_euphonium.

query {
    anime(slug: "hibike_euphonium") {
        name
        slug
    }
}