Home A - Z
Page Index

An Otter Wiki

Blame

2726bb DonovanDMC 2026-01-16 22:09:42
1 
# Error Codes
2
3
> [!TIP]
2955b4 DonovanDMC 2026-01-16 22:24:39
4
> Lines in red are no longer in use. There are currently no plans to repurpose unused codes.
2726bb DonovanDMC 2026-01-16 22:09:42
5
6
<hr>
7
8
## Global
9
> [!NOTE]
10
> The codes below can be returned by any route.<br>
11
> The following codes are reserved for general use: 0-10, 1000-1022, 1024-1029
12
2955b4 DonovanDMC 2026-01-16 22:24:39
13
| Error Code | Status Code | Description |
14
|:-------------------------------------:|:-------------------------------------:|:-----------------------------------------------------------------------------------------------:|
15
| 0 | 500 | Internal Error[^1] <a id="global-internal-error"/> |
16
| 1 | 403 | Access Denied[^1] <a id="global-access-denied"/> |
17
| 2 | 503 | Readonly <a id="global-readonly"/> |
18
| 1000 | 429 | Ratelimited (Route) <a id="global-ratelimited-route"/> |
19
| 1001 | 429 | Ratelimited (Global) <a id="global-ratelimited-global"/> |
20
| 1002 | 403 | IP Blocked<a id="global-ip-blocked"/> |
21
| <span style="color: red;">1003</span> | <span style="color: red;">None</span> | <span style="color: red;">Down For Maintenance</span>[^2] <a id="global-down-for-maintenance"/> |
22
| 1010 | 401 | Invalid API Key <a id="global-invalid-api-key"/> |
23
| 1011 | 401 | Inactive API Key <a id="global-inactive-api-key"/> |
24
| 1012 | 403 | Disabled API Key <a id="global-disabled-api-key"/> |
25
| 1013 | 401 | API Key Required <a id="global-api-key-required"/> |
26
| <span style="color: red;">1014</span> | <span style="color: red;">None</span> | <span style="color: red;">Anonymous Restricted</span> <a id="global-anonymous-restricted"/> |
27
| <span style="color: red;">1020</span> | <span style="color: red;">None</span> | <span style="color: red;">Disk Full</span> <a id="global-disk-full"/> |
28
| <span style="color: red;">1021</span> | <span style="color: red;">None</span> | <span style="color: red;">Blocked User Agent</span> <a id="global-blocked-user-agent"/> |
29
| 1022 | 403 | Service No Access <a id="global-service-no-access"/> |
30
| <span style="color: red;">1024</span> | <span style="color: red;">None</span> | <span style="color: red;">Unknown Route</span>[^3] <a id="global-unknown-route"/> |
31
| <span style="color: red;">1025</span> | <span style="color: red;">None</span> | <span style="color: red;">Method Not Allowed</span>[^3] <a id="global-method-not-allowed"/> |
32
| 1026 | 404 | Not Found <a id="global-not-found"/> |
33
34
[^1]: Currently not used anywhere, but may be used in the future.
35
[^2]: Merged into <a href="#global-readonly">Readonly</a>.
36
[^3]: Handled by framework.
2726bb DonovanDMC 2026-01-16 22:09:42
37
38
<hr>
39
40
> [!NOTE]
41
> The codes below can only be returned in the [[Images|YiffyAPI/Images]] service.<br>
42
> The following codes are reserved for this service: 1023, 1030-1059
43
2955b4 DonovanDMC 2026-01-16 22:24:39
44
| Error Code | Status Code | Description |
45
|:-------------------------------------:|:-------------------------------------:|:---------------------------------------------------------------------------------------------:|
46
| <span style="color: red;">1023</span> | <span style="color: red;">None</span> | <span style="color: red;">Invalid Response Type</span> <a id="images-invalid-response-type"/> |
47
| <span style="color: red;">1030</span> | <span style="color: red;">None</span> | <span style="color: red;">Category Not Found</span>[^5] <a id="images-category-not-found"/> |
48
| <span style="color: red;">1031</span> | <span style="color: red;">None</span> | <span style="color: red;">Empty Category</span>[^4] <a id="images-empty-category"/> |
49
| <span style="color: red;">1040</span> | <span style="color: red;">404</span> | <span style="color: red;">Not Found</span>[^5] <a id="images-not-found"/> |
50
| 1041 | 400 | No Results <a id="images-no-results"/> |
51
| 1051 | 400 | Amount <1 <a id="images-amount-lt1"/> |
52
| 1052 | 400 | Amount >5 <a id="images-amount-gt5"/> |
53
| 1053 | 404 | Image Response Disabled <a id="images-image-response-disabled"/> |
54
| 1054 | 400 | [Bulk] Invalid Body <a id="images-bulk-invalid-body"/> |
55
| 1055 | 400 | [Bulk] Invalid Category <a id="images-bulk-invalid-category"/> |
56
| 1056 | 400 | [Bulk] Too Many Images <a id="images-bulk-too-many-images"/> |
57
| <span style="color: red;">1057</span> | <span style="color: red;">None</span> | <span style="color: red;">SFW Only API Key</span> <a id="images-sfw-only-api-key"/> |
58
59
[^4]: Replaced with <a href="#images-no-results">No Results</a>
60
[^5]: Replaced with <a href="#global-not-found">Global Not Found</a>
2726bb DonovanDMC 2026-01-16 22:09:42
61
62
<hr>
63
64
> [!NOTE]
65
> The codes below can only be returned in the [[Thumbnails|YiffyAPI/Thumbnails]] service.<br>
66
> The following codes are reserved for this service: 1060-1069
67
2955b4 DonovanDMC 2026-01-16 22:24:39
68
| Error Code | Status Code | Description |
69
|:-------------------------------------:|:-------------------------------------:|:-------------------------------------------------------------------------------------------:|
70
| 1060 | 500 | Generic Error <a id="thumbnails-generic-error"/> |
71
| <span style="color: red;">1061</span> | <span style="color: red;">None</span> | <span style="color: red;">API Key Required</span>[^6] <a id="thumbnails-api-key-required"/> |
72
| 1062 | 404 | Invalid Post <a id="thumbnails-invalid-post"/> |
73
| <span style="color: red;">1063</span> | <span style="color: red;">None</span> | <span style="color: red;">Invalid MD5</span>[^7] <a id="thumbnails-invalid-md5"/> |
74
| 1064 | 404 | Invalid Type <a id="thumbnails-invalid-type"/> |
75
| 1065 | 500 | Timeout <a id="thumbnails-timeout"/> |
76
| <span style="color: red;">1066</span> | <span style="color: red;">404</span> | <span style="color: red;">Check Not Found</span>[^5] <a id="thumbnails-check-not-found"/> |
77
| 1067 | 400 | GIF Disabled <a id="thumbnails-gif-disabled"/> |
78
| 1068 | 400 | Post Deleted <a id="thumbnails-post-deleted"/> |
79
80
[^6]: Replaced with <a href="#global-api-key-required">Global API Key Required</a>
81
[^7]: Merged into <a href="#thumbnails-invalid-post">Invalid Post</a>
2726bb DonovanDMC 2026-01-16 22:09:42
82
83
<hr>
84
85
> [!NOTE]
86
> The codes below can only be returned in the [[Shortener|YiffyAPI/Shortener]] service.<br>
87
> The following codes are reserved for this service: 1070-1089
88
2955b4 DonovanDMC 2026-01-16 22:24:39
89
| Error Code | Status Code | Description |
90
|:-------------------------------------:|:-------------------------------------:|:------------------------------------------------------------------------------:|
91
| 1070 | 422 | Code Too Long <a id="shortener-code-too-long"/> |
92
| 1071 | 422 | Invalid Code <a id="shortener-invalid-code"/> |
93
| 1072 | 409 | Code In Use <a id="shortener-code-in-use"/> |
94
| 1073 | 422 | Invalid URL <a id="shortener-invalid-url"/> |
95
| 1074 | 422 | Credit Too Long <a id="shortener-credit-too-long"/> |
96
| <span style="color: red;">1075</span> | <span style="color: red;">404</span> | <span style="color: red;">Not Found</span>[^5] <a id="shortener-not-found"/> |
97
| 1076 | 401 | Management Code Required <a id="shortener-management-code-required"/> |
98
| 1077 | 403 | No Management Code <a id="shortener-no-management-code"/> |
99
| 1078 | 401 | Management Code Mismatch <a id="shortener-management-code-mismatch"/> |
100
| <span style="color: red;">1079</span> | <span style="color: red;">None</span> | <span style="color: red;">URL In Use</span>[^8] <a id="shortener-url-in-use"/> |
101
| 1080 | 400 | No Changes <a id="shortener-no-changes"/> |
102
| 1081 | 422 | URL Too Long <a id="shortener-url-too-long"/> |
2726bb DonovanDMC 2026-01-16 22:09:42
103
104
[^8]: URLs are no longer unique