This document provides an overview and introduction to using the REST API for a social networking platform called Zyncro. It discusses REST API concepts like resources, endpoints, HTTP methods, authentication using OAuth, and includes code samples in languages like PHP, Java, and Python. Entities exposed through the API like users, groups, events, documents are also summarized. The document aims to help developers get started with building applications that integrate with Zyncro using its RESTful API.
Enterprise API adoption has gone beyond predictions. It has become the ‘coolest’ way of exposing business functionalities to the outside world. Both your public and private APIs, need to be protected, monitored and managed. This talk focuses on API Security. There are so many options out there to make someone easily confused. When to select one over the other is always a question – and you need to deal with it quite carefully to identify and isolate the tradeoffs.
Security is not an afterthought. It has to be an integral part of any development project – so as for APIs. API security has evolved a lot in last five years. The growth of standards, out there, has been exponential. The talk will elaborate how to build an ecosystem for API security around OAuth 2.0, OpenID Connect, UMA, SAML, SCIM and XACML.
Enterprise API adoption has gone beyond predictions. It has become the ‘coolest’ way of exposing business functionalities to the outside world. Both your public and private APIs, need to be protected, monitored and managed. This talk focuses on API Security. There are so many options out there to make someone easily confused. When to select one over the other is always a question – and you need to deal with it quite carefully to identify and isolate the tradeoffs.
Security is not an afterthought. It has to be an integral part of any development project – so as for APIs. API security has evolved a lot in last five years. The growth of standards, out there, has been exponential. The talk will elaborate how to build an ecosystem for API security around OAuth 2.0, OpenID Connect, UMA, SAML, SCIM and XACML.
Lessons learned on Corporate Social Networks [intra.NET Reloaded 2012]Zyncro
Zyncro participated intra.NET Reloaded, Berlin 2012 as it is in one of the leading international events on the new wave of private work environments for enterprises. Our presentation
Slot del Emprendedor Ana Fernández IDC Cloud 2013 Zyncro
Zyncro participa en el IDC Cloud 2013 en Madrid.
http://blog.zyncro.com/2013/04/18/zyncro-hablara-en-el-cloud-leadership-forum-de-idc-de-estrategias-para-empresas-dinamicas/
Presentation in Social Business Forum Milan 2012 about success stories of the use of Enterprise Social Networks in companies that evolve towards business 2.0, towards social business
Extend Your Use of JIRA by Solving Your Unique Concerns: An Exposé of the New...Atlassian
The existence of an API allows developers to extend software so as to cater for unique use cases beyond the software's original scope. Administrators and end users of JIRA 5 can expect its REST API to enable the creation of integrated applications to solve their unique concerns. This presentation aims to describe ways in which the JIRA 5 REST API can be used to make a tangible impact for the end user. Several use cases will be discussed, ranging from running simple command line apps, through to creating web applications that integrate with the JIRA 5 REST API.
Extend Your Use of JIRA by Solving Your Unique Concerns: An Exposé of the New...Atlassian
The existence of an API allows developers to extend software so as to cater for unique use cases beyond the software's original scope. Administrators and end users of JIRA 5 can expect its REST API to enable the creation of integrated applications to solve their unique concerns. This presentation aims to describe ways in which the JIRA 5 REST API can be used to make a tangible impact for the end user. Several use cases will be discussed, ranging from running simple command line apps, through to creating web applications that integrate with the JIRA 5 REST API.
Learn how to take advantage of Apigility to create APIs from scratch or to expose current functionality from an existent system. You'll learn the core API concepts, processes, functionality, logic, and in general how you can create good APIs, including documentation and all the considerations you must have.
The web has changed! Users spend more time on mobile than on desktops and expect to have an amazing user experience on both. APIs are the heart of the new web as the central point of access data, encapsulating logic and providing the same data and same features for desktops and mobiles. In this workshop, Antonio will show you how to create complex APIs in an easy and quick way using API Platform built on Symfony.
The web has changed! Users spend more time on mobile than on desktops and expect to have an amazing user experience on both. APIs are the heart of the new web as the central point of access data, encapsulating logic and providing the same data and same features for desktops and mobiles.
In this workshop, Paula and Antonio will show you how to create complex APIs in an easy and quick way using API Platform built on Symfony.
Repository: https://github.com/locastic/wscAPI2017
These slides focus on documentation for REST APIs. See http://idratherbewriting.com for more detail. For the video recording, see http://youtu.be/0yfNd7tzH2Q. This deep dive is the second slide deck I used in the presentation.
Building Content-Rich Java Apps in the Cloud with the Alfresco APIJeff Potts
This presentation, originally delivered at JavaOne on October 2, 2012, talks about why you should use Alfresco instead of rolling your own content repository and discusses the new public Alfresco API for writing content apps that persist content to Alfresco in the Cloud.
Why your next serverless project should use AWS AppSyncYan Cui
In this webinar, Yan Cui and Lumigo Software Engineer Guy Moses will discuss some of the power of GraphQL and AppSync and why AppSync + Lambda + DynamoDB should be your stack of choice in 2021 and beyond!
Lessons learned on Corporate Social Networks [intra.NET Reloaded 2012]Zyncro
Zyncro participated intra.NET Reloaded, Berlin 2012 as it is in one of the leading international events on the new wave of private work environments for enterprises. Our presentation
Slot del Emprendedor Ana Fernández IDC Cloud 2013 Zyncro
Zyncro participa en el IDC Cloud 2013 en Madrid.
http://blog.zyncro.com/2013/04/18/zyncro-hablara-en-el-cloud-leadership-forum-de-idc-de-estrategias-para-empresas-dinamicas/
Presentation in Social Business Forum Milan 2012 about success stories of the use of Enterprise Social Networks in companies that evolve towards business 2.0, towards social business
Extend Your Use of JIRA by Solving Your Unique Concerns: An Exposé of the New...Atlassian
The existence of an API allows developers to extend software so as to cater for unique use cases beyond the software's original scope. Administrators and end users of JIRA 5 can expect its REST API to enable the creation of integrated applications to solve their unique concerns. This presentation aims to describe ways in which the JIRA 5 REST API can be used to make a tangible impact for the end user. Several use cases will be discussed, ranging from running simple command line apps, through to creating web applications that integrate with the JIRA 5 REST API.
Extend Your Use of JIRA by Solving Your Unique Concerns: An Exposé of the New...Atlassian
The existence of an API allows developers to extend software so as to cater for unique use cases beyond the software's original scope. Administrators and end users of JIRA 5 can expect its REST API to enable the creation of integrated applications to solve their unique concerns. This presentation aims to describe ways in which the JIRA 5 REST API can be used to make a tangible impact for the end user. Several use cases will be discussed, ranging from running simple command line apps, through to creating web applications that integrate with the JIRA 5 REST API.
Learn how to take advantage of Apigility to create APIs from scratch or to expose current functionality from an existent system. You'll learn the core API concepts, processes, functionality, logic, and in general how you can create good APIs, including documentation and all the considerations you must have.
The web has changed! Users spend more time on mobile than on desktops and expect to have an amazing user experience on both. APIs are the heart of the new web as the central point of access data, encapsulating logic and providing the same data and same features for desktops and mobiles. In this workshop, Antonio will show you how to create complex APIs in an easy and quick way using API Platform built on Symfony.
The web has changed! Users spend more time on mobile than on desktops and expect to have an amazing user experience on both. APIs are the heart of the new web as the central point of access data, encapsulating logic and providing the same data and same features for desktops and mobiles.
In this workshop, Paula and Antonio will show you how to create complex APIs in an easy and quick way using API Platform built on Symfony.
Repository: https://github.com/locastic/wscAPI2017
These slides focus on documentation for REST APIs. See http://idratherbewriting.com for more detail. For the video recording, see http://youtu.be/0yfNd7tzH2Q. This deep dive is the second slide deck I used in the presentation.
Building Content-Rich Java Apps in the Cloud with the Alfresco APIJeff Potts
This presentation, originally delivered at JavaOne on October 2, 2012, talks about why you should use Alfresco instead of rolling your own content repository and discusses the new public Alfresco API for writing content apps that persist content to Alfresco in the Cloud.
Why your next serverless project should use AWS AppSyncYan Cui
In this webinar, Yan Cui and Lumigo Software Engineer Guy Moses will discuss some of the power of GraphQL and AppSync and why AppSync + Lambda + DynamoDB should be your stack of choice in 2021 and beyond!
Presented at GlobusWorld 2022 by Rachana Ananthakrishnan from Globus. Describes the Globus platform and how developers can access Globus service APIs in their applications.
With the growing interest in the API economy, IBM Integration Bus (IIB) has provided many recent enhancements in the area of REST APIs and JSON support. This session will discuss how to create an IIB REST API, either from scratch or starting from a Swagger (OpenAPI specification) document. We will also cover the new JSON Schema support for the Graphical Data Mapper, and the new REST Request node for calling REST APIs from IIB, which can be easily configured by drag-and-drop. Easy integration of IIB Rest APIs with an API Connect catalog is also possible, from both the IIB Toolkit and the IIB Web UI. We will talk through these new capabilities and how they relate to IBM's Application Integration Suite (AIS) solution.
Microservices and the Art of Taming the Dependency Hell MonsterC4Media
Video and slides synchronized, mp3 and slide download available at URL http://bit.ly/1OkQDCc.
Michael Bryzek presents lessons learned building an expansive microservice architecture at Gilt - an organization with 1500 git repositories and over 400 individual applications powering its apps and web sites. He emphasizes the importance of REST APIs and great client libraries to talk to them as a critical step to adoption. Filmed at qconnewyork.com.
Michael Bryzek is the CTO and co-founder of Gilt Groupe, an innovative online shopping destination offering its members special access to the most inspiring merchandise, culinary offerings, and experiences every day, many at insider prices. Gilt continually searches the world for the most coveted brands and products, including fashion, home decor, hotels and travel experiences on every continent.
Infographic: a very simple illustration of 3 different ways to use our platform and make the most of its features so that your business benefits. Read more: z.ync.ro/BU6Sg
Infografia: Zyncro como plataforma de Social BusinessZyncro
Una infografía para explicar de forma muy sencilla y visual 3 formas distintas de usar nuestra plataforma y aprovechar todas sus funcionalidades en beneficio de tu negocio.
Infografía: 6 cosas que no sabias que podias mejorar con Comunicación InternaZyncro
Muchos de los principales problemas de comunicación interna de las empresas se solucionarían con una buena herramienta de comunicación para los empleados. ¿Quieres saber cómo una Red Interna podría ayudar a tu empresa?
6 things you didnt know you can improve with Internal CommunicationZyncro
Many of the main internal company communication problems can be solved with a good communication tool for employees. Do you want to know how an internal network can help your company?
Infografik: 7 typen von internetnutzern, die sie auf einem sozialen unternehm...Zyncro
Wenn man auf sozialen Netzwerken unterwegs ist, stößt man auf viele verschiedene Arten von Benutzern: Sie reichen von Menschen, die auf der Straße auch im Gehen den Blick nicht vom Bildschirm ihres Smartphones abwenden, bis hin zu Leuten, die noch immer SMS versenden, um sich mit anderen zu verabreden.
Dev Dives: Train smarter, not harder – active learning and UiPath LLMs for do...UiPathCommunity
💥 Speed, accuracy, and scaling – discover the superpowers of GenAI in action with UiPath Document Understanding and Communications Mining™:
See how to accelerate model training and optimize model performance with active learning
Learn about the latest enhancements to out-of-the-box document processing – with little to no training required
Get an exclusive demo of the new family of UiPath LLMs – GenAI models specialized for processing different types of documents and messages
This is a hands-on session specifically designed for automation developers and AI enthusiasts seeking to enhance their knowledge in leveraging the latest intelligent document processing capabilities offered by UiPath.
Speakers:
👨🏫 Andras Palfi, Senior Product Manager, UiPath
👩🏫 Lenka Dulovicova, Product Program Manager, UiPath
A tale of scale & speed: How the US Navy is enabling software delivery from l...sonjaschweigert1
Rapid and secure feature delivery is a goal across every application team and every branch of the DoD. The Navy’s DevSecOps platform, Party Barge, has achieved:
- Reduction in onboarding time from 5 weeks to 1 day
- Improved developer experience and productivity through actionable findings and reduction of false positives
- Maintenance of superior security standards and inherent policy enforcement with Authorization to Operate (ATO)
Development teams can ship efficiently and ensure applications are cyber ready for Navy Authorizing Officials (AOs). In this webinar, Sigma Defense and Anchore will give attendees a look behind the scenes and demo secure pipeline automation and security artifacts that speed up application ATO and time to production.
We will cover:
- How to remove silos in DevSecOps
- How to build efficient development pipeline roles and component templates
- How to deliver security artifacts that matter for ATO’s (SBOMs, vulnerability reports, and policy evidence)
- How to streamline operations with automated policy checks on container images
Securing your Kubernetes cluster_ a step-by-step guide to success !KatiaHIMEUR1
Today, after several years of existence, an extremely active community and an ultra-dynamic ecosystem, Kubernetes has established itself as the de facto standard in container orchestration. Thanks to a wide range of managed services, it has never been so easy to set up a ready-to-use Kubernetes cluster.
However, this ease of use means that the subject of security in Kubernetes is often left for later, or even neglected. This exposes companies to significant risks.
In this talk, I'll show you step-by-step how to secure your Kubernetes cluster for greater peace of mind and reliability.
Smart TV Buyer Insights Survey 2024 by 91mobiles.pdf91mobiles
91mobiles recently conducted a Smart TV Buyer Insights Survey in which we asked over 3,000 respondents about the TV they own, aspects they look at on a new TV, and their TV buying preferences.
UiPath Test Automation using UiPath Test Suite series, part 3DianaGray10
Welcome to UiPath Test Automation using UiPath Test Suite series part 3. In this session, we will cover desktop automation along with UI automation.
Topics covered:
UI automation Introduction,
UI automation Sample
Desktop automation flow
Pradeep Chinnala, Senior Consultant Automation Developer @WonderBotz and UiPath MVP
Deepak Rai, Automation Practice Lead, Boundaryless Group and UiPath MVP
Le nuove frontiere dell'AI nell'RPA con UiPath Autopilot™UiPathCommunity
In questo evento online gratuito, organizzato dalla Community Italiana di UiPath, potrai esplorare le nuove funzionalità di Autopilot, il tool che integra l'Intelligenza Artificiale nei processi di sviluppo e utilizzo delle Automazioni.
📕 Vedremo insieme alcuni esempi dell'utilizzo di Autopilot in diversi tool della Suite UiPath:
Autopilot per Studio Web
Autopilot per Studio
Autopilot per Apps
Clipboard AI
GenAI applicata alla Document Understanding
👨🏫👨💻 Speakers:
Stefano Negro, UiPath MVPx3, RPA Tech Lead @ BSP Consultant
Flavio Martinelli, UiPath MVP 2023, Technical Account Manager @UiPath
Andrei Tasca, RPA Solutions Team Lead @NTT Data
UiPath Test Automation using UiPath Test Suite series, part 4DianaGray10
Welcome to UiPath Test Automation using UiPath Test Suite series part 4. In this session, we will cover Test Manager overview along with SAP heatmap.
The UiPath Test Manager overview with SAP heatmap webinar offers a concise yet comprehensive exploration of the role of a Test Manager within SAP environments, coupled with the utilization of heatmaps for effective testing strategies.
Participants will gain insights into the responsibilities, challenges, and best practices associated with test management in SAP projects. Additionally, the webinar delves into the significance of heatmaps as a visual aid for identifying testing priorities, areas of risk, and resource allocation within SAP landscapes. Through this session, attendees can expect to enhance their understanding of test management principles while learning practical approaches to optimize testing processes in SAP environments using heatmap visualization techniques
What will you get from this session?
1. Insights into SAP testing best practices
2. Heatmap utilization for testing
3. Optimization of testing processes
4. Demo
Topics covered:
Execution from the test manager
Orchestrator execution result
Defect reporting
SAP heatmap example with demo
Speaker:
Deepak Rai, Automation Practice Lead, Boundaryless Group and UiPath MVP
Observability Concepts EVERY Developer Should Know -- DeveloperWeek Europe.pdfPaige Cruz
Monitoring and observability aren’t traditionally found in software curriculums and many of us cobble this knowledge together from whatever vendor or ecosystem we were first introduced to and whatever is a part of your current company’s observability stack.
While the dev and ops silo continues to crumble….many organizations still relegate monitoring & observability as the purview of ops, infra and SRE teams. This is a mistake - achieving a highly observable system requires collaboration up and down the stack.
I, a former op, would like to extend an invitation to all application developers to join the observability party will share these foundational concepts to build on:
State of ICS and IoT Cyber Threat Landscape Report 2024 previewPrayukth K V
The IoT and OT threat landscape report has been prepared by the Threat Research Team at Sectrio using data from Sectrio, cyber threat intelligence farming facilities spread across over 85 cities around the world. In addition, Sectrio also runs AI-based advanced threat and payload engagement facilities that serve as sinks to attract and engage sophisticated threat actors, and newer malware including new variants and latent threats that are at an earlier stage of development.
The latest edition of the OT/ICS and IoT security Threat Landscape Report 2024 also covers:
State of global ICS asset and network exposure
Sectoral targets and attacks as well as the cost of ransom
Global APT activity, AI usage, actor and tactic profiles, and implications
Rise in volumes of AI-powered cyberattacks
Major cyber events in 2024
Malware and malicious payload trends
Cyberattack types and targets
Vulnerability exploit attempts on CVEs
Attacks on counties – USA
Expansion of bot farms – how, where, and why
In-depth analysis of the cyber threat landscape across North America, South America, Europe, APAC, and the Middle East
Why are attacks on smart factories rising?
Cyber risk predictions
Axis of attacks – Europe
Systemic attacks in the Middle East
Download the full report from here:
https://sectrio.com/resources/ot-threat-landscape-reports/sectrio-releases-ot-ics-and-iot-security-threat-landscape-report-2024/
Epistemic Interaction - tuning interfaces to provide information for AI supportAlan Dix
Paper presented at SYNERGY workshop at AVI 2024, Genoa, Italy. 3rd June 2024
https://alandix.com/academic/papers/synergy2024-epistemic/
As machine learning integrates deeper into human-computer interactions, the concept of epistemic interaction emerges, aiming to refine these interactions to enhance system adaptability. This approach encourages minor, intentional adjustments in user behaviour to enrich the data available for system learning. This paper introduces epistemic interaction within the context of human-system communication, illustrating how deliberate interaction design can improve system understanding and adaptation. Through concrete examples, we demonstrate the potential of epistemic interaction to significantly advance human-computer interaction by leveraging intuitive human communication strategies to inform system design and functionality, offering a novel pathway for enriching user-system engagements.
LF Energy Webinar: Electrical Grid Modelling and Simulation Through PowSyBl -...DanBrown980551
Do you want to learn how to model and simulate an electrical network from scratch in under an hour?
Then welcome to this PowSyBl workshop, hosted by Rte, the French Transmission System Operator (TSO)!
During the webinar, you will discover the PowSyBl ecosystem as well as handle and study an electrical network through an interactive Python notebook.
PowSyBl is an open source project hosted by LF Energy, which offers a comprehensive set of features for electrical grid modelling and simulation. Among other advanced features, PowSyBl provides:
- A fully editable and extendable library for grid component modelling;
- Visualization tools to display your network;
- Grid simulation tools, such as power flows, security analyses (with or without remedial actions) and sensitivity analyses;
The framework is mostly written in Java, with a Python binding so that Python developers can access PowSyBl functionalities as well.
What you will learn during the webinar:
- For beginners: discover PowSyBl's functionalities through a quick general presentation and the notebook, without needing any expert coding skills;
- For advanced developers: master the skills to efficiently apply PowSyBl functionalities to your real-world scenarios.
LF Energy Webinar: Electrical Grid Modelling and Simulation Through PowSyBl -...
Zyncro rest api feb 2013
1. Social Networks
Your Enterprise Social Network For Enterprises
Developing using the REST API
1
2. Agenda
REST API overview
REST API services
OAuth authorization
Let’s play with the API
REST API entities
PHP API client
2
3. REST API overview
The REST API gives you access to the most of the features you
see in our web app and lets you extend them for use in your
own app. It strives to be RESTful and is organized around the
main resources you’re familiar with from the Zyncro web
interface.
Use our REST API to create applications and web sites that
natively integrate with Zyncro
The REST API is a collection of web services, which means that
you can create Zyncro applications using any modern
programming language and operating system on any computer
connected to the Internet.
OAuth 1.0a protocol is used to provide authorized access to our
REST API services.
HTTP REST services use JSON format in their responses.
3
4. REST API overview
You access a resource by sending an HTTPS request to the Zyncro
API server. The server replies with a response that either contains
the data you requested, or a status indicator, or both.
The format of the URL to access the API is, for example,
https://my.sandbox.zyncro.com/api/v1/rest
HTTP methods separate API actions
GET is used to retrieve a representation (or, "stuff") from a
resource or a collection of resources.
POST is used to create or modify a representation of a
resource (we do not use PUT).
DELETE is used to remove the information about a resource.
4
5. REST API overview
HTTP status code in responses:
200 The request was successfully received, understood, and
accepted.
4xx An error in the request. Usually a bad parameter.
5xx The request is fine, but something is wrong on Zyncro’s end.
Our REST API is split up into different areas, which contain a subset of
services grouped by functionality.
5
6. REST API - Use
We are using the REST API, for example, in these integrations and native apps
6
7. Play with REST API
Show me the money!
http://apidocs.sandbox.zyncro.com/
7
8. REST API services
• Manage the organization configuration
Organization services • Manage organization's users (add/edit/remove)
/api/v1/rest/organization • Edit organization properties
• Only admin users can have access to these services
• Manage user profiles
Users services • Access follower/following user lists
/api/v1/rest/users • Edit user profile, change user’s profile image
• Follow/Unfollow users
Microblogging and Activity • Access and publish in all microblogging, including
Stream & Inbox services Personal feed, Corporate feed, Department feeds,
Private messages and Messages from Groups
/api/v1/rest/wall • Access user's inbox events and notifications
• Create new groups
Groups services • Download, edit, and upload documents to groups
/api/v1/rest/groups • Manage group members, folders and files
• Join/leave open groups
8
9. REST API services
• Create new departments
Departments services • Download, edit, upload documents in departments
/api/v1/rest/departments • Manage department members, folders and files
• Follow/unfollow departments
• Manage invitations.
Invitations services
• Send, accept, decline invitations
/api/v1/rest/invitations
• Access the list of pending invitations
• Create new tasks.
Tasks services
• Edit task and access to the tasks of groups
/api/v1/rest/tasks
• Access to the list of tasks
ZyncroApps Services • Manage apps (add/edit/remove)
/api/v1/rest/apps • Enable/disable apps
9
10. OAuth authorization - REST API
1) Get a Request Token
2) A User have to authorize the
Request Token
3) Exchange the authorized
Request Token for an Access
Token
4) Use the Access Token to
invoke REST API services
10
11. OAuth types in REST API
We have three ways of getting an Access Token to invoke REST API services
Web browser authorization
Get a Request token
Authenticate the user using a Zyncro login web page
Get an Access token
External service authorization
Get a Request token
Authenticate the user using an external service
Get an Access token
ZyncroApp authorization
Use combined with ZyncroApps when the user is already logged in
Zyncro. We’ll see it while seeing ZyncroApps development.
Examples soon to come!
11
12. Java sample - REST API
Sample showing how to get the profile of a User using the REST API
public final static String API_KEY = ...
public static final String API_SECRET = ...
public final static String ACCESS_KEY = ...
public final static String ACCESS_SECRET = ...
OAuthService service = new ServiceBuilder()
.provider(ZyncroApi.class)
.apiKey(Paths.API_KEY)
.apiSecret(Paths.API_SECRET)
.build();
OAuthRequest request = new OAuthRequest(
Verb.GET,
"https://my.sandbox.zyncro.com/api/v1/rest/users/profile");
Token accessToken = new Token(Paths.ACCESS_KEY, Paths.ACCESS_SECRET);
service.signRequest(accessToken, request);
Response response = request.send();
...
12
16. REST API entities
Organization Invitation Task
Document
Document App
Version
16
17. REST API entities
• All the main entities in API have a unique identifier, normally call
URN (unique resource identifier)
• For the attributes that represent date and time, we use UNIX epoch
representation in milliseconds
17
18. REST API entities
An Event represents an activity that has occurred in Zyncro, for example: a user
has published a new message, a document has been changed, a new group has
been created…
Some of the important attributes related with an Event are:
• Each event has a unique identifier.
• A date is associated with an event, indicating when it was created.
• An event is associated with a group or department, or a private message.
• An event has an author (a user) who has triggered (generated) that event.
• Each event has an type. The most common type is Comment, that is a
message that an user has published. Other types are related with events
such as a new member added, some documents uploaded or deleted, etc.
18
19. REST API entities
• The number of child comments that the event has.
• Information related with the likes the event has received: number of likes
and the last user who did it.
• The source of the event gives you information related with the origin of the
event. This information is useful for developing integrations; for example
we use it to indicate that the event was generated from a device like an
Android, iPhone…; or another application Chatter, Yammer…
• The text related with the event, use the attribute comment (plain text) and
htmlComment (contains html format text).
• An extra attribute called payload can be used to store information related
with the Event in JSON format.
19
20. REST API entities
A Group is the more general structure in Zyncro, it is a workspace where
users share information and communicate.
Some of the most important attributes related with a Group are:
• Each group has a unique identifier.
• The name and description of the group.
• The owner of the group.
• The number of members the group has.
• Whether the group is public or private
• An extra attribute called payload can be used to store information
related with the Group in JSON format.
20
21. REST API entities
A Department is similar to a group, but it is only visible to all the
organization users. All comments that are published in a department are
published in name of the department.
Some of the most important attributes related with a Department are:
• Each department has a unique identifier.
• The name, description, aboutus (and other properties) of the
department.
• The owner of the department.
• An extra attribute called payload can be used to store information
related with the Group in JSON format.
21
22. REST API entities
A User represents a person registered and using Zyncro. Every user
belongs to an organization.
Some of the most important attributes related with a User are:
• Each user has a unique identifier.
• The name, lastname, email (and other properties) of the user.
• The current language the user has active.
• The identifiers of his Company feed, Personal feed and Personal
group.
• The identifier of his Organization
22
23. REST API entities
• Some of the permissions in the organization: enable publish in
Company feed, enable to create Groups or Departments
If retrieving the full profile of user, extra information is included such as
• Skills, experience and education information
• Contact details: address, telephone numbers, mobile
• An extra attribute called payload can be used to store information
related with the Group in JSON format.
23
24. REST API entities
A Member is a user that belongs to a Group or Department with its
associated permissions.
Some of the most important attributes related with a Member are:
• The information included in the User
• The permission of the User in the Group/Department:
• If can publish new messages
• If can comment existing messaged
• If is owner of the Group/Department
• If can add/edit/delete documents
• If can invite other users to join
• If can add/edit/delete tasks
• If can create Zlinks (public links)
24
25. REST API entities
Organization, every user in Zyncro belongs to one (and only one)
organization, that defines the behavior they have in it.
Some of the most important attributes related with an Organization are:
• Each organization has a unique identifier.
• The name, total users and total storage of the organization
• Basic GUI attributes: header color, header text color, image
• Configuration attributes such as, if tasks are enable, if message can be
deleted, if users can comment on company feed…
25
26. REST API entities
A Document belongs to a Group or Department.
Some of the most important attributes related with a Document are:
• Each document has a unique identifier.
• The name and description of the document
• Each event has an type, we have four types of documents:
• File
• Folder
• External link (to an URL)
• Internal link (to another file in other Group/Department)
26
27. REST API entities
• The date and time of creation and last modification
• The last document version associated with this document
• The number of versions this document has
• The member who created the document
• The member who last modified the document
27
28. REST API entities
A DocumentVersion represents a version of a document.
Some of the most important attributes related with a DocumentVersion
are:
• Each document version has a unique identifier.
• The version number, size and date time of creation
• The identifier of the group and the document
• The information regarding the member author of this version
28
29. REST API entities
A InboxEvent is a notification that a user received, generated by an
event.
Some of the most important attributes related with an Inbox Event are:
• Each inbox event has a unique identifier.
• The date and time the inbox event was generated
• The event associated with the inbox event
• Each inbox event has an type, these types are:
• Comment
• Like
• Follow
29
30. REST API entities
Invitation
Some of the most important attributes related with an Invitation are:
• Each invitation has a unique identifier.
• The date time when the invitation was sent
• Information about the user who sent and the user whose received the
invitation
• The state of the invitation (waiting, cancelled, accepted, rejected)
• Each invitation has an type, these types are:
• External contact
• Group
• Follow
30
31. REST API entities
Task
Some of the most important attributes related with a Task are:
• Each task has a unique identifier.
• The name and description of the task
• The group identifier where the tasks belongs
• The status of the task (pending or completed)
• The due date of the task
• The user assigned to this task
31
32. Code samples – REST API
Some samples using the REST API in several programming languages
can be found at github.com/zyncro
C# (github.com/zyncro/csharp-api-sample)
Java (github.com/zyncro/java-api-sample)
PHP (github.com/zyncro/php-api-sample)
Python (github.com/zyncro/python-api-sample)
More to come…
32
33. PHP API client
We provide a series of PHP classes that you can use to invoke REST
API services from PHP.
OAuth authorization is transparent and you do not have to worry
about it, just choose which type to use.
https://github.com/zyncro/php-api-client
33
35. PHP API client - Samples
• Creating a new Group with the API
$dsf->start(new GroupApiService($dsf));
$response = $dsf->controller->createGroup
('A new Group from PHP API', 'The description');
35
36. PHP API client - Samples
• Publishing a new Message in a Group with the API
$dsf->start(new WallApiService($dsf));
$response = $dsf->controller->publishInGroup(
'syncrum:sharegroup:01e39c19-313e-404c-9d08-64a047eda89c',
'Hello plain World!',
'<p>Hello <span style="font-weight:bold;
color:#ff0000;">enriched</span> World</p>');
• Get Events from a Group with the API
$dsf->start(new WallApiService($dsf));
$response = $dsf->controller->getGroupEvents(
'syncrum:sharegroup:01e39c19-313e-404c-9d08-64a047eda89c');
36
37. More info
Zyncro Developers Portal
http://developers.zyncro.com
37