openapi: 3.0.3 info: title: 'Nameday API' description: '' version: 1.0.0 servers: - url: 'https://nameday.abalin.net' paths: /supported: get: summary: '' description: '' parameters: - in: header name: Content-Type description: '' example: application/json schema: type: string - in: header name: Accept description: '' example: application/json schema: type: string responses: 200: description: '' content: text/plain: schema: type: string example: "\r\n\r\n\r\n \r\n \r\n \r\n\r\n \r\n \r\n\r\n \r\n\r\n\r\n
\r\n
\r\n
\r\n

Any of these codes can be used and are currently supported

\r\n\r\n

\r\n Country, Country code or Alpha3 code can be used as parameters in your request\r\n

\r\n\r\n

\r\n \r\n

\r\n\r\n\r\n \r\n \r\n \r\n\r\n \r\n \r\n \r\n \r\n \r\n \r\n\r\n \r\n \r\n\r\n \r\n \r\n \r\n \r\n \r\n \r\n\r\n \r\n \r\n \r\n \r\n \r\n \r\n\r\n \r\n \r\n \r\n \r\n \r\n \r\n\r\n \r\n \r\n \r\n \r\n \r\n \r\n\r\n \r\n \r\n \r\n \r\n \r\n \r\n\r\n \r\n \r\n \r\n \r\n \r\n \r\n\r\n \r\n \r\n \r\n \r\n \r\n \r\n\r\n \r\n \r\n \r\n \r\n \r\n \r\n\r\n \r\n \r\n \r\n \r\n \r\n \r\n\r\n \r\n \r\n \r\n \r\n \r\n \r\n\r\n \r\n \r\n \r\n \r\n \r\n \r\n\r\n \r\n \r\n \r\n \r\n \r\n \r\n\r\n \r\n \r\n \r\n \r\n \r\n \r\n\r\n \r\n \r\n \r\n \r\n \r\n \r\n\r\n \r\n \r\n \r\n \r\n \r\n \r\n\r\n \r\n \r\n \r\n \r\n \r\n \r\n\r\n \r\n \r\n \r\n \r\n \r\n \r\n\r\n \r\n \r\n \r\n \r\n \r\n \r\n\r\n \r\n \r\n \r\n \r\n \r\n \r\n\r\n \r\n \r\n \r\n \r\n \r\n
CountryCountry codeAlpha3 code
Austriaataut
Czechiaczcze
Finlandfifin
Greecegrgrc
Latvialvlva
Russian Federationrurus
Swedenseswe
Bulgariabgbgr
Denmarkdkdnk
Francefrfra
Hungaryhuhun
Lithuanialtltu
Slovakiasksvk
United States of Americaususa
Croatiahrhrv
Estoniaeeest
Germanydedeu
Italyitita
Polandplpol
Spainesesp
\r\n\r\n\r\n
\r\n
\r\n
\r\n\r\n\r\n\r\n\r\n\r\n" tags: - Endpoints security: [] /today: post: summary: 'Get nameday for today' description: '[Retrieves nameday for today]' parameters: - in: header name: Content-Type description: '' example: application/json schema: type: string - in: header name: Accept description: '' example: application/json schema: type: string responses: 200: description: '200' content: application/json: schema: type: object example: status: Success data: { month: 4, day: 14, namedays: { at: 'Elmo, Erna, Ernestine' } } properties: status: { type: string, example: Success } data: { type: object, example: { month: 4, day: 14, namedays: { at: 'Elmo, Erna, Ernestine' } } } 404: description: '404' content: application/json: schema: type: object example: status: Error message: 'Invalid timezone europe/Londonn' properties: status: { type: string, example: Error } message: { type: string, example: 'Invalid timezone europe/Londonn' } tags: - 'Nameday Endpoints' requestBody: required: false content: application/json: schema: type: object properties: country: type: string description: 'Country code or country name.' example: hungary timezone: type: string description: 'Timezones supported by PHP' example: Pacific/Palau security: [] /tomorrow: post: summary: 'Get nameday for tomorrow' description: '[Retrieves nameday for tomorrow]' parameters: - in: header name: Content-Type description: '' example: application/json schema: type: string - in: header name: Accept description: '' example: application/json schema: type: string responses: 200: description: '200' content: application/json: schema: type: object example: status: Success data: { month: 4, day: 14, namedays: { at: 'Elmo, Erna, Ernestine' } } properties: status: { type: string, example: Success } data: { type: object, example: { month: 4, day: 14, namedays: { at: 'Elmo, Erna, Ernestine' } } } 404: description: '404' content: application/json: schema: type: object example: status: Error message: 'Invalid timezone europe/Londonn' properties: status: { type: string, example: Error } message: { type: string, example: 'Invalid timezone europe/Londonn' } tags: - 'Nameday Endpoints' requestBody: required: false content: application/json: schema: type: object properties: country: type: string description: 'Country code or country name.' example: hungary timezone: type: string description: 'Timezones supported by PHP' example: Pacific/Palau security: [] /yesterday: post: summary: 'Get nameday for yesterday' description: '[Retrieves nameday for yesterday]' parameters: - in: header name: Content-Type description: '' example: application/json schema: type: string - in: header name: Accept description: '' example: application/json schema: type: string responses: 200: description: '200' content: application/json: schema: type: object example: status: Success data: { month: 4, day: 14, namedays: { at: 'Elmo, Erna, Ernestine' } } properties: status: { type: string, example: Success } data: { type: object, example: { month: 4, day: 14, namedays: { at: 'Elmo, Erna, Ernestine' } } } 404: description: '404' content: application/json: schema: type: object example: status: Error message: 'Invalid timezone europe/Londonn' properties: status: { type: string, example: Error } message: { type: string, example: 'Invalid timezone europe/Londonn' } tags: - 'Nameday Endpoints' requestBody: required: false content: application/json: schema: type: object properties: country: type: string description: 'Country code or country name.' example: hungary timezone: type: string description: 'Timezones supported by PHP' example: Pacific/Palau security: [] /getdate: post: summary: 'Search nameday date by name' description: '[Retrieves date for given name and country]' parameters: - in: header name: Content-Type description: '' example: application/json schema: type: string - in: header name: Accept description: '' example: application/json schema: type: string responses: 200: description: '200' content: application/json: schema: type: object example: status: Success data: { resultCount: 0, namedays: [] } properties: status: { type: string, example: Success } data: { type: object, example: { resultCount: 0, namedays: [] } } 404: description: '404' content: application/json: schema: type: object example: status: Error message: 'Wrong country code, check documentation' properties: status: { type: string, example: Error } message: { type: string, example: 'Wrong country code, check documentation' } tags: - 'Nameday Endpoints' requestBody: required: true content: application/json: schema: type: object properties: name: type: string description: 'Name to search for' example: vojtech country: type: string description: 'Country code or country name.' example: sk required: - name - country security: [] /namedays: post: summary: 'Get name day for a specific day' description: '[Retrieves name day for specific day. Can be filtered by country]' parameters: - in: header name: Content-Type description: '' example: application/json schema: type: string - in: header name: Accept description: '' example: application/json schema: type: string responses: 200: description: '200' content: application/json: schema: type: object example: status: Success data: { date: 02/29, namedays: { se: n/a } } properties: status: { type: string, example: Success } data: { type: object, example: { date: 02/29, namedays: { se: n/a } } } 404: description: '404' content: application/json: schema: type: object example: status: Error message: 'Invalid date provided' properties: status: { type: string, example: Error } message: { type: string, example: 'Invalid date provided' } tags: - 'Nameday Endpoints' requestBody: required: true content: application/json: schema: type: object properties: country: type: string description: 'Country code or country name.' example: swe day: type: integer description: 'Day in month' example: 28 month: type: integer description: 'Month in year' example: 2 required: - country - day - month security: []