MCPcopy Index your code
hub / github.com/arufars/api-blue-archive

github.com/arufars/api-blue-archive @main

Chat with this repo
repository ↗ · DeepWiki ↗ · + Follow
10 symbols 20 edges 12 files 0 documented · 0%
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

Blue Archive API

baseurl: https://api-blue-archive.vercel.app

Overview

This is an open source API providing character information about the Blue Archive.This information is sourced from the public, i do not claim to own it.

Technologies use

Nextjs, MongoDB, Mongoose, Vercel, Nextjscors, Typescript, Tailwindcss ( UI )

Route

All Route and Example results

Get all characters Blue Archive ( By default 20 )

endpoint : /api/characters

Payload Example

json { "_id": "634105b907843834fd29f006", "name": "Airi", "school": "Trinity", "birthday": "January 30", "photoUrl": "https://static.miraheze.org/bluearchivewiki/thumb/9/96/Airi.png/266px-Airi.png", "imageSchool": "https://static.miraheze.org/bluearchivewiki/thumb/9/9c/Trinity.png/50px-Trinity.png", "damageType": "Explosive" }

Get all characters pagination ( 20 )

endpoint : /api/characters?page=NUMBER&perPage=NUMBER

Payload Example

json { "_id": "6341063807843834fd29f0aa", "name": "Iori", "school": "Gehenna", "birthday": "November 8", "photoUrl": "https://static.miraheze.org/bluearchivewiki/thumb/2/26/Iori.png/266px-Iori.png", "imageSchool": "https://static.miraheze.org/bluearchivewiki/thumb/b/bd/Gehenna.png/50px-Gehenna.png", "damageType": "Penetration" }

Get characters with a specific name, choice Asuna, Hibiki

endpoint : /api/characters?name=Aru you can choose a query other than name, more

Payload Example

json { "_id": "634105c607843834fd29f01a", "name": "Aru", "school": "Gehenna", "birthday": "March 12", "photoUrl": "https://static.miraheze.org/bluearchivewiki/thumb/d/db/Aru.png/266px-Aru.png", "imageSchool": "https://static.miraheze.org/bluearchivewiki/thumb/b/bd/Gehenna.png/50px-Gehenna.png", "damageType": "Explosive" }

Get random character ( 1 )

endpoint : /api/character/random

You can use query count to get more than 1 character endpoint : /api/character/random?count=NUMBER

Payload Example

```json { "_id": "634106a407843834fd29f11a", "name": "Miyako", "names": { "firstName": "Miyako", "lastName": "Tsukiyuki", "japanName": " 月雪 ミヤコ", "_id": "634106a407843834fd29f11b" },

  "age": "15",
  "school": "SRT",
  "birthday": "January 7",
  "photoUrl": "https://static.miraheze.org/bluearchivewiki/thumb/3/3e/Miyako.png/266px-Miyako.png",
  "imageSchool": "https://static.miraheze.org/bluearchivewiki/thumb/5/5a/SRT.png/50px-SRT.png"
}

```

Get all students specific ( By default 4 )

endpoint : /api/characters/students

Payload Example

```json { "_id": "634105c207843834fd29f012", "name": "Ako", "names": { "firstName": "Ako", "lastName": "Amau", "japanName": " 天雨 アコ" }, "age": "17", "school": "Gehenna", "birthday": "December 22", "background": "A student of Gehenna Academy, Ako is the executive officer of the Disciplinary Committee, and a sort-of secretary to its president Hina. At first glance she may appear kind and good-natured, but Ako has zero tolerance for students who break the rules. She is constantly at Hina's side, assisting in her duties as president of the Disciplinary Committee. This has prompted other students to call her \"Hina's Pet\" amongst other things, but Ako doesn't particulary care.", "height": "165cm", "photoUrl": "https://static.miraheze.org/bluearchivewiki/thumb/7/72/Ako.png/266px-Ako.png", "imageSchool": "https://static.miraheze.org/bluearchivewiki/thumb/b/bd/Gehenna.png/50px-Gehenna.png", "hobbies": ["President Hina"], "voice": "Kouno Marika", "voices": "https://static.miraheze.org/bluearchivewiki/a/aa/Ako_Title.ogg", "role": ["Support/Back", "Support", "Back"], "damageType": "Mystic", "armorType": "Heavy", "affinity": [ { "urban": "https://static.miraheze.org/bluearchivewiki/thumb/1/13/Icon_location_city.png/24px-Icon_location_city.png", "urbanEmotion": "https://static.miraheze.org/bluearchivewiki/thumb/8/81/Icon_mood_d.png/20px-Icon_mood_d.png" },

  {
    "outdoors": "https://static.miraheze.org/bluearchivewiki/thumb/6/6d/Icon_location_outdoors.png/24px-Icon_location_outdoors.png",
    "outdoorsEmotion": "https://static.miraheze.org/bluearchivewiki/thumb/5/5f/Icon_mood_b.png/20px-Icon_mood_b.png"
  },

  {
    "indoors": "https://static.miraheze.org/bluearchivewiki/thumb/c/c1/Icon_location_indoors.png/24px-Icon_location_indoors.png",
    "indoorsEmotion": "https://static.miraheze.org/bluearchivewiki/thumb/e/e3/Icon_mood_s.png/20px-Icon_mood_s.png"
  }
],
"weapon": "HG",
"weaponUnique": "Hotshot",
"weaponImage": "https://static.miraheze.org/bluearchivewiki/6/6f/Weapon_Icon_20008.png",
"realeaseDate": "2021/11/17"

}

```

All Query

All keys can make requests from query

Query
name
names
age
birthday
heigth
school
hobbies
voice
damageType
role
armorType
affinity
weapon
realeaseDate

Error Handling

Ask for assistance from us if you need it or if something doesn't seem to be working right.

License

This project is licensed under the MIT License - see the LICENSE file for details

Acknowledgments

Extension points exported contracts — how you extend this code

IModel (Interface)
(no doc)
src/model/Character.ts
ICharacter (Interface)
(no doc)
src/model/Character.ts
ICharacterModel (Interface)
(no doc)
src/model/Character.ts

Core symbols most depended-on inside this repo

Seo
called by 0
src/components/Seo.tsx
Footer
called by 0
src/components/Footer.tsx
rateLimit
called by 0
src/utils/limit.ts
MyApp
called by 0
src/pages/_app.tsx
Home
called by 0
src/pages/index.tsx
dbConnect
called by 0
src/lib/dbConnect.ts
toJSON
called by 0
src/model/Character.ts

Shape

Function 6
Interface 3
Method 1

Languages

TypeScript100%

Modules by API surface

src/model/Character.ts4 symbols
src/utils/limit.ts1 symbols
src/pages/index.tsx1 symbols
src/pages/_app.tsx1 symbols
src/lib/dbConnect.ts1 symbols
src/components/Seo.tsx1 symbols
src/components/Footer.tsx1 symbols

Datastores touched

CharacterCollection · 1 repos
(mongodb)Database · 1 repos

For agents

$ claude mcp add api-blue-archive \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact