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=Aruyou can choose aqueryother thanname, 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/randomYou 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