Сейчас онлайн  

/v1/medal/

Manages All Medal and User Permission Related Functions
GET

/v1/medal/get_available_medal_categories

#
Searches all available medal categories on the platform

Параметры

ИмяТипОбязательноПо умолчаниюОписание
searchFilter string Нет "" filter criteria
restrictToSponsorableByUserAlias string Нет "" if set, only medals that can be sponsored by this userAlias will be returned
filterBy string Нет "Slug" comma seperated list of fields that should be included
pageSize int Нет 50 Defines how many results will be return per request
pageNumber int Нет 0 Defines which page should be returned
Пример запроса (cURL)
curl --get \
  'https://ru.appointmenttrader.com/v1/medal/get_available_medal_categories' \
  --data-urlencode 'key={{API_KEY}}' \
  --data-urlencode 'searchFilter={{searchFilter}}' \
  --data-urlencode 'restrictToSponsorableByUserAlias={{restrictToSponsorableByUserAlias}}' \
  --data-urlencode 'filterBy={{filterBy}}' \
  --data-urlencode 'pageSize={{pageSize}}' \
  --data-urlencode 'pageNumber={{pageNumber}}'

Возвращает

JSON
See the shared response schema and synthetic example.
Поля ответа
ПолеТипОбязательноОписание
$medal_get_available_medal_categories_Response Да
$.oneOf[0] Да
$.oneOf[0].allOf[0]object Да
$.oneOf[0].allOf[0].RequestUserAliasstring Да
$.oneOf[0].allOf[0].RequestPathstring | null Да
$.oneOf[0].allOf[0].RequestStatus = "Succeeded" Да
$.oneOf[0].allOf[0].ResponseCodeinteger Да
$.oneOf[0].allOf[0].ResponseMessageAPIResponseMessage Да
$.oneOf[0].allOf[0].ResponseMessage.oneOf[0]string | number | boolean | null Да
$.oneOf[0].allOf[0].ResponseMessage.oneOf[1]array Да
$.oneOf[0].allOf[0].ResponseMessage.oneOf[1][]APIResponseMessage Нет
$.oneOf[0].allOf[0].ResponseMessage.oneOf[2]object Да
$.oneOf[0].allOf[0].ResponseMessage.oneOf[2].*APIResponseMessage Нет
$.oneOf[0].allOf[0].RequestImpersonatedByUserAliasstring Нет
$.oneOf[0].allOf[1]object Да
$.oneOf[0].allOf[1].Payloadobject Да
$.oneOf[0].allOf[1].Payload.ATResponseObjectType = "NestedKeyValueList" Да
$.oneOf[0].allOf[1].Payload.ResponseBodyobject Да
$.oneOf[0].allOf[1].Payload.ResponseBody.Namestring Да
$.oneOf[0].allOf[1].Payload.ResponseBody.MetaInformationarray Да
$.oneOf[0].allOf[1].Payload.ResponseBody.MetaInformation[]string Нет
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueListarray Да
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList[]object Нет
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList[].medalCategorySlugstring Да
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList[].medalCategoryNamestring Да
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList[].medalCategoryDescription Да
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList[].medalCategoryDescription.anyOf[0]string Да
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList[].medalCategoryDescription.anyOf[1]null Да
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList[].medalCategoryIconURL Да
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList[].medalCategoryIconURL.anyOf[0]string Да
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList[].medalCategoryIconURL.anyOf[1]null Да
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList[].medalCategoryColor Да
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList[].medalCategoryColor.anyOf[0]string Да
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList[].medalCategoryColor.anyOf[1]null Да
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList[].medalCategoryTextColor Да
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList[].medalCategoryTextColor.anyOf[0]string Да
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList[].medalCategoryTextColor.anyOf[1]null Да
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList[].IsNegativeMedalDatabaseInteger ДаInteger value; legacy MySQL reads may serialize it as a numeric string.
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList[].IsNegativeMedal.oneOf[0]integer Да
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList[].IsNegativeMedal.oneOf[1]string Да
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList[].DisplayOnDirectListingsDatabaseInteger ДаInteger value; legacy MySQL reads may serialize it as a numeric string.
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList[].DisplayOnDirectListings.oneOf[0]integer Да
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueList[].DisplayOnDirectListings.oneOf[1]string Да
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueFieldListarray Да
$.oneOf[0].allOf[1].Payload.ResponseBody.KeyValueFieldList[]string Нет
$.oneOf[1]object Да
$.oneOf[1].RequestUserAliasstring Да
$.oneOf[1].RequestPathstring | null Да
$.oneOf[1].RequestStatus = "Failed" Да
$.oneOf[1].ResponseCodeinteger Да
$.oneOf[1].ResponseMessageAPIResponseMessage Да
$.oneOf[1].ResponseMessage.oneOf[0]string | number | boolean | null Да
$.oneOf[1].ResponseMessage.oneOf[1]array Да
$.oneOf[1].ResponseMessage.oneOf[1][]APIResponseMessage Нет
$.oneOf[1].ResponseMessage.oneOf[2]object Да
$.oneOf[1].ResponseMessage.oneOf[2].*APIResponseMessage Нет
$.oneOf[1].RequestImpersonatedByUserAliasstring Нет
Пример ответа
{
    "RequestStatus": "Succeeded",
    "ResponseCode": 100,
    "ResponseMessage": "Synthetic success example.",
    "RequestPath": "/v1/medal/get_available_medal_categories",
    "RequestUserAlias": "example-user",
    "Payload": {
        "ATResponseObjectType": "NestedKeyValueList",
        "ResponseBody": {
            "Name": "synthetic-example",
            "MetaInformation": [],
            "KeyValueList": [],
            "KeyValueFieldList": []
        }
    }
}
Машиночитаемая документация метода
GET

/v1/medal/get_profile_sponsorships

#
Returns the viewed user's current medal sponsor and directly sponsored users, with public identities only. Public-by-design: approved sponsorships are visible only when the caller can view both related profiles.

Параметры

ИмяТипОбязательноПо умолчаниюОписание
userAlias string Да — Profile owner to inspect.
medalCategorySlug string Да — Medal category, not a tier slug.
afterUserID int Нет 0 Cursor from nextAfterUserID; zero starts the list.
pageSize int Нет 20 Number of visible sponsored users, from 1 to 50.
Пример запроса (cURL)
curl --get \
  'https://ru.appointmenttrader.com/v1/medal/get_profile_sponsorships' \
  --data-urlencode 'key={{API_KEY}}' \
  --data-urlencode 'userAlias={{userAlias}}' \
  --data-urlencode 'medalCategorySlug={{medalCategorySlug}}' \
  --data-urlencode 'afterUserID={{afterUserID}}' \
  --data-urlencode 'pageSize={{pageSize}}'

Возвращает

JSON
See the shared response schema and synthetic example.
Поля ответа
ПолеТипОбязательноОписание
$medal_get_profile_sponsorships_Response Да
$.oneOf[0] Да
$.oneOf[0].allOf[0]object Да
$.oneOf[0].allOf[0].RequestUserAliasstring Да
$.oneOf[0].allOf[0].RequestPathstring | null Да
$.oneOf[0].allOf[0].RequestStatus = "Succeeded" Да
$.oneOf[0].allOf[0].ResponseCodeinteger Да
$.oneOf[0].allOf[0].ResponseMessageAPIResponseMessage Да
$.oneOf[0].allOf[0].ResponseMessage.oneOf[0]string | number | boolean | null Да
$.oneOf[0].allOf[0].ResponseMessage.oneOf[1]array Да
$.oneOf[0].allOf[0].ResponseMessage.oneOf[1][]APIResponseMessage Нет
$.oneOf[0].allOf[0].ResponseMessage.oneOf[2]object Да
$.oneOf[0].allOf[0].ResponseMessage.oneOf[2].*APIResponseMessage Нет
$.oneOf[0].allOf[0].RequestImpersonatedByUserAliasstring Нет
$.oneOf[0].allOf[1]object Да
$.oneOf[0].allOf[1].Payloadobject Да
$.oneOf[0].allOf[1].Payload.profileAliasstring Да
$.oneOf[0].allOf[1].Payload.medalCategorySlugstring Да
$.oneOf[0].allOf[1].Payload.sponsor Да
$.oneOf[0].allOf[1].Payload.sponsor.anyOf[0]object Да
$.oneOf[0].allOf[1].Payload.sponsor.anyOf[0].userIDinteger Да
$.oneOf[0].allOf[1].Payload.sponsor.anyOf[0].aliasstring Да
$.oneOf[0].allOf[1].Payload.sponsor.anyOf[0].avatarstring Да
$.oneOf[0].allOf[1].Payload.sponsor.anyOf[0].imageURLstring Да
$.oneOf[0].allOf[1].Payload.sponsor.anyOf[0].profileURLstring Да
$.oneOf[0].allOf[1].Payload.sponsor.anyOf[0].displayHTMLstring Да
$.oneOf[0].allOf[1].Payload.sponsor.anyOf[1]null Да
$.oneOf[0].allOf[1].Payload.sponsoredUsersarray Да
$.oneOf[0].allOf[1].Payload.sponsoredUsers[]object Нет
$.oneOf[0].allOf[1].Payload.sponsoredUsers[].userIDinteger Да
$.oneOf[0].allOf[1].Payload.sponsoredUsers[].aliasstring Да
$.oneOf[0].allOf[1].Payload.sponsoredUsers[].avatarstring Да
$.oneOf[0].allOf[1].Payload.sponsoredUsers[].imageURLstring Да
$.oneOf[0].allOf[1].Payload.sponsoredUsers[].profileURLstring Да
$.oneOf[0].allOf[1].Payload.sponsoredUsers[].displayHTMLstring Да
$.oneOf[0].allOf[1].Payload.hasMoreboolean Да
$.oneOf[0].allOf[1].Payload.nextAfterUserID Да
$.oneOf[0].allOf[1].Payload.nextAfterUserID.anyOf[0]integer Да
$.oneOf[0].allOf[1].Payload.nextAfterUserID.anyOf[1]null Да
$.oneOf[1]object Да
$.oneOf[1].RequestUserAliasstring Да
$.oneOf[1].RequestPathstring | null Да
$.oneOf[1].RequestStatus = "Failed" Да
$.oneOf[1].ResponseCodeinteger Да
$.oneOf[1].ResponseMessageAPIResponseMessage Да
$.oneOf[1].ResponseMessage.oneOf[0]string | number | boolean | null Да
$.oneOf[1].ResponseMessage.oneOf[1]array Да
$.oneOf[1].ResponseMessage.oneOf[1][]APIResponseMessage Нет
$.oneOf[1].ResponseMessage.oneOf[2]object Да
$.oneOf[1].ResponseMessage.oneOf[2].*APIResponseMessage Нет
$.oneOf[1].RequestImpersonatedByUserAliasstring Нет
Пример ответа
{
    "RequestStatus": "Succeeded",
    "ResponseCode": 100,
    "ResponseMessage": "Synthetic success example.",
    "RequestPath": "/v1/medal/get_profile_sponsorships",
    "RequestUserAlias": "example-user",
    "Payload": {
        "profileAlias": "synthetic-example",
        "medalCategorySlug": "synthetic-example",
        "sponsor": {
            "userID": 0,
            "alias": "synthetic-example",
            "avatar": "synthetic-example",
            "imageURL": "synthetic-example",
            "profileURL": "synthetic-example",
            "displayHTML": "synthetic-example"
        },
        "sponsoredUsers": [],
        "hasMore": false,
        "nextAfterUserID": 0
    }
}
Машиночитаемая документация метода
POST

/v1/medal/set_request_medal_sponsorship

#
Request Medal Sponsorship will be asked to sponsor the medal defined below for you.

Параметры

ИмяТипОбязательноПо умолчаниюОписание
sponsorUserAlias string Да — Alias Identifying the User to be sponsored
medalCategorySlug string Да — Slug Identifying the Medal Category You Want to be Sponsored for
isWritingRequest bool Нет false all set_[...] functions have this parameter - if false (which is default) the method will execute without writing any data. Set this parameter to true once you are sure that you tested your logic and want to execute a writing request
Пример запроса (cURL)
curl --request POST \
  'https://ru.appointmenttrader.com/v1/medal/set_request_medal_sponsorship' \
  --data-urlencode 'key={{API_KEY}}' \
  --data-urlencode 'sponsorUserAlias={{sponsorUserAlias}}' \
  --data-urlencode 'medalCategorySlug={{medalCategorySlug}}' \
  --data-urlencode 'isWritingRequest={{isWritingRequest}}'

Возвращает

JSON
See the shared response schema and synthetic example.
Поля ответа
ПолеТипОбязательноОписание
$medal_set_request_medal_sponsorship_Response Да
$.oneOf[0] Да
$.oneOf[0].allOf[0]object Да
$.oneOf[0].allOf[0].RequestUserAliasstring Да
$.oneOf[0].allOf[0].RequestPathstring | null Да
$.oneOf[0].allOf[0].RequestStatus = "Succeeded" Да
$.oneOf[0].allOf[0].ResponseCodeinteger Да
$.oneOf[0].allOf[0].ResponseMessageAPIResponseMessage Да
$.oneOf[0].allOf[0].ResponseMessage.oneOf[0]string | number | boolean | null Да
$.oneOf[0].allOf[0].ResponseMessage.oneOf[1]array Да
$.oneOf[0].allOf[0].ResponseMessage.oneOf[1][]APIResponseMessage Нет
$.oneOf[0].allOf[0].ResponseMessage.oneOf[2]object Да
$.oneOf[0].allOf[0].ResponseMessage.oneOf[2].*APIResponseMessage Нет
$.oneOf[0].allOf[0].RequestImpersonatedByUserAliasstring Нет
$.oneOf[0].allOf[1]object Да
$.oneOf[0].allOf[1].Payload = true Да
$.oneOf[0].allOf[1].ResponseMessageobject Нет
$.oneOf[0].allOf[1].ResponseMessage.HumanReadablestring Да
$.oneOf[0].allOf[1].ResponseMessage.ReturnVariablesobject Да
$.oneOf[0].allOf[1].ResponseMessage.ReturnVariables.RequestChatIDDatabaseInteger ДаInteger value; legacy MySQL reads may serialize it as a numeric string.
$.oneOf[0].allOf[1].ResponseMessage.ReturnVariables.RequestChatID.oneOf[0]integer Да
$.oneOf[0].allOf[1].ResponseMessage.ReturnVariables.RequestChatID.oneOf[1]string Да
$.oneOf[0].allOf[1].ResponseMessage.ReturnVariables.RequestChatURLstring Да
$.oneOf[1]object Да
$.oneOf[1].RequestUserAliasstring Да
$.oneOf[1].RequestPathstring | null Да
$.oneOf[1].RequestStatus = "Failed" Да
$.oneOf[1].ResponseCodeinteger Да
$.oneOf[1].ResponseMessageAPIResponseMessage Да
$.oneOf[1].ResponseMessage.oneOf[0]string | number | boolean | null Да
$.oneOf[1].ResponseMessage.oneOf[1]array Да
$.oneOf[1].ResponseMessage.oneOf[1][]APIResponseMessage Нет
$.oneOf[1].ResponseMessage.oneOf[2]object Да
$.oneOf[1].ResponseMessage.oneOf[2].*APIResponseMessage Нет
$.oneOf[1].RequestImpersonatedByUserAliasstring Нет
Пример ответа
{
    "RequestStatus": "Succeeded",
    "ResponseCode": 100,
    "ResponseMessage": {
        "HumanReadable": "Synthetic sponsorship request.",
        "ReturnVariables": {
            "RequestChatID": 1001,
            "RequestChatURL": "/modules/community/index.php?Tags[]=synthetic-chat"
        }
    },
    "RequestPath": "/v1/medal/set_request_medal_sponsorship",
    "RequestUserAlias": "example-user",
    "Payload": true
}
Машиночитаемая документация метода
POST

/v1/medal/set_sponsor_user

#
Sponsor A Medal for will be recommended for the medal you define below.

Параметры

ИмяТипОбязательноПо умолчаниюОписание
userAlias string Да — Alias Identifying the User to be sponsored
medalCategorySlug string Да — Slug Identifying the Medal Category You Want to Sponsor
isWritingRequest bool Нет false all set_[...] functions have this parameter - if false (which is default) the method will execute without writing any data. Set this parameter to true once you are sure that you tested your logic and want to execute a writing request
Пример запроса (cURL)
curl --request POST \
  'https://ru.appointmenttrader.com/v1/medal/set_sponsor_user' \
  --data-urlencode 'key={{API_KEY}}' \
  --data-urlencode 'userAlias={{userAlias}}' \
  --data-urlencode 'medalCategorySlug={{medalCategorySlug}}' \
  --data-urlencode 'isWritingRequest={{isWritingRequest}}'

Возвращает

JSON
See the shared response schema and synthetic example.
Поля ответа
ПолеТипОбязательноОписание
$medal_set_sponsor_user_Response Да
$.oneOf[0] Да
$.oneOf[0].allOf[0]object Да
$.oneOf[0].allOf[0].RequestUserAliasstring Да
$.oneOf[0].allOf[0].RequestPathstring | null Да
$.oneOf[0].allOf[0].RequestStatus = "Succeeded" Да
$.oneOf[0].allOf[0].ResponseCodeinteger Да
$.oneOf[0].allOf[0].ResponseMessageAPIResponseMessage Да
$.oneOf[0].allOf[0].ResponseMessage.oneOf[0]string | number | boolean | null Да
$.oneOf[0].allOf[0].ResponseMessage.oneOf[1]array Да
$.oneOf[0].allOf[0].ResponseMessage.oneOf[1][]APIResponseMessage Нет
$.oneOf[0].allOf[0].ResponseMessage.oneOf[2]object Да
$.oneOf[0].allOf[0].ResponseMessage.oneOf[2].*APIResponseMessage Нет
$.oneOf[0].allOf[0].RequestImpersonatedByUserAliasstring Нет
$.oneOf[0].allOf[1]object Да
$.oneOf[0].allOf[1].Payload = true Да
$.oneOf[0].allOf[1].ResponseMessageobject Нет
$.oneOf[0].allOf[1].ResponseMessage.HumanReadablestring Да
$.oneOf[0].allOf[1].ResponseMessage.ReturnVariablesobject Да
$.oneOf[0].allOf[1].ResponseMessage.ReturnVariables.RequestChatIDDatabaseInteger ДаInteger value; legacy MySQL reads may serialize it as a numeric string.
$.oneOf[0].allOf[1].ResponseMessage.ReturnVariables.RequestChatID.oneOf[0]integer Да
$.oneOf[0].allOf[1].ResponseMessage.ReturnVariables.RequestChatID.oneOf[1]string Да
$.oneOf[0].allOf[1].ResponseMessage.ReturnVariables.RequestChatURLstring Да
$.oneOf[1]object Да
$.oneOf[1].RequestUserAliasstring Да
$.oneOf[1].RequestPathstring | null Да
$.oneOf[1].RequestStatus = "Failed" Да
$.oneOf[1].ResponseCodeinteger Да
$.oneOf[1].ResponseMessageAPIResponseMessage Да
$.oneOf[1].ResponseMessage.oneOf[0]string | number | boolean | null Да
$.oneOf[1].ResponseMessage.oneOf[1]array Да
$.oneOf[1].ResponseMessage.oneOf[1][]APIResponseMessage Нет
$.oneOf[1].ResponseMessage.oneOf[2]object Да
$.oneOf[1].ResponseMessage.oneOf[2].*APIResponseMessage Нет
$.oneOf[1].RequestImpersonatedByUserAliasstring Нет
Пример ответа
{
    "RequestStatus": "Succeeded",
    "ResponseCode": 100,
    "ResponseMessage": {
        "HumanReadable": "Synthetic sponsorship request.",
        "ReturnVariables": {
            "RequestChatID": 1001,
            "RequestChatURL": "/modules/community/index.php?Tags[]=synthetic-chat"
        }
    },
    "RequestPath": "/v1/medal/set_sponsor_user",
    "RequestUserAlias": "example-user",
    "Payload": true
}
Машиночитаемая документация метода