Files
animethemes-api-docs/docs/graphql/guide/getting-started/index.md
T
Kyrch f129648c3e refactor: fix namespaces (#116)
(cherry picked from commit 578f00cdaf)
2025-07-29 00:52:47 +02:00

57 lines
1.0 KiB
Markdown

---
title: Getting Started
---
# Getting Started
---
The AnimeThemes API selectively implements the [**GraphQL Tool**](https://graphql.org).
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](https://graphql.org/learn/).
## Content Negotiation
The AnimeThemes API needs a `Content-Type` header.
```powershell
# A simple curl request works like this.
curl -X POST
-H "Content-Type: application/json"
-d "{\"query\": \"{ animes { data { name } } }\"}"
https://graphql.animethemes.moe/
```
## Document Structure
### Top Level
The AnimeThemes API specifies a custom `data` wrap for top-level members.
The following query
```graphql
query {
animes {
data {
name
}
}
}
```
will return the JSON:
```json
{
"data": {
"animes": {
"data": [
{
"name": ".hack//Liminality"
},
...
]
}
}
}
```