1
0
mirror of https://github.com/invoiceninja/invoiceninja.git synced 2024-09-22 01:11:34 +02:00
invoiceninja/app/Http/Controllers/OpenAPI/Parameters.php

103 lines
2.7 KiB
PHP
Raw Normal View History

2019-10-06 08:05:46 +02:00
<?php
2023-02-10 10:21:10 +01:00
2020-10-10 14:07:52 +02:00
/**
2019-10-06 08:05:46 +02:00
* @OA\Parameter(
2023-02-10 10:21:10 +01:00
* name="X-API-SECRET",
2019-10-06 08:05:46 +02:00
* in="header",
2023-02-10 10:21:10 +01:00
* description="The API secret as defined by the .env variable API_SECRET, only needed for self hosted users, and only required on the login route if the .env parameter has been set.",
* required=false,
2019-10-06 08:05:46 +02:00
* @OA\Schema(
* type="string",
* example="password"
* )
* ),
*
* @OA\Parameter(
* name="X-Requested-With",
* in="header",
* description="Used to send the XMLHttpRequest header",
* required=true,
* @OA\Schema(
* type="string",
* example="XMLHttpRequest",
* readOnly=true
* )
* ),
*
* @OA\Parameter(
2023-02-10 10:21:10 +01:00
* name="X-API-TOKEN",
2019-10-06 08:05:46 +02:00
* in="header",
* description="The API token to be used for authentication",
* required=true,
* @OA\Schema(
* type="string",
2023-02-10 10:21:10 +01:00
* example="TOKEN"
2019-10-06 08:05:46 +02:00
* )
* ),
* @OA\Parameter(
2023-02-10 10:21:10 +01:00
* name="X-API-PASSWORD",
* in="header",
2023-02-10 10:21:10 +01:00
* description="The login password when challenged on certain protected routes",
* required=false,
* @OA\Schema(
* type="string",
* example="supersecretpassword"
* )
* ),
2019-10-06 08:05:46 +02:00
*
* @OA\Parameter(
* name="include",
* in="query",
2023-02-10 10:21:10 +01:00
* description="Includes child relationships in the response, format is comma separated. Check each model for the list of associated includes",
* required=false,
2019-10-06 08:05:46 +02:00
* @OA\Schema(
* type="string",
2023-02-10 10:21:10 +01:00
* example=""
2019-10-06 08:05:46 +02:00
* )
* ),
*
* @OA\Parameter(
* name="include_static",
* in="query",
* description="Returns static variables",
2023-02-10 10:21:10 +01:00
* required=false,
2019-10-06 08:05:46 +02:00
* @OA\Schema(
* type="string",
2023-02-10 10:21:10 +01:00
* example="include_static=true",
2019-10-06 08:05:46 +02:00
* )
* ),
*
2019-10-06 08:05:46 +02:00
* @OA\Parameter(
* name="clear_cache",
* in="query",
* description="Clears the static cache",
2023-02-10 10:21:10 +01:00
* required=false,
2019-10-06 08:05:46 +02:00
* @OA\Schema(
* type="string",
* example="clear_cache=true"
* )
* ),
*
* @OA\Parameter(
* name="index",
* in="query",
* description="Replaces the default response index from data to a user specific string",
2023-02-10 10:21:10 +01:00
* required=false,
2019-10-06 08:05:46 +02:00
* @OA\Schema(
* type="string",
* example="user"
* )
* ),
*
2019-10-06 08:05:46 +02:00
* @OA\Parameter(
2020-07-30 05:27:00 +02:00
* name="api_version",
2019-10-06 08:05:46 +02:00
* in="query",
* description="The API version",
2023-02-10 10:21:10 +01:00
* required=false,
2019-10-06 08:05:46 +02:00
* @OA\Schema(
* type="number",
* example="user"
* )
* ),
*/