Characters

Route that provides information about the characters

Data Structure

Here is how the structure is sent in the users' data return

dataCharacter

Making character requests

Random Character

GET https://api.strangerthings.tech/v1/characters/random

Send a random character

Query Parameters

Name	Type	Description
language	String	LanguageOptions

Headers

Name	Type	Description
language	String	LanguageOptions

200: OK Submitted Character

{
  "id": Number,
  "character": {
    "biographicalInformation": {
      "name": String,
      "story": String,
      "otherNames": Array,
      "nicknames": Array,
      "birthDate": String,
      "demise": String,
      "hobbies": {
        "name": "description"
      },
      "currentAge": Number,
      "ageInSeasons": {
        "t1": Number,
        "t2": Number,
        "t3": Number,
        "t4": Number
      },
      "currentResidence": String,
      "otherResidences": Array,
      "relatives": Array,

      "otherRelationship": Array,
      "relationshipStatus": String,
      "occupations": Array,
      "status": String,
      "skills": {
        "name": "description"
      },
      'curiosities': Array,
    },
    "physicalInformation": {
      "species": String,
      "genre": String,
      "height": Number,
      "weight": Number,
      "eyeColor": String,
      "hairColor": String,
    },
    "Interpretation": {
      "representedBy": String,
      "apparitions": Array,
      "socialNetworks": {
        "name": "link"
      },
      "awards": Array,
      "patrimony": Number,
      "wage": Number,
      "nationality": String,
      "birthDate": String,
      "occupations": String,
    },
  },
}

Character by ID

GET https://api.strangerthings.tech/v1/characters/id/:id

Search for a character by the requested id

Query Parameters

Name	Type	Description
language	String	LanguageOptions

Headers

Name	Type	Description
language	String	LanguageOptions

200: OK Submitted Character

{
  "id": Number,
  "character": {
    "biographicalInformation": {
      "name": String,
      "story": String,
      "otherNames": Array,
      "nicknames": Array,
      "birthDate": String,
      "demise": String,
      "hobbies": {
        "name": "description"
      },
      "currentAge": Number,
      "ageInSeasons": {
        "t1": Number,
        "t2": Number,
        "t3": Number,
        "t4": Number
      },
      "currentResidence": String,
      "otherResidences": Array,
      "relatives": Array,

      "otherRelationship": Array,
      "relationshipStatus": String,
      "occupations": Array,
      "status": String,
      "skills": {
        "name": "description"
      },
      'curiosities': Array,
    },
    "physicalInformation": {
      "species": String,
      "genre": String,
      "height": Number,
      "weight": Number,
      "eyeColor": String,
      "hairColor": String,
    },
    "Interpretation": {
      "representedBy": String,
      "apparitions": Array,
      "socialNetworks": {
        "name": "link"
      },
      "awards": Array,
      "patrimony": Number,
      "wage": Number,
      "nationality": String,
      "birthDate": String,
      "occupations": String,
    },
  },
}

404: Not Found Character not found

Character by name

GET https://api.strangerthings.tech/v1/characters/name/:name

Search for a character by the requested name

Query Parameters

Name	Type	Description
language	String	LanguageOptions

Headers

Name	Type	Description
language	String	LanguageOptions

200: OK Submitted Character

{
  "id": Number,
  "character": {
    "biographicalInformation": {
      "name": String,
      "story": String,
      "otherNames": Array,
      "nicknames": Array,
      "birthDate": String,
      "demise": String,
      "hobbies": {
        "name": "description"
      },
      "currentAge": Number,
      "ageInSeasons": {
        "t1": Number,
        "t2": Number,
        "t3": Number,
        "t4": Number
      },
      "currentResidence": String,
      "otherResidences": Array,
      "relatives": Array,

      "otherRelationship": Array,
      "relationshipStatus": String,
      "occupations": Array,
      "status": String,
      "skills": {
        "name": "description"
      },
      'curiosities': Array,
    },
    "physicalInformation": {
      "species": String,
      "genre": String,
      "height": Number,
      "weight": Number,
      "eyeColor": String,
      "hairColor": String,
    },
    "Interpretation": {
      "representedBy": String,
      "apparitions": Array,
      "socialNetworks": {
        "name": "link"
      },
      "awards": Array,
      "patrimony": Number,
      "wage": Number,
      "nationality": String,
      "birthDate": String,
      "occupations": String,
    },
  },
}

404: Not Found Character not found

404: Not Found Similar character

Character List

GET https://api.strangerthings.tech/v1/characters/list

Returns a list of ids and names of available characters

200: OK List sent

{
	"characters": [
		{
			"id": 1,
			"name": "Character Name"
		},
		{
			"id": 2,
			"name": "Character Name"
		}
	]
}

Character data list

GET https://api.strangerthings.tech/v1/characters/

Returns a list of characters starting with a specific id

Query Parameters

Name	Type	Description
language	String	LanguageOptions
start*	Number	Inicio da lista
max	Number	min: 1, max: 10

Headers

Name	Type	Description
language	String	LanguageOptions

200: OK Character list sent

{
	"characters": [
		{
			"id": 1,
			"character": dataCharacter
		},
				{
			"id": 2,
			"character": dataCharacter
		}
		       ]
		
}		

400: Bad Request Invalid query parameters

400: Bad Request Character list and less than start

This method may return an error if the start parameter is greater than the list of available characters, see the Available Characters tab or use the getList method.