mirror of
https://github.com/AnimeThemes/animethemes-api-docs.git
synced 2026-07-11 01:34:06 +02:00
f129648c3e
(cherry picked from commit 578f00cdaf)
57 lines
1.0 KiB
Markdown
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"
|
|
},
|
|
...
|
|
]
|
|
}
|
|
}
|
|
}
|
|
``` |