feat: document api contract

tests/fixtures/funtranslations_shakespeare_pikachu.json

@@ -0,0 +1,8 @@
+{
+  "success": { "total": 1 },
+  "contents": {
+    "translated": "Electric cheeks, prithee.",
+    "text": "Electric cheeks.",
+    "translation": "shakespeare"
+  }
+}

tests/fixtures/funtranslations_yoda_mewtwo.json

@@ -0,0 +1,8 @@
+{
+  "success": { "total": 1 },
+  "contents": {
+    "translated": "Created by science, it was.",
+    "text": "Created by science.",
+    "translation": "yoda"
+  }
+}

tests/fixtures/pokeapi_mewtwo_species.json

@@ -0,0 +1,11 @@
+{
+  "name": "mewtwo",
+  "is_legendary": true,
+  "habitat": { "name": "rare" },
+  "flavor_text_entries": [
+    {
+      "flavor_text": "It was created by a scientist after years of horrific gene splicing and DNA engineering experiments.",
+      "language": { "name": "en" }
+    }
+  ]
+}

tests/fixtures/pokeapi_pikachu_species.json

@@ -0,0 +1,11 @@
+{
+  "name": "pikachu",
+  "is_legendary": false,
+  "habitat": { "name": "forest" },
+  "flavor_text_entries": [
+    {
+      "flavor_text": "Electric cheeks.",
+      "language": { "name": "en" }
+    }
+  ]
+}