com.tenduke.events.api.model.data.ClientFields Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of events-api Show documentation

Objects and interfaces describing data communicated in the 10Duke Event Data system API

There is a newer version: 1.9.0

package com.tenduke.events.api.model.data;

import com.fasterxml.jackson.annotation.JsonInclude;

/**
 * Event data fields related to client application (in practice OAuth client or SAML SP)
 * connected to the event sender system (which itself is a client to 10Duke Event Data).
 * @author jarkko
 */
@JsonInclude(JsonInclude.Include.NON_NULL)
public interface ClientFields {

    /**
     * 
     * Gets identifier of a client application related to the event.
     * 
     * 
     * It is recommended that a permanent id used by the event sender system is used
     * as the value of this field, and not e.g. OAuth {@code client_id}.
     * 
     * @return Identifier of the client application in the event sender system.
     */
    String getClientApplicationId();

    /**
     * Gets type of the client application. This field may be used in addition to
     * {@code clientApplicationId} if necessary.
     * @return Type of the client application, as described in the event sender system.
     */
    String getClientApplicationType();
}